Agent 智能体 极速接入指南

SEO MCP Server 自定义 API 配置与直连指南

青柠AI SEO MCP 服务器接入教程:在 DeepSeek Harness (dsh) 安装 @callaiapi/seo 插件,或在 Claude Code、Cursor 等支持 Streamable HTTP 的 MCP 客户端填入地址与 API 密钥,Agent 即可查询 Google/Bing 实时搜索结果与 AI 概览引用源、关键词搜索量与难度、竞品关键词差距、外链和页面体检。数据来自 DataForSEO,按次从余额扣费,$1 起充,无月费。

📋 SEO MCP Server 核心配置参数速查生产验证可用
MCP 地址 (Streamable HTTP)
https://api.callaiapi.com/mcp
请求头控制台「API 密钥管理」生成
Authorization: Bearer sk-live-你的青柠API密钥
dsh 插件包名
@callaiapi/seo

三步图解配置流程

1

创建 API 密钥并充值

登录控制台,在「API 密钥管理」新建密钥,并充值任意金额($1 起)。每次工具调用按 DataForSEO 成本计费,结果里会写明本次花费。

2

DeepSeek Harness:安装插件

在终端安装到你的 profile 后重启 dsh;也可以在插件商店搜索 @callaiapi/seo 一键安装。插件同时附带 callai-seo skill,教 Agent 关键词调研、竞品差距和外链检查的做法。

dsh plugin --profile web add @callaiapi/seo
3

DeepSeek Harness:填入密钥

三选一:写进 ~/.dsh/.env(web 等启用了凭据服务的 profile);在 profile 的 cordis.patch.yml 里给 callai-seo 配置 apiKey;或启动时设置环境变量 CALLAI_API_KEY(所有 profile 通用)。完整说明见 GitHub 仓库 hanshengcc/callai-seo-mcp 的 README。

# ~/.dsh/.env
CALLAI_API_KEY=sk-live-你的青柠API密钥

# 或 ~/.dsh/profiles/web/cordis.patch.yml
- id: callai-seo
  config:
    apiKey: sk-live-你的青柠API密钥
4

Claude Code:一行命令添加

其他支持远程 MCP 的客户端同理:地址填 https://api.callaiapi.com/mcp,请求头带上 Authorization。

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

Cursor:写入 mcp.json

在项目的 .cursor/mcp.json(或全局 ~/.cursor/mcp.json)加入以下配置后重启 Cursor。

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

直接提问

可用工具:google_serp、bing_serp、keyword_overview、keyword_ideas、ranked_keywords、domain_overview、keyword_gap、backlinks_summary、referring_domains、page_audit,以及调用任意 DataForSEO v3 接口的 dataforseo_request。例如:「找英国市场关于升降桌、难度 30 以下的长尾词,并看前三个词谁在排名。」

常见报错排查 (Troubleshooting)

❌ 现象:工具返回 Insufficient CallAI balance
💡 解决方案:余额不足,到控制台充值后重试;已发出的请求不会重复扣费。
❌ 现象:连接失败或 401
💡 解决方案:确认请求头是 Authorization: Bearer 加完整密钥,密钥在控制台处于启用状态,且未达到该密钥的消费上限。
❌ 现象:dsh 里看不到 mcp__callai__ 开头的工具
💡 解决方案:安装后需要重启 dsh。没找到密钥时插件会打印 [callai-seo] No API key 并且不添加工具;设置好密钥后重启 dsh(通过 dsh 凭据设置保存的会自动重连)。
配置后接口连不通?
使用站内 HTTP 状态码诊断工具,快速测试 API 连通性并排查 403 / 401 报错。
打开状态码诊断器 →