{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_t7m4xhexkkbk","handle":"ziniao-mcp","url":"https://wellknown.network/agents/ziniao-mcp","links":{"self":"https://wellknown.network/agents/ziniao-mcp/record.json","html":"https://wellknown.network/agents/ziniao-mcp","markdown":"https://wellknown.network/agents/ziniao-mcp/record.md","api":"https://wellknown.network/api/v1/agents/ziniao-mcp","status":"https://wellknown.network/api/v1/agents/ziniao-mcp/status","claim":"https://wellknown.network/agents/ziniao-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/ziniao-mcp/claim.json","badge":"https://wellknown.network/agents/ziniao-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/ziniao-mcp/history","tools":"https://wellknown.network/api/v1/agents/ziniao-mcp/tools"},"ard":{"identifier":"urn:air::server:ziniao-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"ziniao-mcp","summary":"紫鸟与 Chrome 浏览器 MCP 服务器 — 让 AI Agent 操控紫鸟店铺与本地 Chrome","description":"# ziniao-mcp\n\n紫鸟与 Chrome 浏览器 AI 自动化 — 让 AI Agent（Cursor、Claude 等）操控紫鸟店铺与本地 Chrome，统一会话、统一工具。\n\n**GitHub**：[https://github.com/tianyehedashu/ziniao-mcp](https://github.com/tianyehedashu/ziniao-mcp)\n\n## 快速使用\n\n只需两步即可在 Cursor 中使用全部 MCP 工具。紫鸟配置**可选**——不配置紫鸟也能使用全部 Chrome 浏览器功能。\n\n**1. 安装 [uv](https://docs.astral.sh/uv/)**\n\n```bash\n# Windows (PowerShell)\npowershell -ExecutionPolicy ByPass -c \"irm https://astral.sh/uv/install.ps1 | iex\"\n\n# macOS / Linux\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n```\n\n**2. 配置 MCP**\n\n打开 `Cursor Settings → MCP → New MCP Server`，根据你的使用场景选择配置：\n\n**仅使用 Chrome 浏览器**（无需紫鸟账号）：\n\n```json\n{\n  \"mcpServers\": {\n    \"ziniao\": {\n      \"command\": \"uvx\",\n      \"args\": [\"ziniao-mcp\"]\n    }\n  }\n}\n```\n\n配置完成后即可使用 `launch_chrome`、`connect_chrome` 及所有页面操作、录制回放等工具。\n\n**紫鸟店铺 + Chrome 浏览器**（完整功能）：\n\n```json\n{\n  \"mcpServers\": {\n    \"ziniao\": {\n      \"command\": \"uvx\",\n      \"args\": [\"ziniao-mcp\"],\n      \"env\": {\n        \"ZINIAO_COMPANY\": \"你的企业名\",\n        \"ZINIAO_USERNAME\": \"你的用户名\",\n        \"ZINIAO_PASSWORD\": \"你的密码\",\n        \"ZINIAO_CLIENT_PATH\": \"D:\\\\soft\\\\ziniao-v6\\\\ziniao.exe\",\n        \"ZINIAO_VERSION\": \"v6\"\n      }\n    }\n  }\n}\n```\n\n| 环境变量 | 说明 |\n|----------|------|\n| `ZINIAO_COMPANY` | 紫鸟企业名 |\n| `ZINIAO_USERNAME` | 登录用户名 |\n| `ZINIAO_PASSWORD` | 登录密码 |\n| `ZINIAO_CLIENT_PATH` | 紫鸟客户端可执行文件路径 |\n| `ZINIAO_SOCKET_PORT` | （可选）与客户端通信的 HTTP 端口。**不配置时自动检测运行中的客户端端口**，检测不到则默认 `16851` |\n| `ZINIAO_VERSION` | 客户端版本，默认 `v6` |\n\n配置完成后，在 Cursor 对话框中试试：\n\n```\n启动 Chrome 浏览器，打开百度\n```\n\n```\n列出我所有的紫鸟店铺\n```\n\n```\n打开第一个亚马逊店铺，截图看看当前页面\n```\n\n> **版本**：查看 `uvx ziniao-mcp -V`；刷新 `uvx --refresh ziniao-mcp --help`，再重启 Cursor MCP。\n>\n> **紫鸟前提**：使用紫鸟店铺功能需安装 [紫鸟客户端](https://www.ziniao.com/) 并**开启 WebDriver 权限**（[开通说明](https://open.ziniao.com/docSupport?docId=99)）。不使用紫鸟功能时无需安装。\n>\n> 更多安装方式与故障排查见 [安装与使用](docs/installation.md)。\n\n## 特性\n\n- **紫鸟可选**：不配置紫鸟也能使用全部 Chrome 浏览器功能（启动/连接/页面操作/录制回放），零配置即可上手\n- **统一浏览器支持**：紫鸟店铺（多店铺、WebDriver）与本地 Chrome（启动/连接 CDP）同一套 MCP 工具\n- **全部 MCP 工具**：店铺管理、Chrome 管理、统一会话、页面导航、输入自动化、录制回放…","publisher":null,"homepage":null,"repository":null,"version":"0.1.33","license":"AGPL-3.0","protocols":["mcp"],"tags":["browser","cdp","chrome","cross-border","e-commerce","mcp","ziniao"],"pricing":null,"endpoints":[{"url":"pypi:ziniao-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"infra.browser-automation","name":"Browser Automation","confidence":1,"provenance":"declared"}],"categories":["infra"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"ziniao-mcp","registry":"pypi","observedAt":"2026-11-10T07:23:47.777Z","publishedAt":"2026-03-19T09:23:33.533139Z","latestVersion":"0.1.33"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"ziniao-mcp","url":"https://pypi.org/project/ziniao-mcp/","firstSeenAt":"2026-09-10T16:23:58.225Z","fetchedAt":"2026-11-10T07:23:11.130Z","normalizedAt":"2026-11-10T07:23:11.130Z"}]},"firstSeenAt":"2026-09-10T16:23:58.225Z","updatedAt":"2026-11-10T07:23:47.777Z"}