文档

控制台、CLI、API 与 MCP 共用同一服务层。下方每条命令都适用于当前版本。

快速开始

应用会自动打开控制台和本地 API。若从源码安装，可使用右侧命令启动服务。

默认地址：127.0.0.1:8710
可在“帮助”中复制令牌
所有 v1 路由均需要令牌

nimbusx · start

$ python -m app.cli serve --port 8710 ✓ http://127.0.0.1:8710 $ python -m app.cli token

$ curl http://127.0.0.1:8710/api/v1/profiles \ -H "X-Antidetect-Token: $TOKEN" [ ] 创建配置前为空

创建配置

名称为必填项。设备与一致的指纹由 NimbusX 自动选择，其他设置可稍后补充。

nimbusx · profiles

$ curl -X POST http://127.0.0.1:8710/api/v1/profiles \ -H "X-Antidetect-Token: $TOKEN" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: market-01" \ -d '{"name":"market-01"}'

from app.client import Client api = Client() profile = api.create_profile( "market-01", idempotency_key="market-01", )

自动化

原始 CDP 端口保持关闭。常用浏览器操作通过认证 API 完成，任意本地进程无法直接接管配置。

nimbusx · automation

api.launch("market-01") api.goto("market-01", "https://iphey.com") title = api.evaluate( "market-01", "() => document.title" ) api.screenshot("market-01", "check.png") api.stop("market-01")

MCP 服务器

MCP 通过 stdio 运行，自动找到已启动的服务，并复用同一安全层。MCP 没有单独的 HTTP 地址。

nimbusx · mcp

{ "mcpServers": { "nimbusx": { "command": "C:\\Program Files\\NimbusX\\NimbusX.exe", "args": ["mcp"] } } }

{ "mcpServers": { "nimbusx": { "command": "python", "args": ["-m", "app.mcp"] } } }

代理

通过 URL 添加 HTTP、HTTPS、SOCKS5 或 SSH 代理。参数 --check 会立即检查可用性、地区与延迟。

nimbusx · proxy

$ python -m app.cli proxy add \ --url socks5://user:pass@host:1080 \ --label berlin-01 --check

检测结果

测试台会在全新配置中打开选定的检测站点，保存完整结果，并单独标记未响应的站点。

nimbusx · bench

$ python -m app.cli bench run \ --only creepjs,iphey,sannysoft \ --note release-candidate 实际测试结束后会输出汇总。