Step 1：获取 API Key
登录 FlyAI GEO 控制台，在「账户设置 → API Key」中生成生产环境密钥。Key 仅在生成时显示一次明文，请妥善保管。
# 设置环境变量（Linux / macOS）
export FLYAI_API_KEY="sk_live_YOUR_PROD_KEY"
# Windows PowerShell
$env:FLYAI_API_KEY="sk_live_YOUR_PROD_KEY"沙箱环境 Key 以 sk_sandbox_ 开头，生产环境以 sk_live_ 开头，二者不通用。
Step 2：安装 SDK
通过 npm 或 yarn 安装 FlyAI Node.js SDK，或直接通过 REST API 调用。
# npm
npm install @flyai/sdk
# yarn
yarn add @flyai/sdkStep 3：调用首个诊断接口
传入 URL 清单，调用 POST /v1/diagnosis 接口，获取 100+ 维度的 AI 搜索可见性诊断报告。
curl 示例
curl -X POST https://api.flyai66.top/v1/diagnosis \
-H "Authorization: Bearer $FLYAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"urls": [
"https://www.flyai66.top",
"https://www.flyai66.top/product",
"https://www.flyai66.top/pricing"
],
"keywords": ["GEO 工具", "AI 搜索优化"]
}'TypeScript 示例
import { FlyAI } from '@flyai/sdk';
const flyai = new FlyAI({ apiKey: process.env.FLYAI_API_KEY });
const report = await flyai.diagnosis.create({
urls: [
'https://www.flyai66.top',
'https://www.flyai66.top/product',
'https://www.flyai66.top/pricing',
],
keywords: ['GEO 工具', 'AI 搜索优化'],
});
console.log(report.confidence); // 整体引用置信度 0-1
console.log(report.issues); // 问题清单（按严重程度排序）
console.log(report.suggestions); // 修复建议响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| confidence | number | 整体引用置信度，0-1 |
| issues | array | 问题清单，含严重程度与修复建议 |
| suggestions | array | 优化建议，按优先级排序 |