> 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/italian-documentation/api-di-automazione-e-sdk/javascript-and-python-sdk.md).

# SDK JavaScript e Python

Automatizza i tuoi profili Incogniton da JavaScript/TypeScript o Python con il pacchetto ufficiale incogniton su npm e PyPI.

Incogniton ha SDK ufficiali per JavaScript/TypeScript (`npm install incogniton`) e Python (`pip install incogniton`). Entrambi comunicano con la [API REST locale](https://docs.incogniton.com/documentation/italian-documentation/api-di-automazione-e-sdk/local-rest-api.md) dell'app Incogniton sul tuo computer.

Con gli SDK puoi gestire profili e cookie dal codice e avviare un profilo direttamente in una libreria di automazione del browser: Puppeteer o Playwright con l'SDK JavaScript, Playwright o Selenium con l'SDK Python.

### Prima di iniziare

* L'app Incogniton deve essere aperta e connessa sullo stesso computer del tuo script.
* L'API REST locale deve essere attiva: **Impostazioni** → **Automazione** → **Abilita API di automazione**. Questa è una funzione a pagamento. Vedi [Usa l'API REST locale](https://docs.incogniton.com/documentation/italian-documentation/api-di-automazione-e-sdk/local-rest-api.md).
* Entrambi gli SDK utilizzano la porta `35000` per impostazione predefinita. Se hai cambiato la **porta API** nella scheda Automazione, passa la tua porta al client.
* Hai bisogno dell'ID del profilo che vuoi automatizzare. Espandi il profilo nell'elenco dei profili e clicca su **Copia** accanto a **ID profilo**.

Il tuo script controlla il browser che Incogniton avvia per il profilo, quindi vengono utilizzati l'impronta digitale, il proxy e i cookie del profilo. Non viene scaricato un browser separato.

### Installazione ed esempi

I passaggi per l'installazione, il riferimento completo ai metodi e gli esempi di codice sono nella documentazione per sviluppatori:

* [Panoramica 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)
* [Esempi di automazione](https://api-docs.incogniton.com/how-to-guides/automation-examples): script Puppeteer, Playwright e Selenium pronti per l'uso

{% hint style="info" %}
Avvia ogni profilo solo una volta alla volta. Se un profilo è già in esecuzione, l'app rifiuta un secondo avvio e l'SDK restituisce un errore con il messaggio dell'app.
{% endhint %}

### Altre opzioni di automazione

* [Usa l'API REST locale](https://docs.incogniton.com/documentation/italian-documentation/api-di-automazione-e-sdk/local-rest-api.md): chiama direttamente gli endpoint.
* Incogniton CLI: esegui le stesse azioni da un terminale. Clicca su **Scarica CLI** nella scheda **Automazione**. Vedi la [documentazione CLI](https://api-docs.incogniton.com/cli).
* [Connetti client AI con MCP](https://docs.incogniton.com/documentation/italian-documentation/api-di-automazione-e-sdk/connect-ai-clients-mcp.md): lascia che un client AI gestisca i tuoi profili.
