> For the complete documentation index, see [llms.txt](https://docs.incogniton.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.incogniton.com/documentation/pt-br-documentation/api-de-automacao-e-sdks/javascript-and-python-sdk.md).

# SDK de JavaScript e Python

Automatize seus perfis do Incogniton a partir de JavaScript/TypeScript ou Python com o pacote oficial incogniton no npm e PyPI.

O Incogniton possui SDKs oficiais para JavaScript/TypeScript (`npm install incogniton`) e Python (`pip install incogniton`). Ambos se comunicam com a [API REST local](https://docs.incogniton.com/documentation/pt-br-documentation/api-de-automacao-e-sdks/local-rest-api.md) do aplicativo Incogniton no seu computador.

Com os SDKs, você gerencia perfis e cookies a partir do código e lança um perfil diretamente em uma biblioteca de automação de navegador: Puppeteer ou Playwright com o SDK JavaScript, Playwright ou Selenium com o SDK Python.

### Antes de começar

* O aplicativo Incogniton deve estar aberto e logado no mesmo computador que o seu script.
* A API REST local deve estar ativada: **Configurações** → **Automação** → **Habilitar API de automação**. Esta é uma funcionalidade paga. Veja [Use a API REST local](https://docs.incogniton.com/documentation/pt-br-documentation/api-de-automacao-e-sdks/local-rest-api.md).
* Ambos os SDKs usam a porta `35000` por padrão. Se você alterou a **porta da API** na aba de Automação, passe sua porta para o cliente.
* Você precisa do ID do perfil que deseja automatizar. Expanda o perfil na lista de perfis e clique em **Copiar** ao lado de **ID do Perfil**.

Seu script controla o navegador que o Incogniton lança para o perfil, então a impressão digital, proxy e cookies do perfil são usados. Nenhum navegador separado é baixado.

### Instalação e exemplos

Os passos de instalação, a referência completa dos métodos e exemplos de código estão na documentação do desenvolvedor:

* [Visão geral do SDK](https://api-docs.incogniton.com/sdks/overview)
* [SDK Node.js](https://api-docs.incogniton.com/sdks/nodejs) (JavaScript/TypeScript, Puppeteer e Playwright)
* [SDK Python](https://api-docs.incogniton.com/sdks/python) (Playwright e Selenium)
* [Exemplos de automação](https://api-docs.incogniton.com/how-to-guides/automation-examples): scripts prontos para execução com Puppeteer, Playwright e Selenium

{% hint style="info" %}
Lance cada perfil apenas uma vez por vez. Se um perfil já estiver em execução, o aplicativo recusará um segundo lançamento e o SDK retornará um erro com a mensagem do aplicativo.
{% endhint %}

### Mais opções de automação

* [Use a API REST local](https://docs.incogniton.com/documentation/pt-br-documentation/api-de-automacao-e-sdks/local-rest-api.md): chame os endpoints diretamente.
* Incogniton CLI: execute as mesmas ações a partir de um terminal. Clique em **Download CLI** na aba **Automação**. Veja a [documentação do CLI](https://api-docs.incogniton.com/cli).
* [Conecte clientes de IA com MCP](https://docs.incogniton.com/documentation/pt-br-documentation/api-de-automacao-e-sdks/connect-ai-clients-mcp.md): permita que um cliente de IA gerencie seus perfis.
