ai-citations-report

AI 引用报告

生成一份样式精美、可直接交付客户的 GEO 报告，展示哪些 AI 搜索提示词在 Google AI Overview 和 ChatGPT 中引用了某个域名。

此技能是 Enception AI Citations API（POST https://www.enception.ai/api/external/ai-citations）的轻量客户端。请勿在本地重新实现数据提取或报告 HTML 生成——所有逻辑（LLM Mentions 数据提取、引用与检索分类、流量趋势、内容覆盖率、HTML→PDF）均在服务端运行。

披露： 此技能由 Enception AI 提供，并调用 Enception 的付费 API。引用数据来自 DataForSEO LLM Mentions；流量数据为模型估算值。

API 文档：https://www.enception.ai/doc/api-ai-citations

要求

• ENCEPTION_API_KEY — Enception API 的访问密钥。自助获取：在 https://www.enception.ai 注册，然后前往 Account → API Key 生成免费层级密钥（每月免费生成 10 份报告；如需更高限额，请联系团队）。

生成内容

生成一份样式精美的 PDF（或 HTML/JSON），包含：

• 汇总表，列出所有引用或检索到该域名的提示词
• 自然流量、12 个月的月环比趋势和排名分布
• 完整的已引用提示词回答卡片，并突出显示该域名的来源
• 已检索但未引用的差距卡片（内容机会）
• 可选的逐篇文章引用覆盖率（针对你提供的 URL）

运行方法

curl -X POST https://www.enception.ai/api/external/ai-citations \
  -H 'Content-Type: application/json' \
  -d '{
    "domain": "example.com",
    "brandName": "Example Inc",
    "locationCode": 2840,
    "articles": ["my-article-slug", "https://example.com/articles/another-post"],
    "passcode": "'"$ENCEPTION_API_KEY"'"
  }' \
  -o ai-citations-example.com.pdf

然后打开 PDF，并在交付前目视核验（流量卡片、趋势变化、来源高亮）。

选项

• domain（必填）— 要分析的网站。
• brandName、locationCode、languageCode、genDate（可选）— 默认值分别为域名、2840（美国）、en 和当天日期。常见地点代码：2840 = 美国，2826 = 英国，2124 = 加拿大。
• articles[]（可选）— 内容覆盖率部分所用的文章别名或完整 URL。省略则跳过此部分。
• format（可选）— pdf（默认）、html 或 json（json 返回 {citedCount, retrievedCount, promptCount, html}；适合调试或将计数传递到其他位置）。

诚信准则（由报告模板强制执行）

• 使用“尚未在 AI 回答中被引用”，绝不使用“未被索引”——LLM Mentions 用于核实 AI 引用，而非 Google 索引状态。
• 流量标注为模型估算值（DataForSEO），而非实测分析数据。
• 面向客户的文档绝不承诺未来会获得 AI 引用——引用是内容质量自然产生的结果，并非可以保证交付的内容。

备注

• 速率限制：每小时 20 个请求。
• 即使某个域名没有任何 AI 引用，也会生成有效报告——此时差距卡片和流量背景信息正是报告的价值所在。