JavaScript and Python SDK
Automate your Incogniton profiles from JavaScript/TypeScript or Python with the official incogniton package on npm and PyPI.
Incogniton has official SDKs for JavaScript/TypeScript (npm install incogniton) and Python (pip install incogniton). Both talk to the local REST API of the Incogniton app on your computer.
With the SDKs you manage profiles and cookies from code, and launch a profile straight into a browser automation library: Puppeteer or Playwright with the JavaScript SDK, Playwright or Selenium with the Python SDK.
Before you start
The Incogniton app must be open and logged in on the same computer as your script.
The local REST API must be on: Settings → Automation → Enable automation API. This is a paid feature. See Use the local REST API.
Both SDKs use port
35000by default. If you changed the API port on the Automation tab, pass your port to the client.You need the ID of the profile you want to automate. Expand the profile in the profile list and click Copy next to Profile ID.
Your script drives the browser that Incogniton launches for the profile, so the profile's fingerprint, proxy and cookies are used. No separate browser is downloaded.
Install and examples
The install steps, the full method reference and code examples are in the developer documentation:
Node.js SDK (JavaScript/TypeScript, Puppeteer and Playwright)
Python SDK (Playwright and Selenium)
Automation examples: ready-to-run Puppeteer, Playwright and Selenium scripts
More automation options
Use the local REST API: call the endpoints directly.
Incogniton CLI: run the same actions from a terminal. Click Download CLI on the Automation tab. See the CLI documentation.
Connect AI clients with MCP: let an AI client manage your profiles.
Last updated
Was this helpful?