内容
<img src="https://capsule-render.vercel.app/api?type=waving&color=0:1a1a1d,50:c08a52,100:1a1a1d&height=200§ion=header&text=MCP%20%E6%9C%8D%E5%8A%A1%E5%99%A8&fontSize=52&fontColor=f5f1e8&fontAlignY=38&desc=%E4%BF%84%E7%BD%97%E6%96%AF%E5%B8%82%E5%9C%BA%E8%90%A5%E9%94%80%20%26%20%E8%BF%90%E8%90%A5%E5%B7%A5%E5%85%B7%E5%90%88%E9%94%81%20%E9%85%8A%E5%8A%A8%20%2F%20%E9%A1%B5%E9%9D%A2%E9%A1%B5%20%2F%20%E9%A3%8E%E6%B5%B7%E6%B8%9C&descSize=14&descAlignY=62" alt="MCP Servers" />
<div align="center">
<p>
<a href="https://github.com/SergeyKrin9/mcp-servers/stargazers"><img src="https://img.shields.io/github/stars/SergeyKrin9/mcp-servers?style=for-the-badge&color=c08a52&logo=github&labelColor=1a1a1d"></a>
<a href="https://github.com/SergeyKrin9/mcp-servers/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-c08a52?style=for-the-badge&labelColor=1a1a1d"></a>
<img src="https://img.shields.io/badge/Python-3.10%2B-c08a52?style=for-the-badge&logo=python&logoColor=white&labelColor=1a1a1d">
<img src="https://img.shields.io/badge/MCP-protocol-FF6B35?style=for-the-badge&logo=anthropic&logoColor=white&labelColor=1a1a1d">
</p>
<sub>🐍 Python · 🇷🇺 俄罗斯市场 · 🎖️ 唯一统一的俄罗斯市场MCP捆绑包 · 🤖 7个服务器</sub>
</div>
> [!IMPORTANT]
> **唯一适用于俄罗斯市场平台的统一MCP工具包。** 包括 Yandex.Direct、Yandex.Webmaster、Yandex.Metrika（通过 energyboost）、Google 搜索控制台、YouTube、VK、Telegram、Click.ru。 在 `awesome-mcp-servers` 中没有等效的工具包。 如果您为俄罗斯受众进行SEO/SMM/PPC并使用Claude — 这是您缺少的工具包。
一组 **7个自定义模型上下文协议（MCP）服务器**，用于将营销平台连接到LLM代理循环。 构建后，代理（Claude Code、Claude Desktop、Cursor、Windsurf）可以直接运行广告活动、读取分析数据、发布帖子并检查SEO健康状况 — 而无需人类点击按钮。
如果您不知道MCP是什么，[请从这里开始](https://modelcontextprotocol.io/) — 它是Anthropic的开放协议，用于将工具插入LLM应用程序。
## 内容
| 服务器 | 向代理公开的内容 |
|---|---|
| [`clickru/`](./clickru/) | Click.ru API — Telegram Ads、VK Ads、Yandex.Direct广告活动、余额、报告、竞价管理 |
| [`yadirect/`](./yadirect/) | Yandex.Direct — 创建/暂停广告活动、管理关键词、竞价、广告文案 |
| [`yandex-webmaster/`](./yandex-webmaster/) | Yandex.Webmaster — 索引、热门查询、站点地图、重新爬取、问题检测 |
| [`gsc/`](./gsc/) | Google 搜索控制台 — 热门查询、页面、国家/地区分布、索引状态 |
| [`youtube/`](./youtube/) | YouTube 数据 API — 视频、频道、评论、转录、趋势 |
| [`vk/`](./vk/) | VK 墙 API — 发布、编辑、固定帖子、上传照片、统计数据 |
| [`edaru-telegram/`](./edaru-telegram/) | Telegram 机器人 API — 在配置的频道中发布/编辑/删除/固定帖子 |
它们共同覆盖了 **典型的俄罗斯市场产品完整增长栈**：付费广告（Direct + Telegram Ads + VK Ads via Click.ru）、有机搜索（Yandex Webmaster + GSC）和内容分发（VK + Telegram）。
## 为什么这很重要
2026年，增长的瓶颈不再是“该做什么” — 代理可以计划。 **人工智能计划和平台API之间的粘合剂**才是关键。 这些服务器就是这种粘合剂。
LLM代理现在可以运行的典型工作流程：
1. `gsc.get_top_queries('edaru.su')` → 查看哪些关键词正在上升
2. `yandex-webmaster.get_top_queries('edaru.su')` → 在Yandex上进行交叉检查
3. `yadirect.get_keywords('campaign_id=...')` → 查看已经竞价的关键词
4. 确定要添加的新关键词 → `yadirect.add_negative_keywords(...)`，调整竞价
5. `vk.post_to_wall(...)` 和 `edaru-telegram.publish_post(...)` 以推送新鲜内容
6. 第二天：`clickru.get_campaign_stats(...)` 查看效果
所有这一切，无需营销人员触摸控制台。
## ⚡ 快速入门（3步）
**1. 克隆并安装：**
```bash
git clone https://github.com/SergeyKrin9/mcp-servers.git
cd mcp-servers/yadirect # 或其他任何服务器
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt # 如果存在
cp .env.example .env # 填写您的凭证
```
**2. 连接到您的AI主机：**
<details>
<summary><strong>Claude Desktop / Claude Code</strong> (<code>~/Library/Application Support/Claude/claude_desktop_config.json</code>)</summary>
```json
{
"mcpServers": {
"yandex-direct": {
"command": "/abs/path/to/mcp-servers/yadirect/.venv/bin/python3",
"args": ["/abs/path/to/mcp-servers/yadirect/server.py"],
"env": { "YANDEX_DIRECT_TOKEN": "your-token" }
}
}
}
```
</details>
<details>
<summary><strong>Cursor</strong> (<code>~/.cursor/mcp.json</code>) — 相同的JSON结构</summary>
```json
{
"mcpServers": {
"vk": {
"command": "/abs/path/to/.venv/bin/python3",
"args": ["/abs/path/to/mcp-servers/vk/server.py"],
"env": { "VK_TOKEN": "your-token", "VK_GROUP_ID": "123456" }
}
}
}
```
</details>
<details>
<summary><strong>Windsurf</strong> （设置 → MCP 服务器 → 添加）— 相同的JSON结构</summary>
配置相同 — Windsurf 使用相同的MCP服务器格式。
</details>
**3. 测试循环。** 打开一个新的Claude聊天窗口并询问：
> *"显示edaru.su在过去7天内来自Google搜索控制台的前5个搜索查询，然后在Yandex.Webmaster中检查相同的内容，然后将匹配的关键词队列添加到我的Yandex.Direct广告活动中。"*
如果一切连接正确，Claude将在一个工具循环中运行 `gsc.get_top_queries → yandex-webmaster.get_top_queries → yadirect.add_keywords` — 无需您打开任何仪表盘。
## 需要的凭证
| 服务器 | 需要获取的内容 |
|---|---|
| `clickru` | Click.ru API密钥 + 账户ID（在Click.ru仪表盘中） |
| `yadirect` | 通过 [oauth.yandex.ru](https://oauth.yandex.ru) 获取的Yandex.Direct OAuth令牌 |
| `yandex-webmaster` | 与Direct相同的OAuth流程，包含 `webmaster:hostinfo,webmaster:verify` 作用域 |
| `gsc` | 具有搜索控制台访问权限的Google服务账户JSON密钥 |
| `youtube` | YouTube 数据 API v3 密钥（Google Cloud Console） |
| `vk` | VK群组访问令牌（管理员权限） |
| `edaru-telegram` | Telegram机器人令牌（BotFather）+ 聊天ID |
`yandex-webmaster/oauth_helper.py` 包含一个有效的OAuth流程，如果您想在本地获取令牌。
## 技术栈
- Python 3.10+ · 标准库 + `requests`
- `mcp` Python SDK
- 每个平台一个进程 — 容易独立启用/禁用
## 路线图
- Telegram Ads MCP（独立于Click.ru，原生API）
- Plausible / Yandex.Metrika 实时MCP（目前仅限报告）
- 一次性CLI包装器，您可以直接调用其中任何一个而无需MCP主机
---
## ⭐ 星级历史
<a href="https://www.star-history.com/#SergeyKrin9/mcp-servers&Date">
<img src="https://api.star-history.com/svg?repos=SergeyKrin9/mcp-servers&type=Date" alt="Star History" />
</a>
## 📚 相关工作
- **[agnis-workflow](https://github.com/SergeyKrin9/agnis-workflow)** — 使用这些MCP服务器作为一流工具的方法论
- **[broker-reels](https://github.com/SergeyKrin9/broker-reels)** — 生产应用：房地产营销的AI文本转视频
- **[awesome-mcp-servers](https://github.com/punkpeye/awesome-mcp-servers)** — 规范的MCP目录（尚未包含俄罗斯市场条目 — 欢迎PR）
---
<div align="center">
**作者：** [谢尔盖·克里尼齐恩](https://putksebe.su/cv) · sergeykrin98@gmail.com · [GitHub](https://github.com/SergeyKrin9)
<sub>如果您面向俄罗斯受众并使用Claude — 请给予一个⭐。这会告诉我继续添加服务器。</sub>
</div>
