インストール不要。2分以内に動きます。
cloud.anythingmcp.com で無料トライアルを開始し、Yandex Direct をワンクリックで追加して、AI クライアント（Claude、ChatGPT、Copilot、Cursor）を生成された MCP エンドポイントに向けるだけ。Docker も git clone も、開発経験も不要です。
概要
Yandex Direct の広告を AI に読み取り専用で分析させます。キャンペーン、広告グループ、広告、キーワードと入札単価、サイトリンクとコールアウト、代理店のクライアント、ディクショナリ、変更の追跡、そして日別、キャンペーン別、広告別、検索クエリ別の統計レポートに対応します。
こう聞いてみよう
Yandex Direct のサンプルプロンプト
プロンプトをクリックでコピー。Claude / ChatGPT / Cursor / Gemini / Copilot / OpenClaw に貼り付けて、このコネクターで実行できます。
Claude は AI のため誤ることがあります。回答をご確認ください。
💡 インストール不要? cloud.anythingmcp.com を直接利用してください。 サインインし、Connectors → Yandex Direct をクリック、認証情報を貼り付け、MCP API キーを発行すれば完了です。Docker も
git cloneもローカルサーバーも不要。
Yandex Direct
Yandex Direct の広告を AI に読み取り専用で分析させます。キャンペーン、広告グループ、広告、キーワードと入札単価、サイトリンクとコールアウト、代理店のクライアント、ディクショナリ、変更の追跡、そして日別、キャンペーン別、広告別、検索クエリ別の統計レポートに対応します。
セットアップ
セットアップは約 10 分で、これに Yandex が API アクセスを承認するまでの時間（1 時間から数営業日）が加わります。キャンペーンが 1 つ以上ある Yandex Direct アカウントと、oauth.yandex.ru に登録した自分のアプリが必要です。
- oauth.yandex.ru でアプリを登録します。プラットフォームは Web サービス、権限は Yandex Direct API（
direct:api）です。アプリの ClientID を控えておきます。 - Yandex Direct の Web 画面で Tools → API を開き、その ClientID で API アクセスを申請して API 利用規約に同意します。Yandex が申請を承認するまで、呼び出しはエラー 58 で失敗します。
- Direct アカウントでサインインした状態で、自分の ClientID を入れた
https://oauth.yandex.ru/authorize?response_type=token&client_id=<ClientID>を開き、access_token（y0_ で始まります）をYANDEX_DIRECT_TOKENにコピーします。先頭に Bearer や OAuth は付けません。トークンの有効期間は約 1 年で、使っている間は延長されます。 - 代理店の場合のみ: 読み取る広告主の Yandex ログインを
YANDEX_DIRECT_CLIENT_LOGINに設定します。ログインの一覧はyandex_direct_list_agency_clientsで取得できます。自社アカウントの場合は空のままにします。 - コネクターをインストールし、
yandex_direct_get_clientを実行します。アカウント、ログイン、通貨が表示されます。
読み取れるデータ: タイプ、ステータス、状態、期間、資金、累計のクリック数と表示回数、入札戦略を含むキャンペーン、地域と除外キーワードを含む広告グループ、タイトル、本文、リンクを含む広告、入札単価と生産性を含むキーワードとオートターゲティング、検索の各掲載順位に必要な入札単価とトラフィックを含むキーワード入札、サイトリンク、コールアウト、共有の除外キーワードセット、リターゲティングリスト、代理店のクライアント、通貨や地域などのディクショナリ、指定時点以降に変更されたキャンペーン、そして日別、キャンペーン別、広告別、検索クエリ別の統計レポートです。
レポート: yandex_direct_get_report はタブ区切りのテキストを返し、1 行目が列名、金額は小数です。小さなレポートはすぐに返ります。大きなレポートはオフラインで作成され、AI は Yandex が示す待ち時間の後に同じパラメーターでもう一度要求します。キューに入れられるオフラインレポートは最大 5 件で、検索クエリレポートはオフラインのみ、対象は直近 180 日間です。
金額とページ送り: 入札単価、予算、資金はマイクロ単位の整数で返ります（2500000 = アカウント通貨で 2.50）。一覧は標準で最大 500 件、上限は 10,000 件で、広告グループ、広告、キーワードは 1 回の呼び出しで最大 10 キャンペーン分を読み取ります。
設計上、読み取り専用: すべてのツールは読み取りだけを行います。作成、変更、一時停止、支払いは一切しないため、確認が必要な操作も、インストール時にオフになっているツールもありません。
制限: どの呼び出しも広告主の 1 日あたりの割り当てから API ポイントを消費し、失敗した呼び出しは 20 ポイントかかります。AI は単発の呼び出しを何度も行うより、複数の ID をまとめた 1 回の呼び出しを優先し、必要なフィールドだけを要求します。エラー 152 は本日のポイントを使い切ったこと、506 は同時リクエストが多すぎることを示します。
よくあるエラー: 53 はトークンが無効または期限切れであることを示し、手順 3 のとおり新しいトークンを取得します。58 はアプリの API アクセスがまだ承認されていないことを示します。54、3000、3001 は API アクセスや権限がないこと（たとえばトークンで読み取れないクライアントログイン）を示します。513 はログインが Direct に接続されていないこと、8000 と 4000 から 4006 はパラメーターの誤り、8800 はオブジェクトが見つからないこと、9300 は 1 回の呼び出しの ID が多すぎることを示します。
このコネクターは、キャンペーン、広告、キーワード、入札単価の作成や編集、審査、予算、支払いの処理、Sandbox や Wordstat の利用は行いません。
前提条件: YANDEX_DIRECT_TOKEN
ローカルでコネクタをインストール
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
http://localhost:3000/connectors/store を開き、 Yandex Direct を選択し、前提条件に記載された環境変数を入力します。
利用可能なツール
| Tool | What it does |
|---|---|
yandex_direct_get_client | Read the advertiser account the token acts for (or the Client-Login one): ClientId, Login, ClientInfo (name), Currency, CountryId, Type… |
yandex_direct_list_campaigns | List campaigns: Id, Name, Type (TEXT_CAMPAIGN, UNIFIED_CAMPAIGN, SMART_CAMPAIGN, MOBILE_APP_CAMPAIGN, CPM_BANNER_CAMPAIGN ...), Status… |
yandex_direct_list_ad_groups | List ad groups of up to 10 campaigns (or by id): Id, Name, CampaignId, Type, Status, ServingStatus, RegionIds, NegativeKeywords… |
yandex_direct_list_ads | List ads of up to 10 campaigns, up to 1000 ad groups, or by id: Id, CampaignId, AdGroupId, Type, Status, State, StatusClarification, and… |
yandex_direct_list_keywords | List keywords and autotargeting of up to 10 campaigns, up to 1000 ad groups, or by id: Id, Keyword, State, Status, ServingStatus… |
yandex_direct_list_keyword_bids | Read keyword bids with the auction picture: for each keyword the search and network bid and, on search, the bids and traffic volume needed… |
yandex_direct_list_sitelinks | Read sitelink sets by id (SitelinkSetId from yandex_direct_list_ads): each sitelink's Title, Href and Description |
yandex_direct_list_ad_extensions | List ad extensions (callouts) of the account: Id, Type, Status, Associated and the callout text |
yandex_direct_list_negative_keyword_sets | Read shared negative keyword sets by id (NegativeKeywordSharedSetIds of campaigns and ad groups): Id, Name, NegativeKeywords, Associated |
yandex_direct_list_retargeting_lists | List retargeting and audience lists: Id, Name, Type, Description, Rules (Metrica goals and segments), IsAvailable, Scope |
yandex_direct_list_agency_clients | For agency accounts: list the agency's advertisers with Login, ClientId, ClientInfo, Currency and Archived |
yandex_direct_get_dictionaries | Read reference dictionaries: Currencies (with bid limits), GeoRegions (region ids used in RegionIds), TimeZones, Constants, AdCategories… |
yandex_direct_check_campaign_changes | Which campaigns changed since a moment: for each changed campaign, whether the campaign itself (SELF), its groups, ads or keywords… |
yandex_direct_get_report | Run a statistics report (Reports service) and return it as tab-separated text: a column header row, one row per line, money as decimals in… |
プロンプトの例
- 「先週のキャンペーンの成果を教えてください。キャンペーンごとの表示回数、クリック数、CTR、費用、コンバージョンを見せてください。」
- 「過去 30 日間で、コンバージョンが 1 件もないのに最も費用がかかった検索クエリはどれですか。」
- 「『冬タイヤ』キャンペーンのキーワードを入札単価と一緒に一覧にし、上位表示に必要な単価も教えてください。」
- 「現在、却下されている広告や配信されていない広告はどれですか。理由も教えてください。」
- 「私たちは代理店です。クライアントの一覧を出し、クライアント romashka-shop の昨日の費用を見せてください。」
次のステップ
このガイドは役に立ちましたか?
