DOCS

关键词难度估算 API 与 MCP 文档

通过 HTTP API 或 MCP 调用关键词难度估算能力，把判断接入你的工作流。

简介

关键词难度估算（Keyword Difficulty，KD）服务由上站派 SEO 工具箱提供。它综合分析目标关键词的搜索结果页竞争格局、头部域名权重分布、内容意图与长尾特征，输出 0～100 的难度评分及可操作的竞争建议。你可以通过标准 HTTP API 集成到任何技术栈，也可以通过 MCP（Model Context Protocol）接入 AI 编辑器或 Agent 工作流，让大语言模型在生成内容策略时自动获取关键词难度数据。

HTTP API

端点

GET https://shangzhanpai.com/api/kd?keyword={keyword}&lang={lang}

curl 示例

curl -G "https://shangzhanpai.com/api/kd" \
  --data-urlencode "keyword=chrome extension seo" \
  --data-urlencode "lang=en"

请求参数

参数名	类型	是否必填	说明
keyword	string	必填	目标关键词，URL encode 后传入，长度 1～200 字符
lang	string	选填	语言/地区代码，默认 `zh`，可传 `en`、`ja` 等

响应示例

{
  "keyword": "chrome extension seo",
  "score": 42,
  "difficulty": "medium",
  "avg_dr": 58,
  "reasons": [
    "Top-10 结果中有 6 个 DR > 60 的权威域名",
    "搜索意图混合（信息型 + 商业型），内容差异化空间较大",
    "长尾特征明显，月搜索量约 2,400，竞争压力可控"
  ],
  "backlink_budget": "建议积累 15～30 条 DR > 40 外链"
}

score— 难度评分 0～100（0 极易，100 极难）

difficulty— 等级标签：easy / medium / hard / very_hard

avg_dr— 搜索结果头部 10 个域名的平均 Domain Rating

reasons— 3 条可读的竞争分析说明

backlink_budget— 建议外链数量与质量区间参考

MCP 配置

将以下 JSON 片段添加到你的 MCP 客户端配置文件（如 ~/.cursor/mcp.json 或 Claude Desktop 的 claude_desktop_config.json）中，替换 your_api_key_here 后即可使用。

{
  "mcpServers": {
    "seo-kd": {
      "command": "npx",
      "args": ["-y", "@webcafe/mcp-seo-kd"],
      "env": {
        "WEBCAFE_API_KEY": "your_api_key_here"
      }
    }
  }
}

在 AI Agent 中调用示例

// 在支持 MCP 的 AI 编辑器（如 Cursor、Claude Desktop）中调用：
estimate_keyword_difficulty({
  keyword: "ai writing tool",
  lang: "en"
})

// 工具返回与 HTTP API 相同的 JSON 结构，可直接作为 Prompt 上下文传入 LLM。

MCP Server 暴露单一工具 estimate_keyword_difficulty，接受 keyword 与可选的 lang 参数，返回值与 HTTP API 完全一致，可直接注入 LLM 上下文用于内容策略生成。

获取 API Key

注册上站派 SEO 工具箱账号后，在个人设置页面生成 API Key。免费套餐每日限额 50 次请求；生产场景可升级至无限制付费计划。

← 返回工具箱