> 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/vietnamese-documentation/api-tu-dong-va-sdks/javascript-and-python-sdk.md).

# SDK JavaScript và Python

Tự động hóa các hồ sơ Incogniton của bạn từ JavaScript/TypeScript hoặc Python với gói incogniton chính thức trên npm và PyPI.

Incogniton có các SDK chính thức cho JavaScript/TypeScript (`npm install incogniton`) và Python (`pip install incogniton`). Cả hai đều kết nối với [API REST cục bộ](https://docs.incogniton.com/documentation/vietnamese-documentation/api-tu-dong-va-sdks/local-rest-api.md) của ứng dụng Incogniton trên máy tính của bạn.

Với các SDK, bạn quản lý hồ sơ và cookie từ mã, và khởi chạy một hồ sơ trực tiếp vào thư viện tự động hóa trình duyệt: Puppeteer hoặc Playwright với SDK JavaScript, Playwright hoặc Selenium với SDK Python.

### Trước khi bạn bắt đầu

* Ứng dụng Incogniton phải được mở và đăng nhập trên cùng máy tính với script của bạn.
* API REST cục bộ phải được bật: **Settings** → **Automation** → **Enable automation API**. Đây là một tính năng trả phí. Xem [Sử dụng API REST cục bộ](https://docs.incogniton.com/documentation/vietnamese-documentation/api-tu-dong-va-sdks/local-rest-api.md).
* Cả hai SDK đều sử dụng cổng `35000` theo mặc định. Nếu bạn đã thay đổi **API port** trên tab Automation, hãy truyền cổng của bạn cho client.
* Bạn cần ID của hồ sơ bạn muốn tự động hóa. Mở rộng hồ sơ trong danh sách hồ sơ và nhấp vào **Copy** bên cạnh **Profile ID**.

Script của bạn điều khiển trình duyệt mà Incogniton khởi chạy cho hồ sơ, vì vậy dấu vân tay, proxy và cookie của hồ sơ được sử dụng. Không có trình duyệt riêng biệt nào được tải xuống.

### Cài đặt và ví dụ

Các bước cài đặt, tham chiếu phương pháp đầy đủ và ví dụ mã có trong tài liệu dành cho nhà phát triển:

* [Tổng quan về SDK](https://api-docs.incogniton.com/sdks/overview)
* [Node.js SDK](https://api-docs.incogniton.com/sdks/nodejs) (JavaScript/TypeScript, Puppeteer và Playwright)
* [Python SDK](https://api-docs.incogniton.com/sdks/python) (Playwright và Selenium)
* [Ví dụ tự động hóa](https://api-docs.incogniton.com/how-to-guides/automation-examples): các script Puppeteer, Playwright và Selenium sẵn sàng chạy

{% hint style="info" %}
Khởi chạy mỗi hồ sơ chỉ một lần tại một thời điểm. Nếu một hồ sơ đã đang chạy, ứng dụng sẽ từ chối khởi chạy lần thứ hai và SDK sẽ trả về lỗi với thông báo của ứng dụng.
{% endhint %}

### Tùy chọn tự động hóa khác

* [Sử dụng API REST cục bộ](https://docs.incogniton.com/documentation/vietnamese-documentation/api-tu-dong-va-sdks/local-rest-api.md): gọi trực tiếp các điểm cuối.
* Incogniton CLI: thực hiện các hành động tương tự từ terminal. Nhấp vào **Download CLI** trên tab **Automation**. Xem [tài liệu CLI](https://api-docs.incogniton.com/cli).
* [Kết nối các client AI với MCP](https://docs.incogniton.com/documentation/vietnamese-documentation/api-tu-dong-va-sdks/connect-ai-clients-mcp.md): để một client AI quản lý các hồ sơ của bạn.
