{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_c4zkd8cnrbbn","handle":"bigspy-mcp","url":"https://wellknown.network/agents/bigspy-mcp","links":{"self":"https://wellknown.network/agents/bigspy-mcp/record.json","html":"https://wellknown.network/agents/bigspy-mcp","markdown":"https://wellknown.network/agents/bigspy-mcp/record.md","api":"https://wellknown.network/api/v1/agents/bigspy-mcp","status":"https://wellknown.network/api/v1/agents/bigspy-mcp/status","claim":"https://wellknown.network/agents/bigspy-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/bigspy-mcp/claim.json","badge":"https://wellknown.network/agents/bigspy-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/bigspy-mcp/history","tools":"https://wellknown.network/api/v1/agents/bigspy-mcp/tools"},"ard":{"identifier":"urn:air::server:bigspy-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"bigspy-mcp","summary":"BigSpy ad intelligence MCP server - query BigSpy ad data via Chrome CDP","description":"# BigSpy MCP\n\n通过 Chrome CDP 查询 BigSpy 广告数据的 MCP 服务器。支持自动翻页、多平台汇总、批量导出。\n\n## 安装\n\n```bash\npip install bigspy-mcp\nplaywright install chromium\n```\n\n## 配置\n\n### Claude Code（~/.claude/settings.json）\n\n```json\n{\n  \"mcpServers\": {\n    \"bigspy\": {\n      \"command\": \"bigspy-mcp\"\n    }\n  }\n}\n```\n\n### Claude Desktop\n\nMac: `~/Library/Application Support/Claude/claude_desktop_config.json`\nWindows: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"bigspy\": {\n      \"command\": \"bigspy-mcp\"\n    }\n  }\n}\n```\n\n### 通过 uvx（无需手动安装）\n\n```json\n{\n  \"mcpServers\": {\n    \"bigspy\": {\n      \"command\": \"uvx\",\n      \"args\": [\"bigspy-mcp\"]\n    }\n  }\n}\n```\n\n> 首次运行时 uvx 会自动安装，但仍需手动运行 `playwright install chromium`。\n\n## 使用前提\n\n1. **安装 Google Chrome**\n2. **登录 BigSpy**：首次使用时，工具会自动启动 Chrome 调试模式并打开 BigSpy，在 Chrome 里登录你的 BigSpy 账号即可。之后会记住登录状态。\n\n## 使用方式\n\n### 模式 1：抓当前搜索结果\n\n在 Chrome 的 BigSpy 页面里选好筛选条件，然后对 Claude 说：\n\n```\n帮我把当前 BigSpy 搜索结果全部拉下来\n```\n\n### 模式 2：自然语言描述\n\n```\n帮我查一下 Upside 近30天在美国的广告投放\n对比一下 Uber 和 Lyft 的广告投放\n```\n\n### 导出数据\n\n```\n导出成 CSV 放桌面\n导出成 Excel 保存到 ~/Documents/\n```\n\n## 可用工具\n\n| 工具 | 说明 |\n|------|------|\n| `check_connection` | 检查 Chrome 连接和 BigSpy 登录状态 |\n| `grab_current_search` | 抓取当前 BigSpy 页面的搜索结果 |\n| `search_ads` | 通过参数搜索广告数据 |\n| `export_ads` | 导出数据为 CSV / JSON / Excel |\n| `get_cross_platform_summary` | 获取多平台投放汇总 |\n| `compare_advertisers` | 对比多个广告主 |\n| `reset_connection` | 重置 Chrome 连接 |\n\n## 注意事项\n\n- 搜索消耗 BigSpy 的请求配额，工具会返回剩余配额\n- 可查询的平台取决于你的 BigSpy 套餐\n- Chrome 必须通过调试模式启动（工具会自动处理）","publisher":null,"homepage":null,"repository":null,"version":"0.1.0","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:bigspy-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"infra.browser-automation","name":"Browser Automation","confidence":0.825,"provenance":"derived"},{"slug":"documents.spreadsheets","name":"Spreadsheets","confidence":0.733,"provenance":"derived"}],"categories":["documents","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":"bigspy-mcp","registry":"pypi","observedAt":"2026-10-27T20:24:06.670Z","publishedAt":"2026-04-25T20:03:49.111309Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"bigspy-mcp","url":"https://pypi.org/project/bigspy-mcp/","firstSeenAt":"2026-09-09T10:27:03.515Z","fetchedAt":"2026-10-27T20:23:14.912Z","normalizedAt":"2026-10-27T20:23:14.912Z"}]},"firstSeenAt":"2026-09-09T10:27:03.515Z","updatedAt":"2026-10-27T20:24:06.670Z"}