AI导哈

Semrush数据分析工具

一个社区维护的自托管工具，提供Semrush API数据，支持通过MCP服务器和CLI进行关键词研究、域名分析、反向链接和竞争情报分析。

  • by mrkooblu
  • TypeScript
  • 本地部署
  • 39 星标
  • 更新于
在 GitHub 查看 mrkooblu/semrush-mcp

使用说明

Semrush MCP

MCP服务器和CLI，用于关键字研究、域分析、反向链接、流量分析和竞争情报。

一个社区维护的自托管工具，通过两个入口点提供Semrush API数据： MCP服务器 适用于Claude Desktop和Cursor等人工智能助手，以及 semrush 命令行界面 用于直接终端使用——非常适合开发人员和人工智能编码代理，如Claude Code，可以代表您运行shell命令。一次安装可以同时提供这两种功能。

快速开始

npm install -g github:mrkooblu/semrush-mcp
export SEMRUSH_API_KEY=your_api_key_here

安装后，您有两个命令：

  • semrush --用于终端和代理的CLI
  • semrush-mcp --用于AI客户端的stdio上的MCP服务器

CLI：

semrush domain semrush.com           # Domain overview
semrush kw "seo tools"               # Keyword overview
semrush backlinks semrush.com        # Backlink analysis

MCP服务器 （添加到您的AI客户端配置中）：

{
  "mcpServers": {
    "semrush-mcp": {
      "command": "npx",
      "args": ["-y", "github:mrkooblu/semrush-mcp"],
      "env": {
        "SEMRUSH_API_KEY": "your-api-key"
      }
    }
  }
}

特性

  • 域名分析 --概述、排名跟踪、排名历史、有机/付费关键字、竞争对手、广告历史、购物、独特页面
  • URL分析 --有机/付费关键字、排名、每个URL的排名历史
  • 子域分析 --排名、排名历史、每个子域的有机关键字
  • 子文件夹分析 --有机/付费关键字、排名、排名历史、每个子文件夹的唯一页面
  • 关键词研究 --概述、相关关键词、广泛匹配、问题、SERP有机/付费结果、广告历史、难度
  • 反向链接分析 --反向链接、引用域名、概述、页面、锚点、TLD分布、类别
  • 流量分析 --摘要、来源、目的地、地理位置、子域、子文件夹、首页、排名、社交媒体（需要。趋势）
  • 受众智能 --受众洞察、人口统计、购买转化率、兴趣（需要。趋势）
  • API项目 --列出、创建、更新、删除项目
  • 现场审核 --审计信息、快照、问题、页面、历史记录、启动爬网
  • 关键词差距分析 --并排比较两个域的关键字配置文件（仅限CLI）
  • API单位余额 -检查剩余API信用

所有功能都可以通过MCP服务器（77个工具）和CLI获得。

安装

从GitHub全局安装

npm install -g github:mrkooblu/semrush-mcp

或者克隆并本地链接

git clone https://github.com/mrkooblu/semrush-mcp.git
cd semrush-mcp
npm install && npm run build && npm link

在环境或 .env 文件：

export SEMRUSH_API_KEY=your_api_key_here

MCP设置

克劳德桌面版

增添 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：

{
  "mcpServers": {
    "semrush-mcp": {
      "command": "npx",
      "args": ["-y", "github:mrkooblu/semrush-mcp"],
      "env": {
        "SEMRUSH_API_KEY": "your-api-key"
      }
    }
  }
}

光标

  1. 前往“设置”>“MCP服务器”>“添加服务器”
  2. 配置：
    • 名字: Semrush MCP
    • 类型: command
    • 命令: node
    • 参数: /path/to/semrush-mcp/dist/index.js
    • 环境变量: SEMRUSH_API_KEY=your_api_key

其他MCP客户端

任何兼容MCP的客户端都可以使用stdio传输进行连接。指向 semrush-mcp 或 node dist/index.js 随着 SEMRUSH_API_KEY 环境变量集。

CLI使用情况

这 semrush CLI是为人类使用和人工智能编码代理（如Claude Code）构建的，可以直接调用shell命令。所有命令支持 -d, --database <db> （国家代码，默认值： us), -l, --limit <n>，以及 -f, --format <text|json>.

快速概览

自动检测关键字与域：

semrush q "seo tools"              # Keyword overview
semrush q example.com              # Domain overview

域名分析

semrush domain semrush.com                    # Domain overview
semrush d example.com --organic -l 30         # Organic keywords
semrush d example.com --paid -l 20            # Paid keywords
semrush d example.com --competitors -l 10     # Competitors

关键词研究

semrush kw "content marketing"                # Basic overview
semrush kw "seo" --related -l 20              # Related keywords
semrush kw "marketing" --questions -l 10      # Question-based keywords
semrush kw "email marketing" --broad -l 15    # Broad match keywords
semrush kw "seo tools" --organic -l 10        # SERP organic results
semrush kw "ppc software" --paid -l 10        # SERP paid results

关键词难度

semrush kd "seo" "content marketing" "link building"

反向链接

semrush bl example.com                        # Backlink overview
semrush bl example.com --domains -l 20        # Referring domains

流量分析

要求。趋势API订阅。

semrush traffic example.com                   # Traffic summary
semrush traffic example.com --sources         # Traffic sources

关键词差距分析

semrush gaps mysite.com competitor.com -l 50

API单位余额

semrush units

可用的MCP工具

领域分析（13个工具）

工具 说明
semrush_domain_overview 域名概述——所有数据库的流量、关键字、排名
semrush_domain_rank 特定数据库中的域名排名
semrush_domain_rank_history 域的历史排名数据
semrush_rank_difference 排名变化最大的域名
semrush_domain_organic_keywords 域名的有机关键字
semrush_domain_paid_keywords 域名的付费关键字
semrush_competitors 有机搜索竞争对手
semrush_paid_competitors 付费搜索竞争对手
semrush_domain_ads_history 域名随时间变化的广告历史
semrush_domain_organic_unique 域的独特有机页面
semrush_domain_adwords_unique 域的唯一付费广告页面
semrush_domain_shopping 域名的购物/PLA关键字
semrush_domain_shopping_unique 独特的购物广告页面

URL分析（5个工具）

工具 说明
semrush_url_organic 特定URL的有机关键字
semrush_url_adwords 特定URL的付费关键字
semrush_url_rank 特定URL的排名数据
semrush_url_rank_history URL的历史排名数据
semrush_url_ranks URL在所有数据库中的排名

子域分析（4个工具）

工具 说明
semrush_subdomain_rank 子域的排名数据
semrush_subdomain_ranks 子域在所有数据库中的排名
semrush_subdomain_rank_history 子域的历史排名数据
semrush_subdomain_organic 子域的有机关键字

子文件夹分析（7个工具）

工具 说明
semrush_subfolder_organic 子文件夹的有机关键字
semrush_subfolder_adwords 子文件夹的付费关键字
semrush_subfolder_rank 子文件夹的排名数据
semrush_subfolder_ranks 子文件夹在所有数据库中的排名
semrush_subfolder_rank_history 子文件夹的历史排名数据
semrush_subfolder_organic_unique 子文件夹中的独特有机页面
semrush_subfolder_adwords_unique 子文件夹中的唯一付费广告页面

反向链接（7工具）

工具 说明
semrush_backlinks 域名/URL的反向链接
semrush_backlinks_domains 引用域名
semrush_backlinks_overview 反向链接摘要统计数据
semrush_backlinks_pages 反向链接最多的页面
semrush_backlinks_anchors 锚文本分布
semrush_backlinks_tld 反向链接的TLD分布
semrush_backlinks_categories 反向链接的类别分布

关键词研究（10个工具）

工具 说明
semrush_keyword_overview 所有数据库的关键字概述
semrush_keyword_overview_single_db 特定数据库的详细关键字数据
semrush_batch_keyword_overview 一次最多分析100个关键字
semrush_related_keywords 相关关键字发现
semrush_broad_match_keywords 广泛匹配/备选查询
semrush_phrase_questions 基于问题的关键字
semrush_keyword_organic_results 域名在自然结果中排名
semrush_keyword_paid_results 付费搜索结果中的域名
semrush_keyword_ads_history 12个月的域名竞价历史
semrush_keyword_difficulty 排名前十的难度指数

流量和受众（17个工具，需要订阅.Trends）

工具 说明
semrush_traffic_summary 域的流量摘要
semrush_traffic_sources 流量来源细分
semrush_traffic_destinations 参观后交通会去哪里
semrush_traffic_geo 交通地理分布
semrush_traffic_subdomains 按子域划分的流量
semrush_traffic_subfolders 按子文件夹划分的流量
semrush_traffic_top_pages 最高流量页面
semrush_traffic_rank 随时间变化的交通排名
semrush_traffic_social_media 社交媒体流量细分
semrush_audience_insights 域之间的受众重叠
semrush_purchase_conversion 购买转化指标
semrush_household_distribution 家庭人口统计数据
semrush_income_distribution 收入人口统计
semrush_education_distribution 教育水平人口统计
semrush_occupation_distribution 职业人口统计
semrush_audience_interests 观众兴趣类别
semrush_traffic_accuracy 交通数据准确性估计

项目和现场审计（13个工具）

工具 说明
semrush_list_projects 列出所有项目
semrush_get_project 获取项目详细信息
semrush_create_project 创建新项目
semrush_update_project 更新项目设置
semrush_delete_project 删除项目
semrush_site_audit_info 现场审核配置和状态
semrush_site_audit_snapshots 列出审核快照
semrush_site_audit_snapshot_detail 获取快照详细信息
semrush_site_audit_issues 审计问题元数据
semrush_site_audit_pages 列出已审核的页面
semrush_site_audit_page_detail 页面级审核详细信息
semrush_site_audit_history 审计历史
semrush_site_audit_launch 启动新的审核爬网

实用工具（1个工具）

工具 说明
semrush_api_units_balance 检查API单位余额

仅CLI命令

CLI命令 说明
semrush gaps <d1> <d2> 两个域之间的关键字差距分析

配置

需要 SEMRUSH_API_KEY 在环境或 .env 文件。

变量 默认值 描述
SEMRUSH_API_KEY （必需） 您的Semrush API密钥
API_CACHE_TTL_SECONDS 300 API响应的缓存TTL
API_RATE_LIMIT_PER_SECOND 10 每秒最大API请求数
NODE_ENV 开发 环境模式
LOG_LEVEL info 日志记录级别

API单位消耗量

API请求使用您的Semrush帐户中的单位。不同的报告有不同的成本：

工具 每行API单位
semrush_keyword_overview 10
semrush_keyword_overview_single_db 10
semrush_batch_keyword_overview 10
semrush_keyword_organic_results 10
semrush_keyword_paid_results 20
semrush_broad_match_keywords 20
semrush_related_keywords 40
semrush_phrase_questions 40
semrush_keyword_difficulty 50
semrush_keyword_ads_history 100

随时通过以下方式检查您的余额 semrush units 或 semrush_api_units_balance MCP工具。

发展

git clone https://github.com/mrkooblu/semrush-mcp.git
cd semrush-mcp
npm install
cp .env.example .env   # add your SEMRUSH_API_KEY

npm run dev              # MCP server in dev mode (tsx, hot reload)
npm run build            # Compile TypeScript to dist/
npm test                 # Run all tests
npm run test:unit        # Unit tests only (no API key needed)
npm run test:integration # Integration tests (requires SEMRUSH_API_KEY)
npm run lint             # ESLint
npm run format           # Prettier

Git挂钩

此项目使用 哈士奇 对于git钩子：

  • 预承诺：lint stage、ESLint、TypeScript类型检查、单元测试、秘密检测
  • 预推：未提交的更改检查、完整构建、集成测试（需要 SEMRUSH_API_KEY)

为什么选择自助主机？

此自托管工具适用于需要更多控制权的用户：

  • 对API调用和缓存的完全控制 --配置TTL，检查原始响应
  • 自定义费率限制 --设置自己的每秒请求数限制
  • 自托管/气隙式 --完全在您的计算机上运行，没有外部MCP端点
  • 代理的CLI --AI编码代理可以调用 semrush 直接无需MCP
  • 开源 --麻省理工学院授权，根据您的需求进行分叉和定制

安全

  • 永远不要公开共享您的Semrush API密钥
  • API密钥提供对API单位余额的访问
  • 暴露凭据可能会导致未经授权使用API并产生意外费用

托管替代方案

Semrush还提供 官方托管的MCP连接器 在 https://mcp.semrush.com/v1/mcp --无需设置，请使用您的Semrush帐户进行身份验证。看 MCP入门 了解详情。

这是一个个人项目，不是Semrush的官方产品。

许可证

麻省理工学院

相关 MCP