用途
Citation Intelligence 是一个 MCP 服务器，帮助智能体和开发者了解哪些 URL 会被 AI 搜索引擎在特定查询下引用。它覆盖 Perplexity、Google AI Overviews、ChatGPT、Claude、Gemini 和 Bing。目标是让引用数据直接流入你的工作流，而不是进入某个 SaaS 登录界面。
主要能力
工具按七个命名空间分组：
- citations_*：查询级别——谁引用了什么，附带何种证据。
- domain_*：域名级别——我是否被引用，因何被引用。
- signals_*：外部信号——AI Overview、Wikipedia、GSC、答案框位置。
- panel_*：已保存的查询面板（编辑观察列表）。
- report_*：开箱即用的报告产物。
- competitors_*：按查询的竞争格局。
- audit_*：可修复的页面内/站点内检查。
服务器端提示模板包括：audit_citation_readiness(url)、audit_competitor_snapshot(query, your_url?)、audit_crawler_checkup(url)、audit_gap_analysis(domain, days?)、audit_sitemap_coverage(sitemap_url)。
客户端可读取或订阅的缓存视图（无需工具调用）：citation://cache/summary、citation://panels、citation://docs/llms-txt、citation://docs/ai-crawlers、citation://domain/{domain}/cited-for。
测量方式与表面保真度
每个响应都包含 surface 字段，说明数据收集方式：
- perplexity（consumer_scrape）：通过 Perplexity API 使用 Sonar Pro 和接近消费级的系统提示，结果与 Perplexity.ai 较为接近。
- claude（api_proxy）：通过 Anthropic Messages API 使用 Claude Sonnet 并启用 web_search 工具；消费级 Claude.ai 使用不同的路由和排序逻辑，引用行为可能不同。
- openai（api_proxy）：通过 OpenAI Responses API 使用 gpt-4o + web_search_preview 工具。
- gemini（api_proxy）：通过 Generative Language API 使用 Gemini 2.5 Pro 并启用 google_search grounding；消费级 Gemini 使用相同 grounding 索引但重排序不同，结果仅具方向性。
- google_ai_mode（consumer_scrape）：通过 SerpAPI 获取 Google AI Mode 结果，最接近用户在 Google 搜索中看到的内容，需要 SERPAPI_KEY。
- bing_serp / brave_serp（web_rank）：传统 SERP 排名，不测量 LLM 引用；domain_am_i_cited 拒绝这些引擎，仅测量 LLM 行为。
每个工具响应都包含 interpretation_note 字段，用一句话概括保真度。
使用方式
需要 Node 20 或更高版本。将服务器添加到 MCP 客户端配置中（Windows 为 %APPDATA%\Claude\claude_desktop_config.json，macOS 为 ~/Library/Application Support/Claude/claude_desktop_config.json）。仅设置你拥有的密钥。任何支持 stdio 传输的 MCP 客户端均可使用相同的命令/参数模式。
环境变量用于提供 API 密钥；密钥从 MCP 进程的环境变量中读取，从不记录、从不持久化。缓存文件位于 ~/.config/citation-intelligence/cache.json，可随时删除，默认 TTL 为 7 天。
适用场景
- 构建研究型智能体，希望其引用 LLM 已信任的来源。
- 独立开发者或独立黑客检查自己的 SaaS 是否出现在 AI 搜索中。
- 内容创作者确认文章是否被 ChatGPT、Claude 或 Perplexity 引用。
- SEO 或 GEO 从业者希望以编程方式获取引用数据，而不依赖每月 295-499 美元的仪表盘。
- 编辑流程中希望基于引用缺口选择主题。
- 比较竞争对手在任意细分领域跨 AI 引擎的可见性。
限制与不适用场景
- 不适合需要精美营销仪表盘、图表和团队席位的用户。
- 不是带 SLA 的托管服务，按设计为自托管。
- 不用于学术论文引用追踪。
- 不包含 3.5 亿+ 预建模提示。
如何保持免费：无中心后端，服务器在你机器上运行，不上传任何内容；优先使用免费额度（SerpAPI 每月 100 次免费 Google AI Overview 查询，Bing Web Search 有免费层，Perplexity 注册后有免费 Sonar 访问）；自带付费密钥可启用高级引擎；本地缓存让重复查询命中缓存而非 API；citations_predict 无需任何密钥即可运行；所有 API 调用直接从你的机器发往供应商；无代理、无分析、默认无遥测。
工作流示例
- 每周引用追踪：从编辑积压中选择 20-30 个查询，每周快照，观察比率趋势；citations_trend 返回每个查询的增量。
- 发布前门禁：检查谁拥有引用位以及该位是否值得竞争。
- 批量站点审计：一次检查所有页面的站点级结构问题，零 API 开销。
- 竞争对手信号差距：查看 diverging_signals 找出你在哪里落后。
- Google 排名与 AI 引用差距：需要具备 webmasters.readonly 范围的 GCP 服务账号；closest_wins 返回 position <= 10 且 ai_cited: false 的查询。
- Wikipedia 提及监控：每季度重运行，差异即为“我们获得了 Wikipedia 引用”警报。
许可证为 MIT，由 automatelab.tech 构建。
