> 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/russian-documentation/api-avtomatizacii-i-sdk/javascript-and-python-sdk.md).

# JavaScript и Python SDK

Автоматизируйте свои профили Incogniton с помощью JavaScript/TypeScript или Python с официальным пакетом incogniton на npm и PyPI.

Incogniton имеет официальные SDK для JavaScript/TypeScript (`npm install incogniton`) и Python (`pip install incogniton`). Оба взаимодействуют с [локальным REST API](https://docs.incogniton.com/documentation/russian-documentation/api-avtomatizacii-i-sdk/local-rest-api.md) приложения Incogniton на вашем компьютере.

С помощью SDK вы управляете профилями и куками из кода и запускаете профиль прямо в библиотеку автоматизации браузера: Puppeteer или Playwright с JavaScript SDK, Playwright или Selenium с Python SDK.

### Перед началом

* Приложение Incogniton должно быть открыто и выполнен вход на том же компьютере, что и ваш скрипт.
* Локальный REST API должен быть включен: **Настройки** → **Автоматизация** → **Включить API автоматизации**. Это платная функция. См. [Использование локального REST API](https://docs.incogniton.com/documentation/russian-documentation/api-avtomatizacii-i-sdk/local-rest-api.md).
* Оба SDK используют порт `35000` по умолчанию. Если вы изменили **порт API** на вкладке автоматизации, передайте ваш порт клиенту.
* Вам нужен ID профиля, который вы хотите автоматизировать. Разверните профиль в списке профилей и нажмите **Копировать** рядом с **ID профиля**.

Ваш скрипт управляет браузером, который Incogniton запускает для профиля, поэтому используются отпечаток, прокси и куки профиля. Отдельный браузер не загружается.

### Установка и примеры

Шаги установки, полный справочник методов и примеры кода находятся в документации для разработчиков:

* [Обзор SDK](https://api-docs.incogniton.com/sdks/overview)
* [Node.js SDK](https://api-docs.incogniton.com/sdks/nodejs) (JavaScript/TypeScript, Puppeteer и Playwright)
* [Python SDK](https://api-docs.incogniton.com/sdks/python) (Playwright и Selenium)
* [Примеры автоматизации](https://api-docs.incogniton.com/how-to-guides/automation-examples): готовые к запуску скрипты Puppeteer, Playwright и Selenium

{% hint style="info" %}
Запускайте каждый профиль только один раз за раз. Если профиль уже запущен, приложение откажет в повторном запуске, и SDK вернет ошибку с сообщением приложения.
{% endhint %}

### Дополнительные варианты автоматизации

* [Использование локального REST API](https://docs.incogniton.com/documentation/russian-documentation/api-avtomatizacii-i-sdk/local-rest-api.md): вызовите конечные точки напрямую.
* Incogniton CLI: выполняйте те же действия из терминала. Нажмите **Скачать CLI** на вкладке **Автоматизация**. См. [документацию CLI](https://api-docs.incogniton.com/cli).
* [Подключение AI клиентов с MCP](https://docs.incogniton.com/documentation/russian-documentation/api-avtomatizacii-i-sdk/connect-ai-clients-mcp.md): позвольте AI клиенту управлять вашими профилями.
