用途:为指定域名生成客户可交付的 GEO 报告,展示哪些 AI 搜索提示词在 Google AI Overview 和 ChatGPT 中引用或检索了该站点,并给出自然流量背景。该技能是 Enception AI Citations API(POST https://www.enception.ai/api/external/ai-citations)的薄客户端,数据拉取、引用与检索分类、流量趋势、内容覆盖及 HTML→PDF 渲染均在服务端完成,不应在本地重新实现。
主要能力:报告包含所有引用或检索该域名的提示词汇总表、自然流量与 12 个月环比趋势及排名分布、带域名来源高亮的完整引用提示词卡片、检索但未引用的差距卡片(内容机会),以及可为传入 URL 生成逐文章引用覆盖。输出格式支持 pdf(默认)、html、json;json 返回 {citedCount, retrievedCount, promptCount, html}。
使用方式:需设置 ENCEPTION_API_KEY,可在 https://www.enception.ai 注册后在 Account → API Key 生成免费额度密钥(每月 10 份报告免费,更高额度需联系团队)。调用示例: 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[] 可选,省略则跳过内容覆盖部分;format 可选。
限制与注意:该技能由 Enception AI 贡献并调用其付费 API;引用数据来自 DataForSEO LLM Mentions,流量为模型估算值而非实测分析。报告模板强制诚实表述:写“尚未在 AI 答案中被引用”而非“未被索引”;流量标注为模型估算;不得向客户承诺未来会被 AI 引用。速率限制为每小时 20 次请求;无任何 AI 引用的域名仍会生成有效报告,此时差距卡片与流量背景即为其价值。API 文档见 https://www.enception.ai/doc/api-ai-citations。