数据来源
AIEO.ee 的 SEO 与 GEO 数字从哪里来——mock、DataForSEO、Search Console 与 live AI 搜索后端。
在演示模式(DEMO_MODE=true,非生产环境默认开启)下平台零外部 key 即可端到端运行;生产环境则必须配置 SEO 数据源——没有静默的 mock 回退。本页把产品里的每个数字映射到其来源,让你始终清楚自己看的是什么。
SEO / SERP 数据
| 模式 | 触发条件 | 你得到什么 |
|---|---|---|
| Mock 数据源(仅演示) | DEMO_MODE=true 且未配置 DataForSEO | 确定性的加权 SERP 数据,排名追踪、差距分析、竞对发现全部可用。适合评估与演示;不是真实 Google 排名。 |
| DataForSEO | 设置了 DATAFORSEO_LOGIN + DATAFORSEO_PASSWORD(环境变量或管理后台) | 真实关键词指标(搜索量、难度、CPC、意图)、关键词 ideas 与按需实时 SERP 快照。域名级页面是已跟踪数据的本地聚合;反链读取存储概况(尚无实时反链数据源)。 |
演示模式之外,未配置 DataForSEO 的排名/研究调用会显式失败(DataForSEO is not configured),而不是伪造排名。SERP 深度是平台设置(默认 100)。
Google Search Console
连接 GSC(Settings → Sites)导入真实的 query/page 表现:
- OAuth 使用一次性 state;授权后由你选择站点。
- token 加密存储;同步拉取站点日总量与 query+day、page+day 两组明细,每次运行重拉最近 3 天以收敛迟到数据,游标仅在整轮成功后推进。
- 驱动 Search Analytics 页面:点击、展示、CTR、平均排名与 query 级趋势。
GSC 可选,且与 DataForSEO 相互独立。
GEO / AI 回答数据——live 与 sampled
这是最重要的区分。每次 GEO run 都带 data_source 标签:
-
live—— 引擎有真实 AI 搜索后端,且该次调用返回了真实搜索证据。3 个引擎支持 live 后端:- ChatGPT —— OpenAI web search(
OPENAI_API_KEY) - Perplexity —— 直连 Sonar API(
PERPLEXITY_API_KEY) - Google AI Overview —— Gemini grounding(
GEMINI_API_KEY)
live run 的引用是后端真实检索到的来源。
- ChatGPT —— OpenAI web search(
-
sampled—— 其余所有情况:没有 live 后端的引擎(Claude、Gemini 对话、Copilot、Qwen、Doubao、Hunyuan、GLM)、key 未配置的 live 引擎、或没有返回搜索证据的 live 调用(该次运行自动降级为 sampled)。由 LLM 复现它认为回答引擎会给出的答案。
请把 sampled 数字当作方向性信号,而不是对消费者产品的实测。产品界面在每个引擎和每次运行上都显示 data_source 标签;本文档持同一口径。不要把 sampled 引擎宣传为「我们实测了 ChatGPT/Copilot」。
mock provider
DEMO_MODE=true 时(非生产环境默认开启),一个确定性 mock AI provider 回答 prompt,使整条 GEO 流水线——追踪、解析、SOV、引用——在零 AI key 的情况下端到端跑通。mock run 有明确标注,非常适合评估产品;生产环境 DEMO_MODE 关闭,mock 回退会直接抛错而不是伪造数据。
AI providers(Agent、brief、分析用)
Growth Agent、内容 brief 与周度分析通过 provider 路由调用 LLM。可配置 OpenAI / Anthropic / Gemini / OpenRouter 任意一家,或 OpenAI 兼容的 Qwen / Doubao / Hunyuan / GLM 适配器——通过环境变量或平台管理后台。未配置 provider 时(且 DEMO_MODE 开启)这些功能使用 mock provider。
汇总
| 功能 | 演示模式、零 key | + DataForSEO | + GSC | + AI/live key |
|---|---|---|---|---|
| 排名追踪与差距 | mock(仅演示) | 真实 SERP | — | — |
| Search Analytics | — | — | 真实 GSC | — |
| GEO(sampled) | mock | mock | mock | LLM 采样 |
| GEO(live) | — | — | — | 真实引用 |
| Agent / brief | mock | mock | mock | 真实 LLM |
每种降级都在产品内如实标注。当一个数字可能是 mock 或 sampled 时,界面会说明——平台绝不把伪造数据静默呈现为 live。