把 AI 可见度数据接进你的系统与 Agent

1 · 获取 API key

登录后在「设置」页创建 API key（明文只在创建时展示一次，请妥存）。开放 API 与 MCP 均为 Pro 档能力；每把 key 限 600 次请求/小时。

前往设置页创建 key →

2 · REST 开放 API v1

三个只读端点 + 一个发布登记端点（JSON；分数/计数为服务端算好的字符串，请勿重算）：

• GET /api/v1/brands主品牌列表
• GET /api/v1/brands/:id/scores最新总分 + 逐引擎子分 + 30 天趋势
• GET /api/v1/brands/:id/citationsTOP 20 被引用域名（工作区级累计聚合，:id 仅作归属校验）
• GET / POST /api/v1/brands/:id/publications登记一次【已经发生的】发布 + 它瞄准的监测问法，用于问法级前后对比

★发布登记端点只记录【已经发生的事实】——OrcaScope 不会、也无法替你把内容发到任何平台。它没有 DELETE：填错了请在控制台里撤回（那里会让你看清即将删掉的是哪条）。

POST 的响应会带 utmStatus（compliant / partial / untagged）与 utmWarnings：我们按 UTM 规范（utm_source=平台、utm_medium=earned-content、utm_campaign=批次）检查这条链接打没打标。utmWarnings 是【机器码】数组而非文案——取值为 unparsable / missing_source / missing_medium / medium_mismatch / missing_campaign，其中 medium_mismatch 会附带 actual 字段告诉你实际拿到的值。给码不给散文，是为了让你能据此做自动化：文案会随语言与措辞演进而变，码不会。★不合规【不会拒绝登记】，只是如实记录；★这只是链接参数的合规状态，不是流量归因——流量数据在你自己的分析工具里。

curl https://orca-scope.com/api/v1/brands \
  -H "Authorization: Bearer geo_live_..."

3 · MCP 端点（给 AI Agent）

标准 MCP（Model Context Protocol）Streamable HTTP 端点，无状态 JSON-RPC 2.0。把它加进任何 MCP 客户端，你的 Agent 就能直接查品牌 AI 可见度分、引用来源、行业基准与引擎清单。

端点

POST https://orca-scope.com/api/mcp
Authorization: Bearer geo_live_...

工具（首批 5 个，全只读）

• list_brands
• get_brand_scores
• get_brand_citations
• get_benchmarks
• list_engines

客户端配置（Claude Code / Cursor 等通用格式）

{
  "mcpServers": {
    "orcascope": {
      "type": "http",
      "url": "https://orca-scope.com/api/mcp",
      "headers": { "Authorization": "Bearer geo_live_..." }
    }
  }
}

或直接用 curl 验证

curl -X POST https://orca-scope.com/api/mcp \
  -H "Authorization: Bearer geo_live_..." \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'