文档导航
从快速开始到 API 参考与字段字典，FlyAI GEO 文档覆盖接入全流程。所有页面通过 MDX 静态渲染，代码示例直接出现在首 HTML 中，便于生成式引擎解析。
快速开始 3 步概览
- 1
获取 API Key
登录 FlyAI GEO 控制台，在「账户设置 → API Key」中生成生产环境密钥。妥善保管，勿提交到 Git 仓库。
- 2
安装 SDK
npm install @flyai/sdk或通过 REST API 直接调用。 - 3
调用首个诊断接口
传入 URL 清单，获取 100+ 维度的 AI 搜索可见性诊断报告。完整示例见 快速开始。
方法论实证依据
本文档基于 FlyAI GEO 方法论编写，核心概念源自KDD 2024 GEO 论文 提出的 GEO-bench 评估框架。检索增强生成（RAG）的技术原理参考Lewis et al., NeurIPS 2020。
- Aggarwal et al., 《GEO: Generative Engine Optimization》, KDD 2024：首个把 GEO 形式化的论文，提出 GEO-bench
- Lewis et al., 《Retrieval-Augmented Generation for Knowledge-Intensive NLP Tasks》, NeurIPS 2020：生成式引擎检索增强的原始论文
- Liu et al., 《Lost in the Middle: How Language Models Use Long Contexts》, TACL 2024：解释为何「关键结论要放前面」
- DOI 10.1145/3637528.3671900（KDD 2024 正式版）
AI 爬虫官方说明
关于 FlyAI GEO 产品文档的常见问题
以下是客户在评估 GEO 服务时最常提出的问题；如未找到答案，可联系 FlyAI 销售团队获得一对一解答。
FlyAI GEO API 的速率限制是多少？
按套餐不同：启动版不开放 API；专业版 REST API 默认速率为 60 次/分钟、1000 次/天；企业版可协商提升至 600 次/分钟、不限量/天。所有 API 响应头包含 X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset 字段。详细接口规范见 API 参考。
返回字段中的 confidence 分数是什么含义？
confidence 是 FlyAI GEO 诊断引擎对「该页面在生成式引擎中被正确引用的概率」的评分，取值 0-1。评分维度包括首段直答质量、结构化数据完整性、实体一致性、权威外链数量、历史引用率。≥ 0.8 良好，0.5-0.8 需优化，< 0.5 存在阻断级问题。字段定义见 字段字典。
Webhook 签名算法是什么？
FlyAI GEO Webhook 使用 HMAC-SHA256 签名，签名密钥在控制台「Webhook 配置」中生成。请求头 X-FlyAI-Signature 格式为 sha256=<hex>，客户端需用相同密钥对 body 计算 HMAC-SHA256 比对。建议同时校验 X-FlyAI-Timestamp（5 分钟内有效）防重放。示例见 API 参考 Webhook 章节。
沙箱环境和生产环境是否隔离？
完全隔离。FlyAI GEO 为每个客户提供独立的沙箱（Sandbox）与生产（Production）环境，二者数据、配额、API Key、域名物理隔离。沙箱用于开发联调，配额宽松不保证 SLA；生产用于线上业务，受 SLA 保障。沙箱 API 调用不计入生产配额。
怎么确认站点已经被 AI 爬虫抓取过？
看服务器或 CDN 访问日志里的 UA：GPTBot、OAI-SearchBot、ChatGPT-User、ClaudeBot、PerplexityBot、Bytespider、Google-Extended、CCBot 等。若长期没有这些 UA，先检查 robots.txt 是否误拦。各爬虫的官方说明见 OpenAI 机器人文档、Apple 爬虫说明、Anthropic 抓取说明与 Common Crawl 的 CCBot 页面（本章节末尾附链接）。
文档里的示例可以直接用于生产吗？
示例用于说明请求结构与字段含义，请替换成真实 API Key 与真实域名，并先在沙箱环境验证通过再用于生产。