> 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/chinese-documentation/zi-dong-hua-api-he-sdk/javascript-and-python-sdk.md).

# JavaScript 和 Python SDK

通过 npm 和 PyPI 上的官方 incogniton 包，从 JavaScript/TypeScript 或 Python 自动化您的 Incogniton 配置文件。

Incogniton 提供了 JavaScript/TypeScript (`npm install incogniton`) 和 Python (`pip install incogniton`) 的官方 SDK。两者都与您计算机上的 Incogniton 应用的[本地 REST API](https://docs.incogniton.com/documentation/chinese-documentation/zi-dong-hua-api-he-sdk/local-rest-api.md)进行通信。

通过这些 SDK，您可以从代码中管理配置文件和 cookies，并将配置文件直接启动到浏览器自动化库中：使用 JavaScript SDK 的 Puppeteer 或 Playwright，使用 Python SDK 的 Playwright 或 Selenium。

### 开始之前

* Incogniton 应用必须在与您的脚本相同的计算机上打开并登录。
* 必须开启本地 REST API：**设置** → **自动化** → **启用自动化 API**。这是一个付费功能。参见[使用本地 REST API](https://docs.incogniton.com/documentation/chinese-documentation/zi-dong-hua-api-he-sdk/local-rest-api.md)。
* 两个 SDK 默认使用端口 `35000`。如果您在自动化选项卡上更改了 **API 端口**，请将您的端口传递给客户端。
* 您需要获取要自动化的配置文件的 ID。在配置文件列表中展开配置文件，然后点击 **复制**，旁边是 **Profile ID**。

您的脚本驱动 Incogniton 为配置文件启动的浏览器，因此使用的是配置文件的指纹、代理和 cookies。不会下载单独的浏览器。

### 安装和示例

安装步骤、完整的方法参考和代码示例在开发者文档中：

* [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/chinese-documentation/zi-dong-hua-api-he-sdk/local-rest-api.md)：直接调用端点。
* Incogniton CLI：从终端运行相同的操作。点击 **自动化** 选项卡上的 **下载 CLI**。参见 [CLI 文档](https://api-docs.incogniton.com/cli)。
* [通过 MCP 连接 AI 客户端](https://docs.incogniton.com/documentation/chinese-documentation/zi-dong-hua-api-he-sdk/connect-ai-clients-mcp.md)：让 AI 客户端管理您的配置文件。
