Direct Manager — Яндексダイレクト用MCP

Claude や ChatGPT をЯндексダイレクトに接続し、対話形式で広告を管理できます。「どこでお金が無駄になっている？」→ アシスタントが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 は、ホスト型MCPサーバー Direct Manager へのシンプルなコネクタです。サーバー本体、Direct APIへのアクセス、およびすべてのロジックはサービス側で動作します。このパッケージは、あなたのAIアシスタントをそれに接続するだけです。

このサービスには 2つの独立した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 上）:

• 分析と統計 — 期間やセグメント（デバイス、性別、年齢、YANサイト、地域）ごとのキャンペーンメトリクス; 検索クエリ; インプレッションシェア。

• 非効率な支出の発見 — ROAS < 1のキャンペーン、コンバージョンなしの支出、不要なサイトやキーワード。

• 管理 — 一時停止/再開、日次および週次予算、戦略（目標付きコンバージョン戦略や目標CPA/ROASを含む）、マイナスキーワード、キーワード、入札単価、調整。

• ゼロからのキャンペーン構築 — キャンペーン → グループ → 広告（クイックリンクとUTM付き）。

• AIによる洞察 — 30日間の支出とコンバージョンの予測、低下の診断（トラフィック/CR/CPC）、期間比較の説明（ドライバー付き）、ルーブル単位でランク付けされたトップ発見、1回の呼び出しで週次ブリーフを作成。

• Wordstat — 頻度付きキーワード提案。

• 代理店向け — 全アカウントのポートフォリオ概要: 各クライアントの支出、利益、無駄な支出、予算残高を1つの回答で。

書き込み操作は個別のアノテーションでマークされており、アシスタントとクライアントは修正が適用される前に何が変更されるかを確認できます。Direct APIのエラーは適切に処理されます。いわゆる「サイレント」エラー（APIが200を返すが修正が適用されなかった場合）も含みます。

MarketScore SEO — 検索エンジン最適化のための2つ目のMCP

同じアカウントには SEO専用の別のMCPサーバー があります。これは広告ではなく、オーガニック検索に関するものです。Яндекс Вебмастер、Google Search Console、Яндекс Метрика、Topvisor、Wordstatを1つのアシスタントに統合します。

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

これは 別のアドレスと別のサブスクリプション です。SEOプランはダイレクトプランに含まれておらず、その逆も同様です。ダイレクトのツールはSEOアドレスには表示されず、その逆も同様です。

あなた: 過去28日間で、検索からのトラフィックがなぜ減少したのですか？

Claude: クリック数が940から610に減少しました。比較は両方の期間を測定したソースのみで計算します: Search Console — はい、Вебмастер — はい、Topvisorは接続されていないため、順位は独立してチェックされていません。主な低下は /catalog セクション: 18ページがЯндекс検索から「重複」の理由で除外されました。Вебмастерは8月3日からこれを認識しています。アドレスのリストを表示しますか？

21のツール があり、そのうち実際に何かを変更するのは3つだけです（seo_add_keywords、seo_add_competitors、seo_request_recrawl）。残りは読み取り専用です:

• 検索データ — seo_overview（クリック数、インプレッション数、CTR、平均掲載順位、トップ3/トップ10、期間比較）、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（トップ近くのクエリ、CTRが低いページ、インプレッションはあるがクリックなし、カニバリゼーション）、seo_sitemaps（ЯндексとGoogleがサイトマップを認識しているか）、seo_url_inspection（特定のURLに対するGoogleの判定）、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残高から費用を差し引くため、費用は差し引かれる前に画面に表示される必要があります。2つの書き込みツールは次の順位チェックのコストを増加させ、アシスタントは呼び出し前にこの結果を述べる義務があります。

• 約束しないこと: サイト全体のクロールは行いません。1回の呼び出しで1ページのみチェックします。テキストのユニーク性はチェックしません（ソースがありません）。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 — URL経由

リモートMCPコネクタを追加:

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

アシスタントがログインページを開きます — OAuthで認証します。Яндексトークンはアシスタントに渡されません。2つのアドレスを同時に追加できます。これらは独立したサブスクリプションを持つ独立したコネクタです。

ローカル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 ₽/月: AIチャットから作業するための完全なMCPセット（111ツール）、最大3つのダイレクトアカウント。ウェブダッシュボードなし — アシスタントのみ。

• 「プロ」 — 1,990 ₽/月: 同じ111ツール に加えて、分析とオートパイロットを備えたウェブダッシュボード、最大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のオープンソースラッパーとの違い

Direct APIのセルフホストMCPラッパー（例: mcp-yandex-direct）が存在します。正直な比較:

セキュリティ

• 認証 — OAuth 2.1: Яndexトークンはアシスタントに渡されず、クライアント設定にも保存されません。サービス側で保管されます。

• Direct Managerアカウントのパスワードを変更すると、発行されたすべてのMCPアクセスが無効になります。

• 書き込み操作はアノテーションでマークされ、MCPクライアント側で確認されます。

• 個人データはロシア連邦のサーバーに保存されます（連邦法152-FZ）。

FAQ

無料ですか？ 最初の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ボット、ポートフォリオ概要があります。Яndexトークンは設定に保存されません。詳細は上の表を参照してください。

サブスクリプションなしで動作しますか？ いいえ — 有効なプランがない場合、サーバーは0個のツールを返します。

SEOもできますか？ はい、別のMCPサーバーとして: https://app.marketscore.ru/api/mcp/seo — Яndex Вебмастер、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はstdoutに出力されます — コンテナからブラウザは開かないので、手動でリンクを開いてください。mcp-remote トークンは ~/.mcp-auth に保存されます — 起動のたびに再認証しないようにボリュームをマウントしてください。

便利なリンク

• Яндекс Директ用MCPサーバーとは: https://app.marketscore.ru/blog/mcp-server-yandex-direct

• Яндекс Директ向けAI — 2026年のツール: https://app.marketscore.ru/blog/ii-dlya-yandex-direkta-instrumenty-2026

• ClaudeとChatGPTによるДиректの管理: https://app.marketscore.ru/blog/upravlenie-yandex-direct-cherez-claude-chatgpt

• Яндекс Вебマスター用MCPサーバー: https://app.marketscore.ru/blog/mcp-server-yandex-webmaster

• SEOのためのニューラルネットワーク — 実際に自動化されるもの: https://app.marketscore.ru/blog/nejroset-dlya-seo-avtomatizaciya

• Search Consoleでクリック数が一致しない理由: https://app.marketscore.ru/blog/search-console-kliki-ne-shodyatsya

English

Direct Manager is an AI/MCP service for Yandex Direct (Russian search advertising). This package is a thin connector to the hosted Direct Manager MCP server: it lets Claude, ChatGPT, or any MCP client read campaign analytics and run actions (pause, bids, budgets, negative keywords) on a Yandex Direct account from chat.

Install (remote, Claude/ChatGPT): add connector URL https://app.marketscore.ru/api/mcp and sign in via OAuth.

Install (local MCP clients — Cursor, VS Code, Cline, Zed):

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

Tools: up to 116 tools on top of Direct API v5 and Reports API — campaign analytics by device/gender/age/placements/geo, search queries, impression share, wasted-spend detection (ROAS < 1), campaign management (pause, budgets, strategies, negative keywords, bids), building campaigns from scratch, AI insights (spend forecast, drop diagnosis, change explanation, weekly brief), Wordstat keyword research, and a cross-account portfolio overview for agencies.

SEO MCP (separate server): https://app.marketscore.ru/api/mcp/seo — 21 tools for organic search on top of Yandex Webmaster, Goole Search Console, Yandex Metrica, Topvisor and Wordstat: search performance and period comparison, queries and pages, Yandex indexation state with exclusion reasons, growth opportunities (near-top queries, low-CTR pages, impressions without clicks, cannibalisation), a full SEO audit with a source and a date behind every finding, single-page technical analysis (PageSpeed, Core Web Vitals, on-page signals), sitemap status in both engines, Google URL inspection, Yandex recrawl requests, competitor positions, keyword management in Topvisor, landing-page conversions from Metrica, and a deterministic Russian-text check. Only three tools write anything; paid position checks are deliberately kept out of chat. Every answer carries provenance — a revoked source shows up as a source failure, never as zero traffic. Separate subscription (590 / 1 490 / 9 900 ₽/mo, 7-day trial): https://app.marketscore.ru/seo

Pricing: a Direct Manager account is required; sign-up includes a 7-day free Pro trial. Asistant — 990 ₽/mo (111 tools, chat-only, 3 Direct accounts); Pro — 1 990 ₽/mo (111 tools + web dashboard, 5 accounts); Agency — 9 900 ₽/mo (116 tools incl. portfolio overview, 20 accounts). SEO is a separate plan axis on a separate connector URL. Without an active plan the server exposes zero tools.

FAQ:

Is it free? The first 7 days are (Pro trial on sign-up); after that a subscription is required.

Where does my Yandex token go? It stays on the Direct Manager service — the assistant and the MCP client never see it, and it is not stored in any local config.

Can the assistant break my ad account? Write tools are annotated separately and the MCP client asks for confirmation before running them.

Keywors: Yandex Direct, Яндекс Директ, MCP, Model Context Protocol, MCP server, PPC, ads management, campaign analytics, ROAS, negative keywors, Wordstat, Claude, ChatGPY, Cursor, AI marketing, SEO MCP, Yandex Webmaster, Яндекс Вебмастеь, Goole Search Console, Yandex Metrica, Toovisor, SEO audit, ИИ-менеджер для Яндекс Директа, ИИ для рекламы.

License

MIT — see LICENSE. コネクタはオープンです；Direct Managerサービスは有料SaaSです。 / The connector is open; the Direct Manager service is a paid SaaS.