Semrush

mcp-semrush

Semrush MCP 工具包 — 通过 Semrush Analytics API 进行 SEO 分析。

属于 Pipeworx — 一个将 AI Agent 连接到 1683+ 个实时数据源的 MCP 网关。

工具

工具	描述
domain_overview	域名概览（Semrush type=domain_ranks）：域名的高层级 SEO/PPC 摘要。返回经过解析的行，包含以下列：Db（数据库）、Dn（域名）、Rk（Semrush 排名）、Or（自然关键词数量）、Ot（自然流量）、Oc（自然流量成本）、Ad（AdWords/付费关键词数量）、At（付费流量）、Ac（付费流量成本）。会消耗你的 Semrush API 配额。
domain_organic_keywords	域名排名靠前的自然搜索关键词（Semrush type=domain_organic）。返回经过解析的行，包含以下列：Ph（关键词词组）、Po（当前位置）、Pp（之前的位置）、Nq（搜索量）、Cp（CPC）、Ur（排名 URL）、Tr（流量百分比）、Co（竞争度）、Nr（结果数量）。会消耗你的 Semrush API 配额。
domain_paid_keywords	域名竞价的付费（AdWords/PPC）关键词（Semrush type=domain_adwords）。返回经过解析的行，包含以下列：Ph（关键词词组）、Po（广告位置）、Nq（搜索量）、Cp（CPC）、Ur（落地页 URL）、Tg（流量）、Tc（流量成本）、Co（竞争度）、Nr（结果数量）。会消耗你的 Semrush API 配额。
keyword_overview	关键词概览（Semrush type=phrase_this）：单个关键词词组的搜索指标。返回经过解析的行，包含以下列：Ph（词组）、Nq（搜索量）、Cp（CPC）、Co（竞争度，范围为 0-1）、Nr（自然搜索结果数量）、Td（趋势，过去 12 个月的数据以 |- 分隔）。会消耗你的 Semrush API 配额。
backlinks_overview	域名或 URL 的反向链接摘要（Semrush type=backlinks_overview）。返回经过解析的行，包含以下列：target、target_type、total（反向链接总数）、domains_num（引用域名数）、urls_num（引用 URL 数）、ips_num（引用 IP 数）、follows_num（dofollow 数量）、nofollows_num、texts_num、images_num、score（权威评分）。注意：反向链接报告不按地区区分——没有 database 参数。会消耗你的 Semrush API 配额。
organic_competitors	域名的自然搜索竞争对手（Semrush type=domain_organic_organic）。返回经过解析的行，包含以下列：Dn（竞争对手域名）、Cr（竞争程度）、Np（共同关键词）、Or（竞争对手的自然关键词）、Ot（竞争对手的自然流量）、Oc（自然流量成本）。会消耗你的 Semrush API 配额。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "semrush": {
      "url": "https://gateway.pipeworx.io/semrush/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/semrush/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 共享的元工具——ask_pipeworx、 discover_tools、search_within、remember/recall，以及网关全局工具集中的其他工具。因此，你看到的工具数量会多于此表所列：单个工具包端点目前会列出大约 30 个共享工具，此外还有该工具包自身的工具。连接的 initialize 响应会说明其确切范围，并且是当天最权威的信息。

这是有意为之，并非意外的多路复用。元工具可以让限定范围的连接通过 ask_pipeworx 跨整个目录进行路由，从而回答此工具包未涵盖的问题，而无需添加第二个 MCP 服务。目前无法挂载不含这些元工具的工具包端点；如果额外的架构定义占用的上下文超过了路由带来的价值，请连接一次完整网关，而不是连接多个工具包端点。

或者，连接完整的 Pipeworx 网关，直接获取所有工具包列出的工具，而不只是此工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都连接到同一个网关和同一组 1683+ 个数据源。唯一的区别是直接列出哪个工具包的工具；无论通过哪个 URL，ask_pipeworx 都可以访问所有工具包。

没有 MCP 客户端？通过 HTTP 调用

此工具包需要你自己的 API 密钥（_apiKey）——我们不会为它提供密钥，因此这里没有无需密钥即可运行的 curl 命令。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/domain_overview。查找工具包：POST https://gateway.pipeworx.io/v1/tools/search_packs，并传入 {"query":"..."}。

独立运行（无需网关账户）

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需往返网关：

{
  "mcpServers": {
    "semrush": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-semrush"]
    }
  }
}

也可以直接运行，确认它能够启动：

npx -y @pipeworx/mcp-semrush

它通过 stdin/stdout 使用 MCP 通信，并响应 initialize/tools/list/tools/call，仅提供此工具包的工具——不包括上述网关连接额外提供的任何共享元工具。源码相同，工具相同，不经过 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用通俗的英语提问，而不是直接调用工具——此方式既适用于上面的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Semrush data" })

网关会选择合适的工具，并自动填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT