CallAI SEO

CallAI — 面向 AI Agent 的实时 SEO 数据

中文说明

CallAI 为你的 AI Agent 提供真实的搜索数据，而不是猜测：实时 Google 和 Bing 搜索结果（包括 Google AI Overview 及其引用的网站）、关键词搜索量和难度、长尾关键词建议、竞争对手的关键词差距、域名流量、反向链接和页面审计。

它有两种使用方式：

• DeepSeek Harness (dsh) 插件 — 此 npm 包 @callaiapi/seo。安装后会提供工具和 callai-seo 技能，教 Agent 如何进行关键词研究、竞争对手分析、GEO 检查和审计。
• 远程 MCP 服务 — https://api.callaiapi.com/mcp，适用于 Claude Code、Cursor、VS Code、Cline、Windsurf 和任何其他 MCP 客户端。无需安装。

数据来自 DataForSEO。付费工具按次从你的 CallAI 余额中扣费：最低充值 $1，无订阅，余额永不过期。每条结果都会注明该次调用的费用。七种免费工具只需 API 密钥。任何人都可以不使用密钥查看工具列表。

---

目录

• 1. 获取 API 密钥
• 2. 在 DeepSeek Harness 中安装
• 3. 在其他 MCP 客户端中使用
• 4. 可以询问什么
• 5. 工具参考
• 6. 市场：地区和语言代码
• 7. 定价与成本控制
• 8. 故障排除
• 9. 常见问题

---

1. 获取 API 密钥

1. 在 https://callaiapi.com/register 注册。
2. 充值任意金额，最低 $1（支持银行卡、Apple Pay / Google Pay，或多条链上的 USDT）。
3. 在 API Keys 中创建密钥：https://callaiapi.com/portal?tab=keys。密钥格式类似 sk-live-…。你可以为每个密钥设置消费限额。

2. 在 DeepSeek Harness 中安装

需要 dsh 0.2.0 或更高版本。

dsh plugin --profile web add @callaiapi/seo

如果你使用的是其他配置文件，请将 web 替换为自己的配置文件名称（运行 ls ~/.dsh/profiles 查看）。你也可以从 dsh-plugin-shop 等插件商店安装 @callaiapi/seo。之后重启 dsh——新添加的插件不会加载到正在运行的进程中。

为插件提供密钥

插件按以下顺序查找密钥，并使用找到的第一个密钥：

位置	方法
插件设置 apiKey	在配置文件的 cordis.patch.yml 中设置（见下文），或在 dsh 构建版本提供的插件设置页面中设置
dsh 凭据 CALLAI_API_KEY	通过 dsh 的凭据设置保存，或在 ~/.dsh/.credentials.yaml 的 refs 下保存，或保存到 ~/.dsh/.env（使用凭据服务的配置文件，例如 web）
环境变量 CALLAI_API_KEY	CALLAI_API_KEY=sk-live-… dsh web — 适用于所有配置文件，包括 headless

配置文件补丁，位于 ~/.dsh/profiles/<profile>/cordis.patch.yml：

- id: callai-seo
  config:
    apiKey: sk-live-your-key

.env 文件，位于 ~/.dsh/.env：

CALLAI_API_KEY=sk-live-your-key

通过 dsh 保存凭据后会自动重新连接；修改补丁文件、.env 或环境变量后，需重启 dsh 才会生效。

检查是否正常工作

启动会话并询问 “你有哪些 mcp__callai 工具？” — Agent 应列出 20 种工具；询问 “审计 https://example.com” 后，应返回真实数据和 billed_usd 行。

插件设置

设置	默认值	含义
apiKey	空	你的 CallAI 密钥。留空表示使用 CALLAI_API_KEY 凭据或环境变量
url	https://api.callaiapi.com/mcp	MCP 端点。只有在收到其他端点地址时才更改
toolCallTimeoutMs	120000	单次调用超时时间；深度 SERP 和反向链接调用最长可能需要一分钟

卸载

dsh plugin --profile web remove @callaiapi/seo

3. 在其他 MCP 客户端中使用

设置	值
传输方式	Streamable HTTP
URL	https://api.callaiapi.com/mcp
请求头	Authorization: Bearer sk-live-your-key

Claude Code

claude mcp add --transport http callai https://api.callaiapi.com/mcp \
  --header "Authorization: Bearer sk-live-your-key"

Cursor — 项目中的 .cursor/mcp.json，或 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "callai": {
      "url": "https://api.callaiapi.com/mcp",
      "headers": { "Authorization": "Bearer sk-live-your-key" }
    }
  }
}

VS Code（Copilot Agent 模式） — .vscode/mcp.json：

{
  "inputs": [
    { "type": "promptString", "id": "callai-key", "description": "CallAI API key", "password": true }
  ],
  "servers": {
    "callai": {
      "type": "http",
      "url": "https://api.callaiapi.com/mcp",
      "headers": { "Authorization": "Bearer ${input:callai-key}" }
    }
  }
}

Windsurf、Cline 和其他客户端 — 添加一个远程 / Streamable HTTP 服务，并填写上述 URL 和请求头。仅支持本地（stdio）服务的客户端可以通过 mcp-remote 桥接：

{
  "mcpServers": {
    "callai": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://api.callaiapi.com/mcp", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer sk-live-your-key" }
    }
  }
}

4. 可以询问什么

你无需亲自调用工具，只需描述任务，Agent 就会选择相应的工具。示例：

• “查找英国站立式办公桌相关的长尾关键词，难度低于 30，然后查看排名前三的关键词对应的网站。”
• “比较我的网站 example.com 和竞争对手 competitor.com：流量、对方有排名而我没有的关键词，以及反向链接强度。”
• “Google 是否会针对 ‘best crm for startups’ 显示 AI Overview？其中引用了哪些网站？我的网站是否在其中？”
• “审查 https://example.com/pricing，并给我一份修复清单。”
• “我准备购买过期域名 old-brand.com。检查它的反向链接和垃圾评分。”
• “查询德国、德语环境下这 40 个关键词的搜索量和 CPC：……”

5. 工具参考

在 dsh 中，工具显示为 mcp__callai__<name>；其他客户端显示为 <name>。每个结果都是包含 billed_usd（本次调用的费用）和 result 的 JSON。标有 * 的参数为必填。除反向链接和审查工具外，所有工具也接受 location_code 和 language_code（第 6 节）。

工具	参数	返回内容
google_serp	keyword*、depth 10–100（默认值为 10）、device desktop/mobile	排名结果（标题、URL、域名、摘要）；Google 显示 AI Overview 时，还会返回其文本及引用来源
bing_serp	同 google_serp	Bing 排名结果
keyword_overview	keywords*（最多 100 个）	每个关键词的数据：搜索量、CPC、竞争度、0–100 的关键词难度、主要意图
keyword_ideas	keyword*、limit 1–200（默认值为 50）、max_difficulty 0–100	包含种子词的长尾关键词，按搜索量排序，并附带相同指标
ranked_keywords	target* 域名、limit 1–200（默认值为 50）	该域名有排名的关键词，按预估流量排序：排名位置、排名 URL、指标
domain_overview	target* 域名	预估自然流量、有排名的关键词数量、排名分布、付费搜索总量
keyword_gap	competitor、your_domain、limit 1–200（默认值为 50）	竞争对手有排名而你没有的关键词，按搜索量排序，并附带竞争对手的排名位置和 URL
backlinks_summary	target* 域名	域名评级 0–1000、反向链接、引用域名、nofollow 数量、失效反向链接、垃圾评分、首次发现时间
referring_domains	target* 域名、limit 1–200（默认值为 50）	链接到该域名的域名，按实力从强到弱排序：评级、反向链接、垃圾评分、首次发现时间
page_audit	url*	状态码、标题、元描述、规范 URL、标题层级、字数、链接和图片数量、耗时、页面评分、所有检查结果
dataforseo_request	path*、method POST/GET、body	任何其他 DataForSEO v3 端点 — Google Maps、YouTube、Amazon 关键词、Google Trends、LLM 提及、WHOIS、技术，以及异步 task_post/task_get
domain_check_start	domains*（最多 100 个）、dry_run、rules	开始检查存档历史、百度索引和反向链接。按域名收费，约 $0.02；dry_run 会返回费用但不收费
domain_check_results	check_id*、verdict、limit、after	进度以及每个域名的判定结果、原因和事实。免费读取

免费工具

这些工具需要 API 密钥，但无需充值余额；每个账户每天可在 200 个单位的限额内使用。keyword_suggestions 在 seed 模式下计 1 个单位，在 questions 模式下计 3 个单位，在 az 模式下计 5 个单位；其他工具均计 1 个单位。

工具	参数	返回内容
keyword_suggestions	keyword*、engines、market、mode seed/questions/az	来自 Google、Bing、YouTube、Amazon、Baidu、DuckDuckGo、Yahoo 和 Yandex 的自动补全建议。不提供搜索量
check_robots	url*	robots.txt 的状态和内容
check_sitemap	url*	通过 robots.txt 或 /sitemap.xml 找到的站点地图：状态、URL 数量、示例
page_meta	url*、fetch_as bot/googlebot	状态、最终 URL、标题、描述、canonical、robots、X-Robots-Tag、hreflang、H1，均来自原始 HTML
redirect_chain	url*	每次重定向的状态和目标，最多 5 次
dns_lookup	domain*	A、AAAA、CNAME、MX、NS 和 TXT 记录
email_auth_check	domain*、dkim_selector	MX、SPF、DKIM、DMARC 和 MTA-STS 记录，并附有待修复项目审计

域名可填写为 example.com、www.example.com 或完整 URL。

6. 市场：地区和语言代码

默认市场：美国（location_code 2840），英语（language_code en）。用自然语言告知 Agent 市场（“面向德国，使用德语”），它会设置相应代码。

市场	location_code	常用 language_code
美国	2840	en
英国	2826	en
加拿大	2124	en / fr
澳大利亚	2036	en
德国	2276	de
法国	2250	fr
西班牙	2724	es
意大利	2380	it
巴西	2076	pt
日本	2392	ja
印度	2356	en / hi

完整列表：DataForSEO 地区。

7. 定价和成本控制

调用按 DataForSEO 的费用加上 CallAI 的利润计费；具体金额会显示在每个结果的 billed_usd 中，也会记录在控制台的调用日志中。典型费用：

调用	预估费用
google_serp / bing_serp，10 条结果	$0.0024
keyword_overview，10 个关键词	$0.013
keyword_ideas / ranked_keywords / keyword_gap，50 行	$0.018
domain_overview	$0.015
backlinks_summary	$0.029
referring_domains，50 行	约 $0.03
page_audit	$0.0002

一次完整的关键词研究（构思 → 指标 → 检查五个关键词的 SERP）通常花费远低于 $0.10。

如需让支出可预测：

• 在控制台中为密钥设置支出限额；达到限额后，调用会停止。
• 随附的技能会指示 Agent 批量处理关键词、从较小的限额开始，并在运行费用可能超过约 $0.50 时提前告知。
• 余额用完后，工具会返回 "Insufficient CallAI balance" 和充值链接；被拒绝的调用不会收费。

8. 故障排除

问题	解决方法
dsh 中没有 mcp__callai__ 工具	安装后重启 dsh。检查是否已设置密钥（第 2 节）；没有密钥时，插件会记录 [callai-seo] No API key，且不会添加工具
401 / "Invalid or inactive API key"	使用包含完整 sk-live- 前缀的密钥；检查密钥在控制台中是否处于启用状态
429 "spend limit reached"	提高密钥的支出限额，或使用其他密钥
"Insufficient CallAI balance"	前往 https://callaiapi.com/portal?tab=topup 充值
Task failed (40501): Invalid Field …	参数有误（例如，所选市场不支持该语言）。请让 Agent 使用修正后的值重试
调用超时	降低 depth 或 limit，或提高 toolCallTimeoutMs
dsh 提示插件不兼容	更新 dsh：npm i -g @deepseek-ai/dsh

9. 常见问题

有免费套餐吗？ 没有。新账户余额从 $0 开始，你可以充值，最低 $1；没有订阅，也没有最低月消费额。

数据来自哪里？ 来自 DataForSEO 的实时 SERP、Labs、Backlinks 和 On-Page API。SERP 结果会在调用时实时获取；关键词指标和反向链接索引来自 DataForSEO 的最新数据库。

你们会存储哪些数据？ 为了计费和记录调用日志，我们会存储每次调用的端点、状态、费用和耗时。关键词和域名会发送给 DataForSEO，以处理请求。

我可以不通过 Agent 直接调用 API 吗？ 可以——相同的数据也可通过 REST API 获取，地址为 https://api.callaiapi.com/dataforseo/v3/...，使用 DataForSEO 的请求格式。请参阅 https://callaiapi.com/en/dataforseo。

我已经有 DataForSEO 账户。 那么你可以直接使用 DataForSEO。CallAI 适合希望按需付费、最低充值金额为 $1、无需最低充值额、与大模型 API 共用余额，并使用面向 Agent 的 MCP 服务的人。

链接

• 设置指南：https://callaiapi.com/en/integrations/seo-mcp
• 控制台：https://callaiapi.com/portal
• 问题反馈：https://github.com/hanshengcc/callai-seo-mcp/issues

许可证

MIT