SEO分析服务

@adsim/semrush mcp服务器

用于Claude的SEMrush MCP服务器-- 10个工具，40个动作.完全访问Claude Code和Claude Desktop的SEMrush SEO分析。

安装

npm install -g @adsim/semrush-mcp-server

需要Node.js>=18和a SEMrush API密钥.

快速开始

克劳德代码

添加 ~/.claude.json:

{
  "mcpServers": {
    "semrush": {
      "type": "stdio",
      "command": "semrush-mcp-server",
      "env": {
        "SEMRUSH_API_KEY": "your_api_key",
        "SEMRUSH_DEFAULT_DATABASE": "fr"
      }
    }
  }
}

克劳德桌面版

添加 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）：

{
  "mcpServers": {
    "semrush": {
      "command": "semrush-mcp-server",
      "env": {
        "SEMRUSH_API_KEY": "your_api_key",
        "SEMRUSH_DEFAULT_DATABASE": "fr"
      }
    }
  }
}

重新启动客户端。现在有10个工具（40个操作）可用。

工具

每个工具都使用 action 参数以选择分析类型。这种分组设计使上下文窗口保持精简（10个工具定义，而不是40个）。

semrush_domain --域分析（9个操作）

semrush_keyword --关键词研究（8项行动）

semrush_backlinks --反向链接分析（7个动作）

semrush_gap --差距分析（3项行动）

semrush_traffic --流量分析（3个动作）

semrush_recommend --人工智能建议（3项行动）

semrush_tracking --位置跟踪（2个动作）

semrush_audit --现场审核（2项行动）

semrush_credits --账户管理（2项操作）

semrush_enrich_cluster --集群扩展（1个动作）

接受关键字数组并返回具有以下内容的丰富数据：

• 搜索量、CPC、每个关键字的关键字难度
• cluster_score （0-100）和 cluster_grade （A-D）
• opportunity_score 用于优先级排序
• 可选：当前位置 target_domain 提供

环境变量

查询示例

"Give me an overview of nike.com"
"Top organic keywords for lequipe.fr"
"Who ranks for 'credit immobilier' in France?"
"Backlink audit of my-domain.com"
"Quick wins for my-site.com — keywords close to page 1"
"Compare my-site.com vs competitor.com"
"Enrich this cluster: seo, backlinks, netlinking"
"Keyword gap between my-site.com and competitor.com"

内置治理

• 速率限制器 --令牌桶，10请求/秒（可配置）
• 响应缓存 --每个端点类别的差异化TTL（30分钟至24小时）
• 配额管理 --基于行动的成本跟踪的每用户每日预算
• 审计跟踪 --stderr上的JSON日志（工具、端点、参数、状态、持续时间）
• 法文摘要 --法语自动可读分析

支持的数据库

71个区域数据库： us, uk, ca, fr, de, es, it, nl, be, ch, at, dk, no, se, fi, pl, ie, pt, hu, cz, sk, ro, bg, gr, hr, si, lt, lv, ee, cy, mt, rs, ua, jp, in, au, sg, hk, kr, my, ph, th, tw, id, vn, il, tr, za, ng, ke, br, ar, mx, co, cl, pe, ec, ve, bo, py, uy, cr, gt, pa, do, sv, hn, ni, pr, tt, jm

发展

npm run dev           # Watch mode
npm run build         # Build
npm test              # Run tests (71 tests)
npm run test:coverage # Coverage report
npm run release       # Bump version + changelog + tag

技术栈

• TypeScript 5.7（严格）+Zod验证
• @模型上下文协议/sdk ^1.12.0
• 维测试 --6个套件中的71个测试
• 内置Node.js fetch --零外部HTTP依赖
• stdio传输

许可证

麻省理工学院-- 乔治·科德维纳 / 仿真语言

GitHub上的完整文档