内容
# 关键词无处不在 MCP 服务器
关键词无处不在的模型上下文协议（MCP）服务器，提供对关键词无处不在 API 的访问，用于 SEO 研究和关键词分析。该服务器使 Claude 等 AI 助手能够执行关键词研究、分析搜索量、获取竞争数据和访问各种 SEO 指标。
请注意，这 **不是** 关键词无处不在官方的 MCP 服务器。
## 功能
- **关键词数据分析**：获取关键词的搜索量、每次点击成本（CPC）和竞争数据
- **相关关键词**：查找相关关键词和“人们也在搜索”建议
- **域名分析**：分析域名或 URL 排名的关键词
- **流量指标**：获取域名和 URL 的流量估算和成本
- **反向链接分析**：检索域名和页面的反向链接数据
- **账户管理**：查看关键词无处不在的信用余额
- **多国家支持**：跨不同国家和货币分析关键词
## 快速入门（托管服务器）
使用此 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
```
对于自托管/直接模式，请通过头部发送您的原始关键词无处不在 API 密钥：`X-API-Key: YOUR_API_KEY`
### 兼容客户端
此服务器与任何支持 Streamable HTTP 传输的客户端兼容：
- Claude 桌面/移动应用
- Claude 代码
- Cursor
- VS 代码
- Windsurf
- 还有很多
## 安装（自托管）
如果您更喜欢运行自己的实例：
### 先决条件
- Node.js 18.0.0 或更高版本
- 关键词无处不在 API 密钥（从 [关键词无处不在](https://keywordseverywhere.com/) 获取）
### NPX（快速入门）
```bash
KEYWORDS_EVERYWHERE_API_KEY=your_api_key npx mcp-keywords-everywhere
```
### 全局安装
```bash
npm install -g mcp-keywords-everywhere
```
## 配置
### 对于 Claude 桌面（托管服务器 - 推荐）
只需在 Claude 桌面的 MCP 设置中添加服务器 URL：
```
https://mcp.techmavie.digital/keywords-everywhere/mcp
```
要使用您的托管用户密钥：
```
https://mcp.techmavie.digital/keywords-everywhere/mcp/usr_YOUR_USER_KEY
```
### 对于 Claude 桌面（自托管）
将以下内容添加到您的 Claude 桌面配置文件中：
**位置：**
- **macOS**：`~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows**：`%APPDATA%\Claude\claude_desktop_config.json`
**配置：**
```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` - 获取关键词的搜索量、每次点击成本和竞争数据
- `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` - 获取页面的唯一反向链接
## 使用示例
### 基本关键词研究
```
"获取 'SEO 工具' 和 '关键词研究' 在马来西亚的关键词数据"
```
### 域名分析
```
"example.com 域名排名的关键词是什么？"
```
### 流量分析
```
"获取 https://example.com 的流量指标"
```
### 反向链接研究
```
"显示 example.com 的前 20 个反向链接"
```
## API 密钥设置
1. 在 [关键词无处不在](https://keywordseverywhere.com/) 注册
2. 购买 API 访问信用
3. 从仪表盘获取您的 API 密钥
4. 将 API 密钥添加到您的环境变量或 MCP 配置中
## 错误处理
服务器包含全面的错误处理：
- **身份验证错误**：针对无效 API 密钥的清晰消息
- **信用耗尽**：信用耗尽时的帮助消息
- **速率限制**：具有指数级回退的自动重试
- **错误请求**：具有建议的详细错误消息
## 贡献
欢迎贡献！请随时提交拉取请求。
## 许可证
MIT 许可证 - 有关详细信息，请参见 [LICENSE](LICENSE) 文件。
## 支持
- **GitHub 问题**：[报告错误或请求功能](https://github.com/hithereiamaliff/mcp-keywords-everywhere/issues)
- **关键词无处不在 API**：[官方文档](https://api.keywordseverywhere.com/docs/#/)
## 开发和部署
### 先决条件
- 已安装 Node.js 18+
- 关键词无处不在 API 密钥
- Docker（用于 VPS 部署）
### 项目结构
```
mcp-keywords-everywhere/
├── index.js # 主服务器文件
├── package.json # 依赖和脚本
├── Dockerfile # Docker 配置
├── docker-compose.yml # Docker Compose 配置
├── deploy/ # 部署文件
│ ├── nginx-mcp.conf # Nginx 配置
│ └── DEPLOYMENT.md # 部署指南
└── README.md # 文档
```
### 本地开发
```bash
# 安装依赖
npm install
# 启动开发服务器
npm run dev
```
### VPS 部署
该服务器部署在具有 Docker 和 Nginx 反向代理的 VPS 上。有关详细的部署说明，请参见 [deploy/DEPLOYMENT.md](deploy/DEPLOYMENT.md)。
```bash
# 使用 Docker 构建和运行
docker compose up -d --build
# 查看日志
docker logs mcp-keywords-everywhere -f
```
### GitHub Actions 自动部署
推送到 `main` 分支会通过 GitHub Actions 自动部署到 VPS。
## 传输支持
此 MCP 服务器使用 Streamable HTTP 传输，这是生产环境中推荐的传输，提供比 STDIO 传输更好的可扩展性、并发性和延迟。
## 主要优点
- **无需安装**：直接使用托管服务器 URL
- **自带 API 密钥**：用户可以提供自己的关键词无处不在 API 密钥
- **更好的性能**：HTTP 传输提供更好的可扩展性和延迟
- **自动部署**：推送到 GitHub，变更将自动部署
## 更新日志
### 1.2.0
- 在 mcp.techmavie.digital 上添加托管服务器
- 添加对通过 URL 查询参数提供用户 API 密钥的支持
- 修复 Claude 桌面的 MCP 协议合规性
- 添加 Docker 和 VPS 部署支持
- 添加 GitHub Actions 自动部署
- 添加具有实时使用统计信息的分析仪表盘
### 1.1.0
- 从 STDIO 迁移到 Streamable HTTP 传输
- 添加对两种传输类型的支持
- 改进会话管理
- 增强错误处理
### 1.0.0
- 初始发布
- 支持所有主要的关键词无处不在 API 端点
- 全面的错误处理和重试逻辑
- MCP 协议合规
- 跨平台兼容性
## 相关
- [模型上下文协议](https://modelcontextprotocol.io/)
- [关键词无处不在](https://keywordseverywhere.com/)
- [Claude 桌面](https://claude.ai/)
MCP 市场