内容
# creator-seo-mcp
[](https://github.com/Yoshyaes/creator-seo-mcp/actions/workflows/ci.yml)
为内容创作者提供的 MCP 服务器，连接 Google 搜索控制台到您的页面内容，并根据预估收入而非虚名点击量对每个 SEO 机会进行排名。
通用 SEO 工具显示原始 GSC 数据。而该工具根据您的实际展示广告 RPM 和联盟佣金率，告诉您哪项修复能带来最多收益。
## 功能
六种工具，设计用于在完整的创作者 SEO 工作流程中协同工作：
| 工具 | 描述 |
|---|---|
| `get_striking_distance_keywords` | 查询排名在 4-15 位且具有实际印象量的关键词、排名页面以及与第一页的差距 |
| `get_page_performance` | 一个 URL 的完整 GSC 数据：点击量、印象量、点击率、排名以及驱动它的查询 |
| `analyze_content_decay` | 标记每月点击量或印象量下降的页面 |
| `audit_page_onpage` | 获取一个 URL，读取标题/元数据/标题/正文，与目标查询进行比较，并提出具体修改建议 |
| `find_cannibalization` | 检测多个页面竞争相同搜索词的情况，分割权限 |
| `get_top_opportunities` | 主要调用：结合所有信号，按收入加权，返回单个排名的操作列表 |
## 安装
```bash
uvx creator-seo-mcp
```
或使用 pip：
```bash
pip install creator-seo-mcp
```
## 设置
### 1. Google 搜索控制台凭证
按照 [docs/gsc-setup.md](docs/gsc-setup.md) 的说明：
- 在 Google Cloud 中启用搜索控制台 API
- 创建 OAuth 2.0 桌面客户端
- 下载 `credentials.json`
### 2. Claude 桌面配置
将以下内容添加到您的 `claude_desktop_config.json` 中：
```json
{
"mcpServers": {
"creator-seo-mcp": {
"command": "uvx",
"args": ["creator-seo-mcp"],
"env": {
"GOOGLE_CREDENTIALS_PATH": "/path/to/credentials.json",
"CREATOR_SEO_SITE_RPM": "15"
}
}
}
}
```
### 3. Claude 代码配置
```bash
claude mcp add creator-seo-mcp uvx creator-seo-mcp \
-e GOOGLE_CREDENTIALS_PATH=/path/to/credentials.json \
-e CREATOR_SEO_SITE_RPM=15
```
### 4. 收入配置（可选但推荐）
设置您的展示广告 RPM，以便机会按实际美元排名：
```bash
export CREATOR_SEO_SITE_RPM=22 # 您的 Mediavine/Raptive RPM
export CREATOR_SEO_AFFILIATE_CATEGORIES='{"gaming-deals": 2.0}'
```
参见 `.env.example` 获取所有选项。
## 示例代理提示
- "显示我本周按收入加权的前五项 SEO 机会。"
- "哪些帖子的流量比上个月减少了？"
- "我的《博德之门 3》攻略被卡在第 2 页。审核它与主要关键词的差距，并告诉我需要修复什么。"
- "查找任何相互竞争相同搜索词的帖子。"
- "这篇文章与它试图排名的查询之间的页面差距是什么？"
## Two Average Gamers 案例研究
*在 dogfood 阶段后将添加前后数据。*
## 贡献
欢迎提出问题和 PR。请参阅 [CONTRIBUTING.md](CONTRIBUTING.md) 获取指南。
## 许可证
MIT
<!-- mcp-name: io.github.Yoshyaes/creator-seo-mcp -->
