Skip to main content
Glama
marketscore

Yandex Direct Manager

by marketscore

Direct Manager — Яндекс Директа MCP

npm version MIT license Glama MCP server

ClaudeChatGPT 连接到 Яндекс Директ,通过对话管理广告:「钱都浪费在哪里了?」→ 助手会找出 ROAS < 1 的广告系列,并建议关闭哪些。

Connect Claude or ChatGPT to Yandex Direct and manage ad campaigns in chat — analytics, wasted-spend detection, bids, budgets, negative keywords.

免费试用 — 7 天「Профи」套餐 →

网站 / Website: https://app.marketscore.ru


这是什么

marketscore-direct-mcp 是一个连接到 Direct Manager 宿主 MCP 服务器的轻量级连接器。服务器本身、对 Direct API 的访问以及所有逻辑都在服务端运行——此软件包仅用于将您的 AI 助手连接到它。

该服务拥有 两个独立的 MCP 服务器:广告服务器(Директ、VK、Авито、Wordstat)和 SEO 服务器(Вебмастер、Search Console、Метрика、Topvisor)——请参阅下面的 SEO 部分

工作方式如下:

您: 过去 14 天我的钱都浪费在哪里了?

Claude: 发现了 3 个问题,共 12 400 ₽:广告系列「Ремонт квартир — РСЯ」花费了 4 210 ₽,没有任何转化;网站 dsp.example 的 ROAS 为 0.2;6 个关键词有花费但零询价。要关闭该网站并将这些关键词添加到否定关键词中吗?

Related MCP server: meta-ads-mcp-server

功能

多达 116 个工具,基于 Direct API v5 和 Reports API(「Ассистент」和「Профи」套餐为 111 个,「Агентство」套餐为 116 个,包括投资组合 accounts_overview):

  • 分析与统计 — 按时间段和维度统计广告系列指标:设备、性别、年龄、РСЯ 网站、地理;搜索查询;展示份额。

  • 低效支出检测 — ROAS < 1 的广告系列、无转化的支出、多余的网站和关键词。

  • 管理 — 暂停/恢复、日预算和周预算、策略(包括带有目标和目标 CPA/ROAS 的转化策略)、否定关键词、关键词、出价和调整。

  • 从头搭建广告系列 — 广告系列 → 广告组 → 广告,包含快速链接和 UTM。

  • AI 洞察 — 预测未来 30 天的花费和转化、诊断下降(流量/CR/CPC)、解释周期对比变化及驱动因素、按金额排序的排名靠前的发现、一次调用生成现成的每周简报。

  • Wordstat — 带频率的关键词选择。

  • 针对代理商 — 跨所有账户的投资组合概览:每个客户的花费、利润、多余支出和剩余预算,在一个回复中。

写操作会带有单独的注释——助手和客户端在应用修改之前可以看到具体变化。Direct API 错误会被正确处理,包括「静默」错误(API 返回 200,但修改未生效)。

MarketScore SEO — 第二个用于搜索引擎优化的 MCP

同一账户还有一个 单独的 SEO MCP 服务器:它不是关于广告的,而是关于自然搜索的——将 Яндекс Вебмастер、Google Search Console、Яндекс Метрика、Topvisor 和 Wordstat 整合到一个助手中。

https://app.marketscore.ru/api/mcp/seo

这是 不同的地址和不同的订阅:SEO 套餐不包含在 Директ 套餐中,反之亦然。Директ 的工具不会出现在 SEO 地址上,反之亦然。

您: 为什么过去 28 天来自搜索的流量下降了?

Claude: 点击次数从 940 下降到 610。我只能根据同时测量了两个周期的来源进行比较:Search Console — 是,Вебмастер — 是,Topvisor 未连接,排名未独立检查。主要下降来自 /catalog 部分:18 个页面因「重复」原因从 Яндекс 搜索中消失,Вебмастер 自 8 月 3 日起就看到了这一点。要显示地址列表吗?

21 个工具,其中只有三个会进行写操作(seo_add_keywordsseo_add_competitorsseo_request_recrawl)——其余为只读:

  • 搜索数据seo_overview(点击次数、展示次数、点击率、平均排名、前三/前十和周期对比),seo_search_queries(按设备和区域划分的 Вебмастер 和 Search Console 查询和页面),seo_positions(来自 Topvisor 的最后一次检查),seo_indexation(Яндекс 搜索中有多少页面、哪些被排除以及原因),seo_metrika(来自搜索的访问者行为和目标达成情况),seo_landing_pages(按着陆页面划分的访问和询价)。

  • 与网站协作seo_audit(索引、技术、页面内和竞争情况分析,每个结论都附有来源),seo_page_analysis(页面速度、Core Web Vitals 和页面内信号),seo_opportunities(接近排名前三的查询、点击率低的页面、有展示但无点击、同类相食),seo_sitemaps(Яндекс 和 Google 是否看到网站地图),seo_url_inspection(Google 对特定 URL 的判定),seo_request_recrawl(将 URL 发送至 Яндекс 重新抓取),seo_text_check(现成俄语文本中的 AI 模板、官腔和过度堆砌)。

  • 需求seo_keyword_demand:从 Wordstat 获取频率、相似短语、噪音标记和季节性。

  • 关键词与检查seo_keywords(正在检查排名的关键词),seo_add_keywords(将短语加入检查),seo_positions_plan(检查计划、启动成本和 Topvisor 余额)。

  • 竞争对手seo_competitors(我们与竞争对手的位置对比),seo_add_competitors(将竞争对手网站添加到项目中)。

  • 项目seo_projects(账户中的网站)和 seo_sources(已连接哪些、哪些已过期以及当来源停止工作时确切有哪些信息将不再可用)。

此处与同 API 的包装器不同之处:

  • 响应带有出处。 每个数字都有来源和采集日期。对 Вебмастер 的访问被撤销会显示为来源拒绝,而不是零流量:「没有数据」和「没有问题」是不同的响应,模型不应混淆它们。

  • 未完成的检查会被列出。 如果某个来源静默或未确认网站权限,审计会返回一个列表,说明「具体哪些内容未被检查以及原因」,并给出一个上限评估,而不是低估为「一切正常」。

  • 写入边界按金额划定。 付费启动排名检查、更改计划、删除关键词和竞争对手的操作有意未集成到聊天中——这些会从 Topvisor 余额中扣款,成本应在扣款前在屏幕上可见。两个写入工具会使下一次排名检查的成本增加,助手必须在调用前说明这一后果。

  • 我们不承诺的内容: 不会爬取整个网站——每次调用只检查一个页面;不检查文本独特性(我们没有来源);若未连接 Topvisor,不会虚构排名。

SEO 套餐(单独订阅,7 天免费试用):「Старт」— 590 ₽/月(1 个网站,2 次审计,20 个 Wordstat 查询),«Профи» — 1 490 ₽/月(5 个网站,10 次审计,200 个 Wordstat),«Агентство» — 9 900 ₽/月(20 个网站,60 次审计,2 000 个 Wordstat)。所有 21 个工具在任何有效的 SEO 套餐上均可使用。排名检查通过您自己的 Topvisor 账户余额运行——我们不加价。

更多详情:https://app.marketscore.ru/seo

安装

Claude(桌面版、网页版、Code)和 ChatGPT — 通过链接

添加远程 MCP 连接器:

https://app.marketscore.ru/api/mcp        реклама: Яндекс Директ, VK, Авито, Wordstat
https://app.marketscore.ru/api/mcp/seo    органика: Вебмастер, Search Console, Метрика, Topvisor

助手将打开登录页面——通过 OAuth 授权。Яндекс 令牌不会传递给助手。两个地址可以同时添加:它们是具有独立订阅的独立连接器。

本地 MCP 客户端(Cursor、VS Code、Cline、Zed)— 通过桥接

npx -y marketscore-direct-mcp

MCP 客户端配置示例:

{
  "mcpServers": {
    "direct-manager": {
      "command": "npx",
      "args": ["-y", "marketscore-direct-mcp"]
    }
  }
}

套餐与访问

连接器需要一个 Direct Manager 账户。注册时 — 免费试用 7 天「Профи」套餐(包括 Claude/ChatGPT 中的 AI 助手)。之后:

  • 「Ассистент」— 990 ₽/月: 完整的 MCP 工具集(111 个工具),用于 AI 聊天工作,最多 3 个 Директ 账户。无 Web 仪表盘——仅限助手。

  • 「Профи」— 1 990 ₽/月: 同样的 111 个工具 加上 带有分析和自动驾驶功能的 Web 仪表盘,最多 5 个 Директ 账户。

  • 「Агентство」— 9 900 ₽/月: 116 个工具(加上投资组合概览 accounts_overview),最多 20 个账户。

  • SEO — 独立的套餐轴线(590 / 1 490 / 9 900 ₽/月)和独立的连接器地址。Директ 套餐不提供对 SEO 工具的访问,反之亦然。

无有效套餐时,服务器返回 0 个工具。注册:https://app.marketscore.ru/register · 套餐:https://app.marketscore.ru/pricing · SEO:https://app.marketscore.ru/seo

与 Direct API 的开源包装器有何不同

存在一些自托管的 MCP 包装器(例如 mcp-yandex-direct)。诚实的比较:

Direct Manager(本连接器)

自托管包装器

安装

通过链接进行 OAuth 登录

获取 Директ 令牌并写入配置

AI 洞察、审计、自动驾驶

有(预测、诊断、简报、排名靠前的发现)

无 — 仅原始 API 调用

Web 仪表盘和 Telegram 机器人

账户投资组合

有(跨所有客户的概览)

价格

订阅制(7 天免费试用)

免费,但需自行配置和托管

Яндекс 令牌存储位置

在服务端,客户端配置中无令牌

本地存储在客户端配置中

安全性

  • 授权 — OAuth 2.1:Яндекс 令牌不会传递给助手,也不存储在客户端配置中,而是存储在服务端。

  • Direct Manager 账户密码更改会撤销所有已颁发的 MCP 访问权限。

  • 写操作带有注释,并在 MCP 客户端侧确认。

  • 个人数据存储在俄罗斯境内的服务器上(符合 152-FZ 法规)。

常见问题

这是免费的吗? 前 7 天是免费的(注册时可试用「Профи」套餐)。之后需要「Ассистент」套餐(990 ₽/月,仅 MCP)或更高。

Директ 令牌到哪里去了? 它在 OAuth 连接时被授予 Direct Manager 服务,并存储在其服务器上。助手和 MCP 客户端看不到该令牌。

助手会不会搞乱账户? 写工具有单独的标记,MCP 客户端在调用它们之前会请求确认。自动驾驶不会自行触及广告系列暂停和预算——仅根据您的命令执行。

能与 ChatGPT、Cursor、VS Code 一起使用吗? 可以:Claude 和 ChatGPT 通过 URL 直接连接,Cursor/VS Code/Cline/Zed 通过此软件包(npx -y marketscore-direct-mcp)连接。

与免费的 MCP 包装器有何不同? 除了 API 访问之外,还提供 AI 洞察层、审计、仪表盘、Telegram 机器人和投资组合概览;Яндекс 令牌不存储在配置中。详见上表。

没有订阅能用吗? 不能——没有有效套餐时,服务器返回 0 个工具。

你们能做 SEO 吗? 可以,通过单独的 MCP 服务器:https://app.marketscore.ru/api/mcp/seo — 基于 Яндекс Вебмастер、Google Search Console、Метрика、Topvisor 和 Wordstat 的 21 个工具。其订阅独立于 Директ 套餐,提供 7 天免费试用。

Docker

docker build -t marketscore-direct-mcp .
docker run -i --rm -v ~/.mcp-auth:/root/.mcp-auth marketscore-direct-mcp

OAuth URL 会打印到标准输出——容器内不会打开浏览器,请手动点击链接。mcp-remote 令牌存储在 ~/.mcp-auth 中——请挂载卷以避免每次启动时重新授权。

有用链接


中文

Direct Manager 是一个用于 Yandex Direct(俄罗斯搜索广告)的 AI/MCP 服务。此软件包是托管式 Direct Manager MCP 服务器的轻量连接器:它允许 ClaudeChatGPT 或任何 MCP 客户端读取广告系列分析并在聊天中执行操作(暂停、出价、预算、否定关键词)以管理 Yandex Direct 帐号。

安装(远程,Claude/ChatGPT): 添加连接器 URL https://app.marketscore.ru/api/mcp 并通过 OAuth 登录。

安装(本地 MCP 客户端 — Cursor、VS Code、Cline、Zed):

{
  "mcpServers": {
    "direct-manager": {
      "command": "npx",
      "args": ["-y", "marketscore-direct-mcp"]
    }
  }
}

工具: 基于 Direct API v5 和 Reports API 提供多达 116 种工具——按设备/性别/年龄/投放位置/地理位置分析的广告系列、搜索查询、展示份额、浪费支出检测(ROAS < 1)、广告系列管理(暂停、预算、策略、否定关键词、出价)、从头构建广告系列、AI 洞察(支出预测、下降诊断、变更说明、每周简报)、Wordstat 关键词研究,以及面向代理商的跨账户概况概览。

SEO MCP(独立服务器): https://app.marketscore.ru/api/mcp/seo — 基于 Yandex WebmasterGoogle Search ConsoleYandex MetricaTopvisorWordstat 提供 21 种自然搜索工具:搜索表现及期间比较、查询与页面、Yandex 索引状态及排除原因、增长机会(接近顶部查询、低点击率页面、有展示无点击、关键词自相残杀)、每个发现均附来源和日期的完整 SEO 审计、单页面技术分析(PageSpeed、Core Web Vitals、页面内信号)、两大搜索引擎中的站点地图状态、Google URL 检查、Yandex 重新抓取请求、竞争对手排名、Topvisor 中的关键词管理、Metrica 中的着陆页转化率,以及确定性俄语文本检查。只有三种工具会写入内容;付费排名检查被刻意排除在聊天之外。每个答案都带有来源——被撤销的来源会显示为来源故障,而绝不会显示为零流量。需要单独订阅(590/1 490/9 900 ₽/月,7 天试用):https://app.marketscore.ru/seo

定价: 需要一个 Direct Manager 账户;注册包含 7 天免费 Pro 试用。Assistant — 990 ₽/月(111 种工具,仅聊天,3 个 Direct 账户);Pro — 1 990 ₽/月(111 种工具 + 网页仪表板,5 个账户);Agency — 9 900 ₽/月(116 种工具,含概况概览,20 个账户)。SEO 是独立的计划维度,使用独立的连接器 URL。没有激活计划时,服务器不显示任何工具。

常见问题解答:

是免费的吗? 前 7 天免费(注册时获得 Pro 试用);之后需要订阅。

我的 Yandex 令牌去了哪里? 它保留在 Direct Manager 服务上——助手和 MCP 客户端永远不会看到它,也不会存储在任何本地配置中。

助手会破坏我的广告账户吗? 写入工具会单独标注,MCP 客户端在运行前会请求确认。

关键词:Yandex Direct、Яндекс Директ、MCP、Model Context Protocol、MCP 服务器、PPC、广告管理、广告系列分析、ROAS、否定关键词、Wordstat、Claude、ChatGPT、Cursor、AI 营销、SEO MCP、Yandex Webmaster、Яндекс Вебмастер、Google Search Console、Yandex Metrica、Topvisor、SEO 审计、ИИ-менеджер для Яндекс Директа、ИИ для рекламы。

许可证

MIT — 见 LICENSE。连接器是开放的;Direct Manager 服务是付费 SaaS。

A
license - permissive license
Not graded
quality - not tested
A
maintenance

Maintenance

Maintainers
Response time
0dRelease cycle
2Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • F
    license
    Not graded
    quality
    F
    maintenance
    MCP server for managing Google Ads, Meta Ads, LinkedIn Ads, and TikTok Ads via AI. 210+ tools including account audits, wasted spend detection, and PMax insights.
    2
  • A
    license
    Not graded
    quality
    C
    maintenance
    MCP Server for the Meta Marketing API. Gives Claude Desktop direct access to your ad account data — campaign performance, creative analysis, audience breakdowns, and budget pacing.
    168
    1
    MIT
  • F
    license
    Not graded
    quality
    C
    maintenance
    MCP-сервер для управления кампаниями, группами, объявлениями, ключевыми фразами и статистикой Яндекс.Директ через Claude.
  • A
    license
    Not graded
    quality
    B
    maintenance
    A local MCP server that connects Yandex Direct advertising reports and safe campaign creation to AI agents, enabling natural-language analytics and protected campaign setup.
    2
    MIT

View all related MCP servers

Related MCP Connectors

  • OpenAI Ads MCP for ChatGPT Ads campaigns, creatives, audiences, insights, and conversions.

  • 233 tools for Google, Microsoft, TikTok, LinkedIn Ads in Claude or ChatGPT. Writes need approval.

  • Manage ad campaigns across Google, Meta, LinkedIn, Reddit, TikTok, and more via AI.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/marketscore/marketscore-direct-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server