> 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/spanish/api-de-automatizacion-y-sdks/javascript-and-python-sdk.md).

# SDK de JavaScript y Python

Automatiza tus perfiles de Incogniton desde JavaScript/TypeScript o Python con el paquete oficial de incogniton en npm y PyPI.

Incogniton tiene SDKs oficiales para JavaScript/TypeScript (`npm install incogniton`) y Python (`pip install incogniton`). Ambos se comunican con la [API REST local](https://docs.incogniton.com/documentation/spanish/api-de-automatizacion-y-sdks/local-rest-api.md) de la aplicación Incogniton en tu computadora.

Con los SDKs puedes gestionar perfiles y cookies desde el código, y lanzar un perfil directamente en una biblioteca de automatización de navegadores: Puppeteer o Playwright con el SDK de JavaScript, Playwright o Selenium con el SDK de Python.

### Antes de comenzar

* La aplicación Incogniton debe estar abierta y con sesión iniciada en la misma computadora que tu script.
* La API REST local debe estar activada: **Settings** → **Automation** → **Enable automation API**. Esta es una función de pago. Consulta [Usar la API REST local](https://docs.incogniton.com/documentation/spanish/api-de-automatizacion-y-sdks/local-rest-api.md).
* Ambos SDKs usan el puerto `35000` por defecto. Si cambiaste el **API port** en la pestaña de Automatización, pasa tu puerto al cliente.
* Necesitas el ID del perfil que deseas automatizar. Expande el perfil en la lista de perfiles y haz clic en **Copy** junto a **Profile ID**.

Tu script controla el navegador que Incogniton lanza para el perfil, por lo que se utilizan la huella digital, el proxy y las cookies del perfil. No se descarga un navegador por separado.

### Instalación y ejemplos

Los pasos de instalación, la referencia completa de métodos y ejemplos de código están en la documentación para desarrolladores:

* [Descripción general del SDK](https://api-docs.incogniton.com/sdks/overview)
* [SDK de Node.js](https://api-docs.incogniton.com/sdks/nodejs) (JavaScript/TypeScript, Puppeteer y Playwright)
* [SDK de Python](https://api-docs.incogniton.com/sdks/python) (Playwright y Selenium)
* [Ejemplos de automatización](https://api-docs.incogniton.com/how-to-guides/automation-examples): scripts listos para ejecutar de Puppeteer, Playwright y Selenium

{% hint style="info" %}
Lanza cada perfil solo una vez a la vez. Si un perfil ya está en ejecución, la aplicación rechaza un segundo lanzamiento y el SDK devuelve un error con el mensaje de la aplicación.
{% endhint %}

### Más opciones de automatización

* [Usar la API REST local](https://docs.incogniton.com/documentation/spanish/api-de-automatizacion-y-sdks/local-rest-api.md): llama a los endpoints directamente.
* Incogniton CLI: ejecuta las mismas acciones desde una terminal. Haz clic en **Download CLI** en la pestaña **Automation**. Consulta la [documentación de CLI](https://api-docs.incogniton.com/cli).
* [Conectar clientes de IA con MCP](https://docs.incogniton.com/documentation/spanish/api-de-automatizacion-y-sdks/connect-ai-clients-mcp.md): permite que un cliente de IA gestione tus perfiles.
