前言¶
在 DeepSeek Harness（DSH）里做内容策略、竞品分析或页面优化时，Agent 往往只能凭训练数据「猜」排名、搜索量和外链情况，结论不可靠。CallAI SEO MCP 插件（npm 包 @callaiapi/seo，仓库 hanshengcc/callai-seo-mcp）通过 MCP 把 Google/Bing 实时 SERP、关键词指标、竞品差距、外链与页面体检接到 Agent 工具链上；数据底层来自 DataForSEO，按次从 CallAI 账户余额扣费，每次工具返回里会标明 billed_usd。同一套能力也可直连远程 MCP https://api.callaiapi.com/mcp，本文侧重 DSH 插件安装与用法。
这是什么¶
维护者为 hanshengcc。插件在 DSH 侧注册 MCP 客户端并附带 callai-seo skill，教 Agent 做关键词研究、竞品分析、GEO 相关检查与页面审计。社区目录页：skillhub.cn/plugins/hanshengcc/callai-seo-mcp。分类上属于联网/集成类能力（package 元数据 capabilities 含 mcp-client、skills、tools、credentials）。
核心功能¶
Agent 在 dsh 中可见的工具名为 mcp__callai__<name>，正常配置下共 11 个工具。下面只列资料中已说明的能力摘要。
| 工具 | 作用（概要） |
|---|---|
google_serp / bing_serp |
按关键词取排名结果；Google 结果可含 AI Overview 文本及其引用来源 |
keyword_overview |
批量关键词：搜索量、CPC、竞争度、难度 0–100、主意图等 |
keyword_ideas |
由种子词扩展长尾，可按难度上限过滤 |
ranked_keywords |
某域名在有机搜索中排名的关键词及预估流量 |
domain_overview |
域名有机流量、排名词数量、位置分布、付费搜索概览 |
keyword_gap |
竞品有排名、己方域名没有的关键词差距 |
backlinks_summary / referring_domains |
外链概况、引用域列表（含 spam score 等） |
page_audit |
指定 URL 的 on-page 检查与评分 |
dataforseo_request |
对 DataForSEO API 的通用请求（高级用法） |
除 backlink 与 audit 类工具外，多数工具支持 location_code 与 language_code，用于指定市场与语言（详见仓库 README 第 6 节）。
计费方式：在 callaiapi.com 注册后充值（资料写明最低可从 $1 起），创建 sk-live-… 形式的 API Key；无订阅制，余额不过期，按调用扣费。
安装与启用¶
需要 dsh 0.2.0 或更高版本（package.json 中 engines 为 dsh >= 0.2.0-rc.2）。
1、安装插件（将 web 换成你实际使用的 profile，可用 ls ~/.dsh/profiles 查看）：
dsh plugin --profile web add @callaiapi/seo
也可从 dsh-plugin-shop 等插件商店安装同一 npm 包。安装后需重启 dsh，新插件不会注入已在运行的进程。
2、配置 API Key。插件按下列顺序取第一个有效值：
| 来源 | 说明 |
|---|---|
插件配置 apiKey |
profile 下 cordis.patch.yml，或部分 dsh 构建提供的插件设置页 |
凭证 CALLAI_API_KEY |
dsh 凭证、~/.dsh/.credentials.yaml 的 refs，或 ~/.dsh/.env |
环境变量 CALLAI_API_KEY |
例如 CALLAI_API_KEY=sk-live-… dsh web |
在 ~/.dsh/profiles/<profile>/cordis.patch.yml 中示例：
- id: callai-seo
config:
apiKey: sk-live-your-key
或在 ~/.dsh/.env：
CALLAI_API_KEY=sk-live-your-key
通过 dsh 保存凭证会自动重连；改 patch、.env 或环境变量后需重启 dsh。
3、获取 Key：在 https://callaiapi.com/register 注册，充值后在 https://callaiapi.com/portal?tab=keys 创建 Key，可为单个 Key 设置 spend limit。
4、自检：启动会话后问 Agent「Which mcp__callai tools do you have?」，应列出 11 个工具；再问「Audit https://example.com」应返回真实数据且含 billed_usd。
可选插件配置（默认值见 README）：
| 配置项 | 默认 | 含义 |
|---|---|---|
apiKey |
空 | 为空则走凭证或环境变量 |
url |
https://api.callaiapi.com/mcp |
MCP 端点 |
toolCallTimeoutMs |
120000 |
单次调用超时；深度 SERP/外链可能接近一分钟 |
卸载：
dsh plugin --profile web remove @callaiapi/seo
典型用法¶
不需要手动点选工具名，用自然语言描述任务即可，由 Agent 选工具。README 中的示例可直接复现：
- 「Find long-tail keywords about standing desks for the UK with difficulty under 30, then check who ranks for the top three.」
- 「Compare my site example.com with competitor.com: traffic, the keywords they rank for that I don’t, and backlink strength.」
- 「Does Google show an AI Overview for ‘best crm for startups’? Which sites does it cite, and is mine one of them?」
- 「Audit https://example.com/pricing and give me a fix list.」
- 「I’m about to buy the expired domain old-brand.com. Check its backlinks and spam score.」
- 「Get search volume and CPC for these 40 keywords in Germany, German language: …」
中文场景下同样可用中文提问，只要意图对应上述能力即可。
适用场景与注意¶
适合：在 DSH 里做 SEO/内容调研、竞品关键词差距、AI Overview 引用分析、买域名前查外链与 spam、落地页 on-page 清单等需要实时搜索数据的 Agent 工作流。
注意：
- 插件以当前 dsh 进程的用户权限运行；安装前请自行查看 GitHub 源码 与 MIT 许可证（package.json），确认符合你的安全与合规要求。
- 每次调用消耗 CallAI 余额，深 SERP 或大批量关键词成本会上升；结果中的
billed_usd用于核对单次费用。 - DeepSeek Harness 社区目录（如 SkillHub）为独立站点，与 DeepSeek / 幻方无官方从属关系；插件星标与版本以仓库与 npm 为准（当前 npm 版本 0.1.0）。
结尾¶
CallAI SEO MCP 把「猜 SEO」换成可计费的实时 DataForSEO 数据，并在 DSH 里用 skill 引导 Agent 组合 11 个 MCP 工具。目录页：https://www.skillhub.cn/plugins/hanshengcc/callai-seo-mcp；源码与完整工具参数：https://github.com/hanshengcc/callai-seo-mcp（含 中文 README）。
