关于 Sergeykrin9/mcp Servers
Sergeykrin9/mcp Servers 是面向俄罗斯市场营销与运营平台的一组 Python MCP 服务。各平台集成分别覆盖广告、搜索分析、视频和社交内容发布。
主要功能
- 01连接 Yandex.Direct 和 Click.ru
- 02提供 Yandex.Webmaster 与 Search Console 数据
- 03访问 YouTube 视频、频道和评论
- 04发布和管理 VK 与 Telegram 帖子
- 05各平台以独立进程运行,可分别启用
适用场景
- 01管理 Yandex.Direct 广告活动和出价
- 02查看搜索查询与索引状态
- 03向 VK 或 Telegram 发布内容
MCP 相关
各平台目录提供 MCP 服务,向 LLM 应用开放相应集成工具。各服务可独立配置和启用。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
重要
广告、搜索分析和社交平台发布集成。每个服务都需要单独的平台配置和权限。
这是一个包含 8 个自定义 Model Context Protocol(MCP)服务目录的集合,可将营销平台接入大模型 Agent 工作流。其设计旨在让 Agent(Claude Code、Claude Desktop、Cursor、Windsurf)直接运行广告活动、读取分析数据、发布帖子并检查 SEO 状况,无需人工点击按钮。
如果你还不了解 MCP,从这里开始——这是 Anthropic 用于将工具接入大模型应用的开放协议。
包含内容
| 服务 | 向 Agent 提供的功能 |
|---|---|
linkedin/ | LinkedIn 个人资料和发布工具;详见其自有 README |
clickru/ | Click.ru API——Telegram Ads、VK Ads、Yandex.Direct 广告活动、余额、报告、出价管理器 |
yadirect/ | Yandex.Direct——创建/暂停广告活动、管理关键词、出价和广告文案 |
yandex-webmaster/ | Yandex.Webmaster——索引、热门查询、站点地图、重新抓取、问题检测 |
gsc/ | Google Search Console——热门查询、页面、国家/地区明细、索引状态 |
youtube/ | YouTube Data API——视频、频道、评论、文字稿、热门内容 |
vk/ | VK Wall API——发布、编辑、置顶帖子,上传照片,查看统计数据 |
edaru-telegram/ | Telegram Bot API——在已配置频道中发布、编辑、删除和置顶帖子 |
它们共同覆盖了典型俄罗斯市场产品的完整增长体系:付费广告(通过 Click.ru 投放 Direct + Telegram Ads + VK Ads)、自然搜索(Yandex Webmaster + GSC)和内容分发(VK + Telegram)。
为什么这很重要
在 2026 年,增长的瓶颈不在于“该做什么”——Agent 可以制定计划。真正的瓶颈是连接 AI 计划与平台 API 的胶合层。这些服务正是这个胶合层。
先列出所选服务的工具。使用真实账户前,请先查看工具参数:有些工具会创建广告活动或发布内容。
⚡ 快速开始(3 步)
1. 克隆并安装:
git clone https://github.com/SergeyKrin9/mcp-servers.git
cd mcp-servers/yadirect # or any other server
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt # if present
# yadirect reads YANDEX_DIRECT_TOKEN from the process environment.
# Configure it in your host; no .env.example or dotenv loader is provided here.
2. 接入你的 AI 宿主:
Claude Desktop / Claude Code (~/Library/Application Support/Claude/claude_desktop_config.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" }
}
}
}
Cursor (~/.cursor/mcp.json) — 使用相同的 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" }
}
}
}
Windsurf(Settings → MCP Servers → Add)— 使用相同的 JSON 格式
配置相同——Windsurf 使用相同的 MCP 服务格式。
3. 检查工具发现。 请宿主列出已配置服务的工具,但不要调用它们。这样可以检查 MCP 注册情况,而不会发出广告或发布请求。API 集成检查需要单独的测试账户,不在此步骤范围内。
所需凭据
| 服务 | 需要获取 |
|---|---|
linkedin | LinkedIn 访问令牌;参见 linkedin/README.md |
clickru | Click.ru API 密钥 + 账户 ID(在 Click.ru 控制面板中) |
yadirect | 通过 oauth.yandex.ru 获取 Yandex.Direct OAuth 令牌 |
yandex-webmaster | 与 Direct 相同的 OAuth 流程,需包含 webmaster:hostinfo,webmaster:verify 权限范围 |
gsc | 可访问 Search Console 的 Google 服务账户 JSON |
youtube | YouTube Data API v3 密钥(Google Cloud Console) |
vk | VK 群组访问令牌(管理员权限) |
edaru-telegram | Telegram 机器人令牌(BotFather)+ 聊天 ID |
如果想在本地获取令牌,yandex-webmaster/oauth_helper.py 包含可用的 OAuth 流程。
GSC 配置迁移
GSC 服务不再回退到特定机器的凭据路径。请在 MCP 服务进程的环境中将 GSC_SERVICE_ACCOUNT_KEY 设置为你现有的服务账户 JSON 文件的绝对路径:
{
"env": {
"GSC_SERVICE_ACCOUNT_KEY": "/absolute/path/to/your-existing-service-account.json"
}
}
将此 env 条目合并到现有的 GSC 服务配置中,然后重启该服务。请将占位符替换为你自己的本地路径;不要将 JSON 文件内容粘贴到配置中,也不要提交该文件。此变更不会创建凭据,也不会授予任何新权限。现有服务账户必须已获准访问 Search Console 属性。如果缺少此变量,调用 GSC 工具时,服务会报告配置错误。
技术栈
- Python 3.10+ · 标准库 +
requests mcpPython SDK- 每个平台一个进程——便于独立启用或停用
路线图
- Telegram Ads MCP(独立于 Click.ru,使用原生 API)
- Plausible / Yandex.Metrika 实时 MCP(目前仅提供报告)
- 一次性 CLI 封装,让你无需 MCP 主机即可调用其中任意服务
⭐ Star 历史
📚 相关项目
- agnis-workflow — 将这些 MCP 服务作为一等工具使用的方法论
- broker-reels — 房地产视频的 Python 流水线,带有离线演示
- awesome-mcp-servers — 权威的 MCP 目录
作者: Sergei Grin · [email protected] · GitHub
如果你面向俄罗斯受众发布产品并使用 Claude,请点个 ⭐。这会让我继续添加服务。
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。