adspower-browser 1.0.0

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "adspower-browser",
+  "version": "1.0.0",
+  "main": "build/cli.js",
+  "type": "commonjs",
+  "bin": {
+    "adspower-browser": "./build/cli.js"
+  },
+  "scripts": {
+    "build": "tsup",
+    "adspower": "node build/cli.js"
+  },
+  "dependencies": {
+    "axios": "^1.8.4",
+    "playwright": "^1.51.1",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@adspower/local-api-core": "workspace:*",
+    "@types/node": "^22.13.13",
+    "typescript": "^5.8.2",
+    "tsup": "^8.5.1"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "files": [
+    "build",
+    "skills"
+  ]
+}

package/skills/adspower-browser/SKILL.md

@@ -0,0 +1,145 @@
+---
+name: adspower-browser
+description: Runs AdsPower Local API operations via the adspower-browser CLI (no MCP required). Use when the user asks to create or manage AdsPower browsers, groups, proxies, or check status; run Node CLI commands that call the same handlers as the MCP server.
+---
+
+# AdsPower Local API with adspower-browser
+
+The Skills CLI (npx adspower-browser) is the package manager for operate AdsPower browser profiles, groups, proxies, and application/category lists via the **adspower-browser** CLI. 
+
+## When to Use This Skill
+
+Apply when the user:
+
+- Asks to create, update, delete, or list AdsPower browser profiles
+- Mentions opening or closing browsers/profiles, fingerprint, UA, or proxy
+- Wants to manage groups, proxies, or check API status
+- Refers to AdsPower or adspower-browser (and MCP is not running or not desired)
+
+Ensure AdsPower is running (default port 50325). Set `PORT` and `API_KEY` via environment or `--port` / `--api-key` if needed.
+
+## How to Run
+
+```bash
+adspower-browser [--port PORT] [--api-key KEY] <command> [<arg>]
+```
+
+**Two forms for `<arg>`:**
+
+1. **Single value (shorthand)** — for profile-related commands, pass one profile ID or number:
+   - `adspower-browser open-browser <ProfileId>`
+   - `adspower-browser close-browser <ProfileId>`
+   - `adspower-browser get-profile-cookies <ProfileId>`
+   - `adspower-browser get-browser-active <ProfileId>`
+   - `adspower-browser get-profile-ua <ProfileId>` (single ID)
+   - `adspower-browser new-fingerprint <ProfileId>` (single ID)
+
+2. **JSON string** — full parameters for any command (see Command Reference below):
+   - `adspower-browser open-browser '{"profileId":"abc123","launchArgs":"..."}'`
+   - Commands with no params: omit `<arg>` or use `'{}'`.
+
+## Essential Commands
+
+### Browser profile – open/close
+
+```bash
+adspower-browser open-browser <profileId>                    # Or JSON: profileId, profileNo?, ipTab?, launchArgs?, clearCacheAfterClosing?, cdpMask?
+adspower-browser close-browser <profileId>                   # Or JSON: profileId? | profileNo? (one required)
+```
+
+### Browser profile – create/update/delete/list
+
+```bash
+adspower-browser create-browser '{"groupId":"0","proxyid":"random",...}'  # groupId + account field + proxy required
+adspower-browser update-browser '{"profileId":"...",...}'    # profileId required
+adspower-browser delete-browser '{"profileIds":["..."]}'     # profileIds required
+adspower-browser get-browser-list '{}'                       # Or groupId?, limit?, page?, profileId?, profileNo?, sortType?, sortOrder?
+adspower-browser get-opened-browser                          # No params
+```
+
+### Browser profile – move/cookies/UA/fingerprint/cache/share/active
+
+```bash
+adspower-browser move-browser '{"groupId":"1","userIds":["..."]}'   # groupId + userIds required
+adspower-browser get-profile-cookies <profileId>             # Or JSON: profileId? | profileNo?
+adspower-browser get-profile-ua <profileId>                  # Or JSON: profileId[]? | profileNo[]? (up to 10)
+adspower-browser close-all-profiles                          # No params
+adspower-browser new-fingerprint <profileId>                 # Or JSON: profileId[]? | profileNo[]? (up to 10)
+adspower-browser delete-cache-v2 '{"profileIds":["..."],"type":["cookie","history"]}'  # type: local_storage|indexeddb|extension_cache|cookie|history|image_file
+adspower-browser share-profile '{"profileIds":["..."],"receiver":"email@example.com"}' # receiver required; shareType?, content?
+adspower-browser get-browser-active <profileId>              # Or JSON: profileId? | profileNo?
+adspower-browser get-cloud-active '{"userIds":"id1,id2"}'    # userIds comma-separated, max 100
+```
+
+### Group
+
+```bash
+adspower-browser create-group '{"groupName":"My Group","remark":"..."}'   # groupName required
+adspower-browser update-group '{"groupId":"1","groupName":"New Name"}'    # groupId + groupName required; remark? (null to clear)
+adspower-browser get-group-list '{}'                         # groupName?, size?, page?
+```
+
+### Application (categories)
+
+```bash
+adspower-browser check-status                                # No params – API availability
+adspower-browser get-application-list '{}'                   # category_id?, page?, limit?
+```
+
+### Proxy
+
+```bash
+adspower-browser create-proxy '{"proxies":[{"type":"http","host":"127.0.0.1","port":"8080"}]}'  # type, host, port required per item
+adspower-browser update-proxy '{"proxyId":"...","host":"..."}'   # proxyId required
+adspower-browser get-proxy-list '{}'                         # limit?, page?, proxyId?
+adspower-browser delete-proxy '{"proxyIds":["..."]}'        # proxyIds required, max 100
+```
+
+## Command Reference (full interface and parameters)
+
+All parameter names are camelCase in JSON.
+
+### Browser Profile Management
+
+See [references/browser-profile-management.md](references/browser-profile-management.md) for open-browser, close-browser, create-browser, update-browser, delete-browser, get-browser-list, get-opened-browser, move-browser, get-profile-cookies, get-profile-ua, close-all-profiles, new-fingerprint, delete-cache-v2, share-profile, get-browser-active, get-cloud-active and their parameters.
+
+### Group Management
+
+See [references/group-management.md](references/group-management.md) for create-group, update-group, and get-group-list parameters.
+
+### Application Management
+
+See [references/application-management.md](references/application-management.md) for check-status and get-application-list parameters.
+
+### Proxy Management
+
+See [references/proxy-management.md](references/proxy-management.md) for create-proxy, update-proxy, get-proxy-list, and delete-proxy parameters.
+
+### UserProxyConfig (inline proxy config for create-browser / update-browser)
+
+See [references/user-proxy-config.md](references/user-proxy-config.md) for all fields (proxy_soft, proxy_type, proxy_host, proxy_port, etc.) and example.
+
+### FingerprintConfig (fingerprint config for create-browser / update-browser)
+
+See [references/fingerprint-config.md](references/fingerprint-config.md) for all fields (timezone, language, WebRTC, browser_kernel_config, random_ua, TLS, etc.) and example.
+
+## Automation (Not Supported by This CLI)
+
+Commands such as `navigate`, `click-element`, `fill-input`, `screenshot` depend on a persistent browser connection and are **not** exposed by this CLI. Use the **local-api-mcp** MCP server for automation.
+
+## Deep-Dive Documentation
+
+Reference docs with full enum values and field lists:
+
+| Reference | Description | When to use |
+|-----------|-------------|-------------|
+| [references/browser-profile-management.md](references/browser-profile-management.md) | **open-browser**, **close-browser**, **create-browser**, **update-browser**, **delete-browser**, **get-browser-list**, **get-opened-browser**, **move-browser**, **get-profile-cookies**, **get-profile-ua**, **close-all-profiles**, **new-fingerprint**, **delete-cache-v2**, **share-profile**, **get-browser-active**, **get-cloud-active** parameters. | Any browser profile operation (open, create, update, delete, list, move, cookies, UA, cache, share, status). |
+| [references/group-management.md](references/group-management.md) | **create-group**, **update-group**, **get-group-list** parameters. | Creating, updating, or listing browser groups. |
+| [references/application-management.md](references/application-management.md) | **check-status**, **get-application-list** parameters. | Checking API availability or listing applications (categories). |
+| [references/proxy-management.md](references/proxy-management.md) | **create-proxy**, **update-proxy**, **get-proxy-list**, **delete-proxy** parameters and enums. | Creating, updating, listing, or deleting proxies. |
+| [references/user-proxy-config.md](references/user-proxy-config.md) | Full **userProxyConfig** field list (proxy_soft, proxy_type, proxy_host, proxy_port, etc.) and example. | Building inline proxy config for create-browser / update-browser when not using **proxyid**. |
+| [references/fingerprint-config.md](references/fingerprint-config.md) | Full **fingerprintConfig** field list (timezone, language, WebRTC, browser_kernel_config, random_ua, TLS, etc.) and example. | Building or editing fingerprint config for create-browser / update-browser. |
+| [references/browser-kernel-config.md](references/browser-kernel-config.md) | **type** and **version** for `fingerprintConfig.browser_kernel_config`. Version must match type (Chrome vs Firefox). | Pinning or choosing a specific browser kernel (Chrome/Firefox and version) when creating or updating a browser. |
+| [references/ua-system-version.md](references/ua-system-version.md) | **ua_system_version** enum for `fingerprintConfig.random_ua`: specific OS versions, generic “any version” per system, and omit behavior. | Constraining or randomizing UA by OS (e.g. Android only, or “any macOS version”) when creating or updating a browser. |
+
+Use these when you need the exact allowed values or semantics; the main skill text above only summarizes.

package/skills/adspower-browser/references/application-management.md

@@ -0,0 +1,11 @@
+# Application Management
+
+**check-status** — Check the availability of the current device API interface (Connection Status).
+
+- No parameters.
+
+**get-application-list** — Get the list of applications (categories).
+
+- **category_id** (optional): Extension category_id.
+- **page** (optional): Default 1.
+- **limit** (optional): 1–100. Values per page.

package/skills/adspower-browser/references/browser-kernel-config.md

@@ -0,0 +1,26 @@
+# Browser kernel config
+
+Used under **fingerprintConfig** → **browser_kernel_config**. Version and type must match: only versions valid for the chosen type are allowed.
+
+## type (optional)
+
+| Value     | Default  |
+|----------|----------|
+| `chrome` | default  |
+| `firefox`| —        |
+
+## version (optional)
+
+Default: `"ua_auto"`.
+
+### Chrome
+
+`92`, `99`, `102`, `105`, `108`, `111`, `114`, `115`, `116`, `117`, `118`, `119`, `120`, `121`, `122`, `123`, `124`, `125`, `126`, `127`, `128`, `129`, `130`, `131`, `132`, `133`, `134`, `135`, `136`, `137`, `138`, `139`, `140`, `141`, `142`, `143`, `144`, `ua_auto`
+
+### Firefox
+
+`100`, `107`, `114`, `120`, `123`, `126`, `129`, `132`, `135`, `138`, `141`, `144`, `ua_auto`
+
+## Example
+
+`"browser_kernel_config": { "version": "ua_auto", "type": "chrome" }`

package/skills/adspower-browser/references/browser-profile-management.md

@@ -0,0 +1,94 @@
+# Browser Profile Management
+
+**open-browser** — Open the browser (environment/profile).
+
+- **profileId** (required): Unique profile ID, generated after creating profile.
+- **profileNo** (optional): Profile number; priority given to profileId when both provided.
+- **ipTab** (optional): `'0'` | `'1'`, default 0. Whether to open the IP detection page.
+- **launchArgs** (optional): Chrome launch args or startup URL.
+- **clearCacheAfterClosing** (optional): `'0'` | `'1'`, default 0.
+- **cdpMask** (optional): `'0'` | `'1'`, default 0. Whether to mask CDP detection.
+
+**close-browser** — Close the browser.
+
+- **profileId** (optional) or **profileNo** (optional): One required. The profile to stop.
+
+**create-browser** — Create a browser.
+
+- **groupId** (required): Numeric string; use `"0"` for Ungrouped. Get list via get-group-list.
+- At least one of **username**, **password**, **cookie**, **fakey** (required): Account information.
+- **userProxyConfig** or **proxyid** (one required): Custom proxy config (see [user-proxy-config.md](user-proxy-config.md)) or saved proxy ID / `"random"`.
+- **name** (optional, max 100): Account name.
+- **platform** (optional): Platform domain, e.g. facebook.com.
+- **remark** (optional, max 1500): Remarks.
+- **tabs** (optional): URLs to open on startup, e.g. `["https://www.google.com"]`.
+- **repeatConfig** (optional): `0` | `2` | `3` | `4`. Account deduplication.
+- **ignoreCookieError** (optional): `'0'` | `'1'`. Handle cookie verification failures.
+- **ip**, **country** (see [country-code.md](country-code.md)), **region**, **city** (optional).
+- **ipchecker** (optional): `'ip2location'` | `'ipapi'`. IP query channel.
+- **categoryId** (optional): Use get-application-list to get list.
+- **fingerprintConfig** (optional): Browser fingerprint config; see [fingerprint-config.md](fingerprint-config.md).
+
+**update-browser** — Update the browser.
+
+- **profileId** (required): The profile id of the browser to update.
+- **platform**, **tabs**, **cookie**, **username**, **password**, **fakey**, **ignoreCookieError** (`'0'`|`'1'`), **groupId**, **name** (max 100), **remark** (max 1500), **country** (see [country-code.md](country-code.md)), **region**, **city**, **ip**, **categoryId**, **userProxyConfig** (see [user-proxy-config.md](user-proxy-config.md)), **proxyid**, **fingerprintConfig** (see [fingerprint-config.md](fingerprint-config.md)), **launchArgs** (all optional).
+
+**delete-browser** — Delete the browser(s).
+
+- **profileIds** (required): Array of profile ids to delete.
+
+**get-browser-list** — Get the list of browsers.
+
+- **groupId** (optional): Numeric string; query by group ID; empty searches all groups.
+- **limit** (optional): 1–200, default 50. Profiles per page.
+- **page** (optional): Default 1.
+- **profileId** (optional): Array, e.g. `["h1yynkm","h1yynks"]`.
+- **profileNo** (optional): Array, e.g. `["123","124"]`.
+- **sortType** (optional): `'profile_no'` | `'last_open_time'` | `'created_time'`.
+- **sortOrder** (optional): `'asc'` | `'desc'`.
+
+**get-opened-browser** — Get the list of opened browsers.
+
+- No parameters.
+
+**move-browser** — Move browsers to a group.
+
+- **groupId** (required): Numeric string. Target group id; use get-group-list to get list.
+- **userIds** (required): Array of browser profile ids to move.
+
+**get-profile-cookies** — Query cookies of the specified profile. One profile per request.
+
+- **profileId** (optional) or **profileNo** (optional): One required.
+
+**get-profile-ua** — Query User-Agent of specified profiles. Up to 10 per request.
+
+- **profileId** (optional): Array. Or **profileNo** (optional): Array. At least one element required.
+
+**close-all-profiles** — Close all opened profiles on the current device.
+
+- No parameters.
+
+**new-fingerprint** — Generate a new fingerprint for specified profiles. Up to 10 per request.
+
+- **profileId** (optional): Array. Or **profileNo** (optional): Array.
+
+**delete-cache-v2** — Clear local cache of specific profiles. Ensure no open browsers when using.
+
+- **profileIds** (required): Array of profile ids.
+- **type** (required): Array of `'local_storage'` | `'indexeddb'` | `'extension_cache'` | `'cookie'` | `'history'` | `'image_file'`.
+
+**share-profile** — Share profiles via account email or phone. Max 200 per request.
+
+- **profileIds** (required): Array.
+- **receiver** (required): Account email or phone number, no area code.
+- **shareType** (optional): 1 for email (default), 2 for phone number.
+- **content** (optional): Array of `'name'` | `'proxy'` | `'remark'` | `'tabs'`. Shared content.
+
+**get-browser-active** — Get active browser profile information.
+
+- **profileId** (optional) or **profileNo** (optional): One required.
+
+**get-cloud-active** — Query status of browser profiles by user_id. Up to 100 per request.
+
+- **userIds** (required): Comma-separated profile IDs string, max 100. Unique profile ID generated after creating profile.

package/skills/adspower-browser/references/chrome-tls-cipher.md

@@ -0,0 +1,34 @@
+# Chrome TLS Cipher Suites (tls enum)
+
+**tls** is only supported when the browser kernel is **Chrome**. Use comma-separated hex codes in **fingerprintConfig.tls**, e.g. `"0xC02C,0xC030"`.
+
+| Name | Hex code |
+|------|----------|
+| TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 | 0xC02C |
+| TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 | 0xC030 |
+| TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 | 0xC02B |
+| TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 | 0xC02F |
+| TLS_ECDHE_ECDSA_WITH_CHACHA20_POLY1305_SHA256 | 0xCCA9 |
+| TLS_ECDHE_RSA_WITH_CHACHA20_POLY1305_SHA256 | 0xCCA8 |
+| TLS_DHE_RSA_WITH_AES_256_GCM_SHA384 | 0x009F |
+| TLS_DHE_RSA_WITH_AES_128_GCM_SHA256 | 0x009E |
+| TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384 | 0xC024 |
+| TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384 | 0xC028 |
+| TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA | 0xC00A |
+| TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA | 0xC014 |
+| TLS_DHE_RSA_WITH_AES_256_CBC_SHA256 | 0x006B |
+| TLS_DHE_RSA_WITH_AES_256_CBC_SHA | 0x0039 |
+| TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 | 0xC023 |
+| TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 | 0xC027 |
+| TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA | 0xC009 |
+| TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA | 0xC013 |
+| TLS_DHE_RSA_WITH_AES_128_CBC_SHA256 | 0x0067 |
+| TLS_DHE_RSA_WITH_AES_128_CBC_SHA | 0x0033 |
+| TLS_RSA_WITH_AES_256_GCM_SHA384 | 0x009D |
+| TLS_RSA_WITH_AES_128_GCM_SHA256 | 0x009C |
+| TLS_RSA_WITH_AES_256_CBC_SHA256 | 0x003D |
+| TLS_RSA_WITH_AES_128_CBC_SHA256 | 0x003C |
+| TLS_RSA_WITH_AES_256_CBC_SHA | 0x0035 |
+| TLS_RSA_WITH_AES_128_CBC_SHA | 0x002F |
+| TLS_AES_128_CCM_8_SHA256 | 0x1305 |
+| TLS_AES_128_CCM_SHA256 | 0x1304 |

package/skills/adspower-browser/references/country-code.md

@@ -0,0 +1,253 @@
+# Country Code (country 字段取值)
+
+**country** 传参使用下表左侧的 **code**（小写两字母），用于 create-browser / update-browser 等接口的 `country` 字段。参见 `schemas.ts` 中的 createBrowserSchema、updateBrowserSchema。
+
+| Code | Country |
+|------|---------|
+| ad | Andorra |
+| ae | United Arab Emirates |
+| af | Afghanistan |
+| ag | Antigua & Barbuda |
+| ai | Anguilla |
+| al | Albania |
+| am | Armenia |
+| ao | Angola |
+| aq | Antarctica |
+| ar | Argentina |
+| as | American Samoa |
+| at | Austria |
+| au | Australia |
+| aw | Aruba |
+| ax | Åland Islands |
+| az | Azerbaijan |
+| ba | Bosnia & Herzegovina |
+| bb | Barbados |
+| bd | Bangladesh |
+| be | Belgium |
+| bf | Burkina |
+| bg | Bulgaria |
+| bh | Bahrain |
+| bi | Burundi |
+| bj | Benin |
+| bl | Saint Barthélemy |
+| bm | Bermuda |
+| bn | Brunei |
+| bo | Bolivia |
+| bq | Caribbean Netherlands |
+| br | Brazil |
+| bs | The Bahamas |
+| bt | Bhutan |
+| bv | Bouvet Island |
+| bw | Botswana |
+| by | Belarus |
+| bz | Belize |
+| ca | Canada |
+| cc | Cocos (Keeling) Islands |
+| cd | Democratic Republic of the Congo |
+| cf | Central African Republic |
+| cg | Republic of the Congo |
+| ch | Switzerland |
+| ci | Côte d'Ivoire |
+| cl | Chile |
+| cm | Cameroon |
+| cn | China |
+| co | Colombia |
+| cr | Costa Rica |
+| cu | Cuba |
+| cv | Cape Verde |
+| cx | Christmas Island |
+| cy | Cyprus |
+| cz | Czech Republic |
+| de | Germany |
+| dj | Djibouti |
+| dk | Denmark |
+| dm | Dominica |
+| do | Dominican Republic |
+| dz | Algeria |
+| ec | Ecuador |
+| ee | Estonia |
+| eg | Egypt |
+| eh | Western Sahara |
+| er | Eritrea |
+| es | Spain |
+| et | Ethiopia |
+| fi | Finland |
+| fj | Fiji |
+| fk | Falkland Islands |
+| fm | Federated States of Micronesia |
+| fo | Faroe Islands |
+| fr | France |
+| ga | Gabon |
+| gb | Great Britain |
+| gd | Grenada |
+| ge | Georgia |
+| gf | French Guiana |
+| gg | Guernsey |
+| gh | Ghana |
+| gi | Gibraltar |
+| gl | Greenland |
+| gm | Gambia |
+| gn | Guinea |
+| gp | Guadeloupe |
+| gq | Equatorial Guinea |
+| gr | Greece |
+| gs | South Georgia and the South Sandwich Islands |
+| gt | Guatemala |
+| gu | Guam |
+| gw | Guinea-Bissau |
+| gy | Guyana |
+| hk | China Hong Kong |
+| hm | Heard Island and McDonald Islands |
+| hn | Honduras |
+| hr | Croatia |
+| ht | Haiti |
+| hu | Hungary |
+| id | Indonesia |
+| ie | Ireland |
+| il | Israel |
+| im | Isle of Man |
+| in | India |
+| io | British Indian Ocean Territory |
+| iq | Iraq |
+| ir | Iran |
+| is | Iceland |
+| it | Italy |
+| je | Jersey |
+| jm | Jamaica |
+| jo | Jordan |
+| jp | Japan |
+| ke | Kenya |
+| kg | Kyrgyzstan |
+| kh | Cambodia |
+| ki | Kiribati |
+| km | The Comoros |
+| kn | St. Kitts & Nevis |
+| kp | North Korea |
+| kr | South Korea |
+| kw | Kuwait |
+| ky | Cayman Islands |
+| kz | Kazakhstan |
+| la | Laos |
+| lb | Lebanon |
+| lc | St. Lucia |
+| li | Liechtenstein |
+| lk | Sri Lanka |
+| lr | Liberia |
+| ls | Lesotho |
+| lt | Lithuania |
+| lu | Luxembourg |
+| lv | Latvia |
+| ly | Libya |
+| ma | Morocco |
+| mc | Monaco |
+| md | Moldova |
+| me | Montenegro |
+| mf | Saint Martin (France) |
+| mg | Madagascar |
+| mh | Marshall islands |
+| mk | Republic of Macedonia (FYROM) |
+| ml | Mali |
+| mm | Myanmar (Burma) |
+| mn | Mongolia |
+| mo | China Macao |
+| mp | Northern Mariana Islands |
+| mq | Martinique |
+| mr | Mauritania |
+| ms | Montserrat |
+| mt | Malta |
+| mu | Mauritius |
+| mv | Maldives |
+| mw | Malawi |
+| mx | Mexico |
+| my | Malaysia |
+| mz | Mozambique |
+| na | Namibia |
+| nc | New Caledonia |
+| ne | Niger |
+| nf | Norfolk Island |
+| ng | Nigeria |
+| ni | Nicaragua |
+| nl | Netherlands |
+| no | Norway |
+| np | Nepal |
+| nr | Nauru |
+| nu | Niue |
+| nz | New Zealand |
+| om | Oman |
+| pa | Panama |
+| pe | Peru |
+| pf | French polynesia |
+| pg | Papua New Guinea |
+| ph | The Philippines |
+| pk | Pakistan |
+| pl | Poland |
+| pm | Saint-Pierre and Miquelon |
+| pn | Pitcairn Islands |
+| pr | Puerto Rico |
+| ps | Palestinian territories |
+| pt | Portugal |
+| pw | Palau |
+| py | Paraguay |
+| qa | Qatar |
+| re | Réunion |
+| ro | Romania |
+| rs | Serbia |
+| ru | Russian Federation |
+| rw | Rwanda |
+| sa | Saudi Arabia |
+| sb | Solomon Islands |
+| sc | Seychelles |
+| sd | Sudan |
+| se | Sweden |
+| sg | Singapore |
+| sh | St. Helena & Dependencies |
+| si | Slovenia |
+| sj | Template:Country data SJM Svalbard |
+| sk | Slovakia |
+| sl | Sierra Leone |
+| sm | San Marino |
+| sn | Senegal |
+| so | Somalia |
+| sr | Suriname |
+| ss | South Sudan |
+| st | Sao Tome & Principe |
+| sv | El Salvador |
+| sy | Syria |
+| sz | Swaziland |
+| tc | Turks & Caicos Islands |
+| td | Chad |
+| tf | French Southern Territories |
+| tg | Togo |
+| th | Thailand |
+| tj | Tajikistan |
+| tk | Tokelau |
+| tl | Timor-Leste (East Timor) |
+| tm | Turkmenistan |
+| tn | Tunisia |
+| to | Tonga |
+| tr | Turkey |
+| tt | Trinidad & Tobago |
+| tv | Tuvalu |
+| tw | China Taiwan |
+| tz | Tanzania |
+| ua | Ukraine |
+| ug | Uganda |
+| um | United States Minor Outlying Islands |
+| us | United States of America (USA) |
+| uy | Uruguay |
+| uz | Uzbekistan |
+| va | Vatican City (The Holy See) |
+| vc | St. Vincent & the Grenadines |
+| ve | Venezuela |
+| vg | British Virgin Islands |
+| vi | United States Virgin Islands |
+| vn | Vietnam |
+| vu | Vanuatu |
+| wf | Wallis and Futuna |
+| ws | Samoa |
+| ye | Yemen |
+| yt | Mayotte |
+| za | South Africa |
+| zm | Zambia |
+| zw | Zimbabwe |
+| ck | Cook Islands |

package/skills/adspower-browser/references/fingerprint-config.md

@@ -0,0 +1,49 @@
+# FingerprintConfig (fingerprint config for create-browser / update-browser)
+
+**fingerprintConfig** is aligned with AdsPower Local API **fingerprint_config**; all fields are optional. 
+
+- **automatic_timezone** (optional): Auto timezone by IP. `'0'` custom / `'1'` by IP (default)
+- **timezone** (optional): Timezone when automatic_timezone=0, e.g. `Asia/Shanghai`
+- **location_switch** (optional): Location by IP. `'0'` custom / `'1'` by IP (default)
+- **longitude** (optional): Custom longitude when location_switch=0, -180 to 180, up to 6 decimals
+- **latitude** (optional): Custom latitude when location_switch=0, -90 to 90, up to 6 decimals
+- **accuracy** (optional): Location accuracy in meters when location_switch=0, 10–5000 integer, default 1000
+- **location** (optional): Site location permission. `'ask'` (default) / `'allow'` / `'block'`
+- **language_switch** (optional): Language by IP country. `'0'` custom / `'1'` by IP (default)
+- **language** (optional): Custom languages when language_switch=0, e.g. `["en-US", "zh-CN"]`
+- **page_language_switch** (optional): Match UI language to language. `'0'` off / `'1'` on (default); requires Chrome 109+ Win / 119+ macOS, AdsPower v2.6.72+
+- **page_language** (optional): Page language when page_language_switch=0, e.g. `en-US`
+- **ua** (optional): Custom User-Agent string; when set, takes precedence over **random_ua** (random_ua is not sent). Omit for random UA.
+- **screen_resolution** (optional): Screen resolution. `'none'` follow computer (default) / `'random'` / or `"width_height"` e.g. `"1024_600"`
+- **fonts** (optional): Font list, e.g. `["Arial", "Times New Roman"]` or `["all"]`
+- **canvas** (optional): Canvas fingerprint. `'0'` computer default / `'1'` add noise (default)
+- **webgl** (optional): WebGL metadata. `'0'` computer default / `'2'` custom (requires **webgl_config**) / `'3'` random
+- **webgl_image** (optional): WebGL image fingerprint. `'0'` computer default / `'1'` add noise (default)
+- **webgl_config** (optional): When webgl=2, **required**; vendor and renderer cannot be empty.
+  - **unmasked_vendor** (required when webgl=2): e.g. `"Google Inc."`
+  - **unmasked_renderer** (required when webgl=2): e.g. `"ANGLE (Intel(R) HD Graphics 620 Direct3D11 vs_5_0 ps_5_0)"`
+  - **webgpu** (optional): `{ "webgpu_switch": "0" | "1" | "2" }` — 0 Disabled, 1 WebGL based matching, 2 Real. V2.6.8.1+
+- **flash** (optional): Flash. `'block'` (default) / `'allow'`
+- **webrtc** (optional): WebRTC. `'disabled'` (default) / `'forward'` / `'proxy'` / `'local'`
+- **audio** (optional): Audio fingerprint. `'0'` close / `'1'` add noise (default)
+- **do_not_track** (optional): DNT. `'default'` / `'true'` (open) / `'false'` (close)
+- **hardware_concurrency** (optional): CPU cores. `'2'` | `'4'` | `'6'` | `'8'` | `'16'`; omit to follow computer
+- **device_memory** (optional): Device memory (GB). `'2'` | `'4'` | `'6'` | `'8'`; omit to follow computer
+- **scan_port_type** (optional): Port scan protection. `'0'` close / `'1'` enable (default)
+- **allow_scan_ports** (optional): Ports allowed when scan_port_type=1, e.g. `["4000","4001"]`
+- **media_devices** (optional): Media devices. `'0'` off / `'1'` noise (count from local) / `'2'` noise (use **media_devices_num**). V2.6.4.2+
+- **media_devices_num** (optional): When media_devices=2: `{ "audioinput_num": "1"-"9", "videoinput_num": "1"-"9", "audiooutput_num": "1"-"9" }`. V2.6.4.2+
+- **client_rects** (optional): ClientRects. `'0'` computer default / `'1'` add noise. V3.6.2+
+- **device_name_switch** (optional): Device name. `'0'` close / `'1'` mask / `'2'` custom (**device_name**). V3.6.25+
+- **device_name** (optional): Custom device name when device_name_switch=2. V2.4.8.1+
+- **speech_switch** (optional): SpeechVoices. `'0'` computer default / `'1'` replace. V3.11.10+
+- **mac_address_config** (optional): MAC address. `{ "model": "0"|"1"|"2", "address"?: string }` — 0 use computer, 1 match, 2 custom (address required). V4.3.9+
+- **gpu** (optional): GPU. `'0'` follow Local settings / `'1'` turn on / `'2'` turn off
+- **browser_kernel_config** (optional): Browser kernel; type and version must match. See [browser-kernel-config.md](browser-kernel-config.md)
+- **random_ua** (optional): Random UA; ignored when **ua** (custom UA) is provided.
+  - **ua_version** (optional): UA version string array
+  - **ua_system_version** (optional): System version enum array. See [ua-system-version.md](ua-system-version.md)
+- **tls_switch** (optional): Enable custom TLS. `'0'` (default) / `'1'`
+- **tls** (optional): **Chrome kernel only**. Comma-separated TLS hex codes when tls_switch=1, e.g. `"0xC02C,0xC030"`. See [chrome-tls-cipher.md](chrome-tls-cipher.md)
+
+Example: `"fingerprintConfig":{"timezone":"America/New_York","language":["en-US"],"webrtc":"proxy","browser_kernel_config":{"version":"ua_auto","type":"chrome"}}`

package/skills/adspower-browser/references/group-management.md

@@ -0,0 +1,18 @@
+# Group Management
+
+**create-group** — Create a browser group.
+
+- **groupName** (required): Name of the group to create.
+- **remark** (optional): Remark of the group.
+
+**update-group** — Update the browser group.
+
+- **groupId** (required): Numeric string. Id of the group to update; use get-group-list to get list.
+- **groupName** (required): New name of the group.
+- **remark** (optional, nullable): New remark; set null to clear.
+
+**get-group-list** — Get the list of groups.
+
+- **groupName** (optional): Name to search (like search).
+- **size** (optional): Page size, max 100, default 10.
+- **page** (optional): Default 1.