Model Context Protocol (MCP) Servers Collection

Keywords Everywhere MCP Server

一个 Model Context Protocol（MCP）服务，可访问 Keywords Everywhere API，用于 SEO 研究和关键词分析。此服务可让 Claude 等 AI 助手执行关键词研究、分析搜索量、获取竞争数据并访问各种 SEO 指标。

请注意，这不是 Keywords Everywhere 官方的 MCP 服务。

功能

• 关键词数据分析：获取关键词的搜索量、CPC 和竞争数据
• 相关关键词：查找相关关键词和“用户还搜索了”建议
• 域名分析：分析某个域名或 URL 的排名关键词
• 流量指标：获取域名和 URL 的流量估算值及成本
• 反向链接分析：获取域名和网页的反向链接数据
• 账户管理：查看 Keywords Everywhere 账户的积分余额
• 多国家/地区支持：分析不同国家/地区和货币的关键词

快速开始（托管服务）

使用此 MCP 服务最简单的方式是通过托管端点。无需安装！

服务 URL

https://mcp.techmavie.digital/keywords-everywhere/mcp

分析仪表板

https://mcp.techmavie.digital/keywords-everywhere/analytics/dashboard

使用自己的凭据

对于托管客户端，请使用分配给您的用户密钥：

https://mcp.techmavie.digital/keywords-everywhere/mcp/usr_YOUR_USER_KEY

兼容性查询表单：

https://mcp.techmavie.digital/keywords-everywhere/mcp?api_key=usr_YOUR_USER_KEY

对于可自托管/直接模式，请通过请求标头发送原始 Keywords Everywhere API 密钥：X-API-Key: YOUR_API_KEY

兼容的客户端

此服务适用于任何兼容 Streamable HTTP 传输的客户端：

• Claude Desktop/Mobile App
• Claude Code
• Cursor
• VS Code
• Windsurf
• 以及更多客户端

安装（自托管）

如果您希望运行自己的实例：

先决条件

• Node.js 18.0.0 或更高版本
• Keywords Everywhere API 密钥（从 Keywords Everywhere 获取）

NPX（快速开始）

KEYWORDS_EVERYWHERE_API_KEY=your_api_key npx mcp-keywords-everywhere

全局安装

npm install -g mcp-keywords-everywhere

配置

Claude Desktop（托管服务 - 推荐）

只需在 Claude Desktop 的 MCP 设置中添加服务 URL：

https://mcp.techmavie.digital/keywords-everywhere/mcp

如需使用您的托管用户密钥：

https://mcp.techmavie.digital/keywords-everywhere/mcp/usr_YOUR_USER_KEY

Claude Desktop（自托管）

将以下内容添加到 Claude Desktop 配置文件中：

位置：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

配置：

{
  "mcpServers": {
    "keywords-everywhere": {
      "command": "npx",
      "args": ["-y", "mcp-keywords-everywhere"],
      "env": {
        "KEYWORDS_EVERYWHERE_API_KEY": "your_api_key_here"
      }
    }
  }
}

可用工具

账户管理

• get_credits - 查看账户的积分余额
• get_countries - 获取支持的国家/地区列表
• get_currencies - 获取支持的货币列表

关键词研究

• get_keyword_data - 获取关键词的搜索量、CPC 和竞争数据
• get_related_keywords - 根据种子关键词查找相关关键词
• get_pasf_keywords - 获取“用户还搜索了”的关键词

域名分析

• get_domain_keywords - 获取某个域名的排名关键词
• get_url_keywords - 获取某个特定 URL 的排名关键词
• get_domain_traffic - 获取域名的流量指标
• get_url_traffic - 获取 URL 的流量指标

反向链接分析

• get_domain_backlinks - 获取某个域名的反向链接
• get_unique_domain_backlinks - 获取域名的唯一反向链接
• get_page_backlinks - 获取某个特定页面的反向链接
• get_unique_page_backlinks - 获取某个页面的唯一反向链接

使用示例

基本关键词研究

"Get keyword data for 'SEO tools' and 'keyword research' for Malaysia"

域名分析

"What keywords does example.com rank for?"

流量分析

"Get traffic metrics for https://example.com"

反向链接研究

"Show me the top 20 backlinks for example.com"

API 密钥设置

1. 在 Keywords Everywhere 注册
2. 购买 API 访问所需的积分
3. 从仪表板获取 API 密钥
4. 将 API 密钥添加到环境变量或 MCP 配置中

错误处理

此服务包含全面的错误处理机制：

• 身份验证错误：提供清晰的无效 API 密钥提示
• 积分耗尽：积分用完时提供有用的提示
• 速率限制：采用指数退避机制自动重试
• 错误请求：提供详细的错误信息和建议

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

MIT License — 详情请参阅 LICENSE 文件。

支持

• GitHub Issues：报告错误或请求功能
• Keywords Everywhere API：官方文档

开发与部署

前置条件

• 已安装 Node.js 18+
• Keywords Everywhere API 密钥
• Docker（用于 VPS 部署）

项目结构

mcp-keywords-everywhere/
├── index.js              # Main server file
├── package.json          # Dependencies and scripts
├── Dockerfile            # Docker configuration
├── docker-compose.yml    # Docker Compose configuration
├── deploy/               # Deployment files
│   ├── nginx-mcp.conf    # Nginx configuration
│   └── DEPLOYMENT.md     # Deployment guide
└── README.md             # Documentation

本地开发

# Install dependencies
npm install

# Start development server
npm run dev

VPS 部署

此服务通过 Docker 和 Nginx 反向代理部署在 VPS 上。详细的部署说明请参阅 deploy/DEPLOYMENT.md。

# Build and run with Docker
docker compose up -d --build

# Check logs
docker logs mcp-keywords-everywhere -f

GitHub Actions 自动部署

推送到 main 分支会触发通过 GitHub Actions 自动部署到 VPS。

传输支持

此 MCP 服务使用 Streamable HTTP Transport，这是推荐用于生产环境的传输方式。与 STDIO 传输相比，它具有更强的可扩展性、更高的并发能力和更低的延迟。

主要优势

• 无需安装：直接使用托管服务 URL
• 使用自己的 API 密钥：用户可以提供自己的 Keywords Everywhere API 密钥
• 性能更佳：HTTP 传输具有更强的可扩展性和更低的延迟
• 自动部署：推送到 GitHub 后，变更会自动部署

更新日志

1.2.0

• 在 mcp.techmavie.digital 上新增托管服务
• 新增通过 URL 查询参数支持用户提供 API 密钥
• 修复 Claude Desktop 的 MCP 协议合规性问题
• 新增 Docker 和 VPS 部署支持
• 新增 GitHub Actions 自动部署
• 新增带有实时使用统计数据的分析仪表板

1.1.0

• 从 STDIO 迁移到 Streamable HTTP 传输
• 新增对两种传输类型的支持
• 改进会话管理
• 增强错误处理

1.0.0

• 首次发布
• 支持 Keywords Everywhere API 的所有主要端点
• 全面的错误处理和重试逻辑
• 符合 MCP 协议规范
• 跨平台兼容

相关链接

• Model Context Protocol
• Keywords Everywhere
• Claude Desktop