Skip to content

seo

Verified

@callaiapi/seo · v0.1.0 · MIT

CallAI for DeepSeek Harness: live SEO data for your agent — Google/Bing SERP with AI Overview sources, keyword volume and difficulty, competitor gaps, backlinks and page audits. Pay as you go.

Install

dsh plugin add @callaiapi/seo

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Creators

Readme

CallAI(青柠AI)—— 给 AI Agent 的实时 SEO 数据

npm license

English

让 Agent 用真实搜索数据说话,而不是凭印象猜:Google / Bing 实时搜索结果(含 Google AI 概览及其引用网站)、关键词搜索量与难度、长尾词挖掘、竞品关键词差距、域名流量、外链和页面 SEO 体检。

两种用法:

  • DeepSeek Harness(dsh)插件:就是这个 npm 包 @callaiapi/seo。装好后 Agent 会获得这些工具,以及一个 callai-seo skill,教它怎么做关键词调研、竞品分析、GEO 检查和页面体检。
  • 远程 MCP 服务器:https://api.callaiapi.com/mcp,可用于 Claude Code、Cursor、VS Code、Cline、Windsurf 等任何 MCP 客户端,无需安装。

数据来自 DataForSEO。按次从你的青柠AI 余额扣费:$1 起充,无月费,余额不过期。每次工具结果都会写明本次花费。


目录


1. 获取 API 密钥

  1. 在 https://callaiapi.com/register 注册。
  2. 充值任意金额($1 起):支持银行卡、Apple Pay / Google Pay,以及多条公链的 USDT。
  3. 在 API 密钥管理 创建密钥:https://callaiapi.com/portal?tab=keys,格式为 sk-live-…。每个密钥都可以单独设置消费上限。

2. 在 DeepSeek Harness 中安装

需要 dsh 0.2.0 或更高版本。

dsh plugin --profile web add @callaiapi/seo

如果你用的不是 web profile,换成自己的名字(ls ~/.dsh/profiles 可以查看)。也可以在 dsh-plugin-shop 等插件商店里搜索 @callaiapi/seo 安装。装完要重启 dsh,正在运行的进程不会加载新插件。

填入密钥

插件按下面的顺序找密钥,用找到的第一个:

位置 怎么设置
插件配置 apiKey 写在 profile 的 cordis.patch.yml 里(见下),或者在 dsh 的插件设置页填写(如果你的 dsh 版本有这个页面)
dsh 凭据 CALLAI_API_KEY 在 dsh 的凭据设置里保存,或写进 ~/.dsh/.credentials.yaml 的 refs,或写进 ~/.dsh/.env(适用于启用了凭据服务的 profile,比如 web)
环境变量 CALLAI_API_KEY CALLAI_API_KEY=sk-live-… dsh web,所有 profile 都可用,包括 headless

profile 补丁文件 ~/.dsh/profiles/<profile>/cordis.patch.yml:

- id: callai-seo
  config:
    apiKey: sk-live-你的密钥

.env 文件 ~/.dsh/.env:

CALLAI_API_KEY=sk-live-你的密钥

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

确认装好了

开一个会话问「你有哪些 mcp__callai 开头的工具?」,应该列出 11 个;再问「帮我体检 https://example.com」,应该返回真实数据和一行 billed_usd。

插件配置项

配置 默认值 含义
apiKey 空 你的青柠AI 密钥。留空则使用 CALLAI_API_KEY 凭据或环境变量
url https://api.callaiapi.com/mcp MCP 地址,没有特别说明不要改
toolCallTimeoutMs 120000 单次调用超时;深度 SERP 和外链查询可能要一分钟

卸载

dsh plugin --profile web remove @callaiapi/seo

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

配置 值
传输方式 Streamable HTTP
地址 https://api.callaiapi.com/mcp
请求头 Authorization: Bearer sk-live-你的密钥

Claude Code

claude mcp add --transport http callai https://api.callaiapi.com/mcp \
  --header "Authorization: Bearer sk-live-你的密钥"

Cursor:项目里的 .cursor/mcp.json,或全局 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "callai": {
      "url": "https://api.callaiapi.com/mcp",
      "headers": { "Authorization": "Bearer sk-live-你的密钥" }
    }
  }
}

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 服务器,填上面的地址和请求头即可。只支持本地(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-你的密钥" }
    }
  }
}

4. 可以这样问

不用自己调工具,把要做的事说清楚,Agent 会自己选工具。例如:

  • 「找英国市场关于升降桌、难度 30 以下的长尾词,再看前三个词谁在排名。」
  • 「对比我的网站 example.com 和竞品 competitor.com:流量、他们有排名而我没有的词、外链强弱。」
  • 「Google 搜 best crm for startups 有没有 AI 概览?引用了哪些网站,有没有我的?」
  • 「体检 https://example.com/pricing,给我一份修改清单。」
  • 「我准备买过期域名 old-brand.com,帮我查外链和垃圾分。」
  • 「查这 40 个词在德国、德语下的搜索量和 CPC:……」

5. 工具说明

在 dsh 里工具名是 mcp__callai__<名称>,其他客户端显示 <名称>。每个结果都是 JSON,包含 billed_usd(本次花费)和 result。带 * 的参数必填。除外链和页面体检工具外,其余工具都接受 location_code 和 language_code(见第 6 节)。

工具 参数 返回
google_serp keyword*、depth 10–100(默认 10)、device desktop/mobile 排名结果(标题、网址、域名、摘要);Google 显示 AI 概览时,附上概览正文和引用来源
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) 该域名有排名的词,按估算流量排序:排名、排名网址、指标
domain_overview target* 域名 估算自然流量、排名词数量、排名分布、付费搜索汇总
keyword_gap competitor、your_domain、limit 1–200(默认 50) 竞品有排名而你没有的词,按搜索量排序,附竞品排名和网址
backlinks_summary target* 域名 域名评分 0–1000、外链数、引用域、nofollow 数、失效外链、垃圾分、首次发现时间
referring_domains target* 域名、limit 1–200(默认 50) 链接到该站的域名,强的在前:评分、外链数、垃圾分、首次发现时间
page_audit url* 状态码、标题、描述、canonical、各级标题、字数、链接与图片数、加载时间、页面得分、全部检查项
dataforseo_request path*、method POST/GET、body 其他任意 DataForSEO v3 接口:Google 地图、YouTube、亚马逊关键词、Google Trends、大模型提及、WHOIS、网站技术栈、异步 task_post/task_get 等

域名可以写成 example.com、www.example.com 或完整网址。

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 成本加青柠AI 服务费计费,准确金额以每次结果里的 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

一次完整的关键词调研(挖词 → 查指标 → 看 5 个词的 SERP)通常远低于 $0.10。

让花费可控:

  • 在控制台给密钥设消费上限,到了就停。
  • 附带的 skill 会让 Agent 批量查词、先用小的 limit,预计超过约 $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. FAQ

有免费额度吗? 没有。新账户余额为 $0,$1 起充,无订阅、无最低月消费。

数据从哪来? DataForSEO 的实时 SERP、Labs、Backlinks 和 On-Page 接口。SERP 在调用时实时抓取;关键词指标和外链来自 DataForSEO 最新的数据库。

你们存什么? 为了计费和给你看调用记录,会保存每次调用的接口、状态、花费和耗时。关键词和域名会发给 DataForSEO 以完成查询。

不用 Agent 能直接调吗? 可以。同样的数据也提供 REST 接口:https://api.callaiapi.com/dataforseo/v3/...,请求格式与 DataForSEO 一致,见 https://callaiapi.com/dataforseo。

我已经有 DataForSEO 账号了。 那可以直接用 DataForSEO。青柠AI 适合想要 $1 起按量付费、不用预存大额、和大模型 API 共用一个余额,并且需要开箱即用 MCP 的用户。

链接

许可证

MIT