Skip to main content
Glama
deenesjakoruzh
theYahia

yandex-direct-mcp

by theYahia
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

🗄 リポジトリはアーカイブ済みです

開発は theYahia/YaAll に移転しました — Yandex関連レイヤー全体を1か所にまとめたビルドです: Yandex公式MCPサーバー、 Direct・Metrika用MCP、YaGEOスキル、Wordstatゲート。

ここにあったものの最新版: mcp/yandex-direct-mcp/

ここではもう何も更新されません。課題やpull requestはYaAllへ。

Archived — development moved to theYahia/YaAll, a single repository bundling the whole Yandex stack. The current version of this package now lives at mcp/yandex-direct-mcp/. Please open issues and pull requests there.

@theyahia/yandex-direct-mcp

Yandex.Direct API用MCPサーバー — 任意のMCPクライアント(Claude、Cursorなど)からコンテキスト広告を管理: キャンペーン、広告グループ、広告、キーワード、入札単価、マイナスキーワード、統計、残高。20のツール。

npm License: MIT

金額はルーブル単位(予算、入札単価の入出力とも)。サーバーがAPIのマイクロ単位に自動変換します。サンドボックス(安全なテスト用)とエージェンシーモード(Client-Login)に対応。

Related MCP server: yandex-direct-mcp

インストール

Claude Desktop

{
  "mcpServers": {
    "yandex-direct": {
      "command": "npx",
      "args": ["-y", "@theyahia/yandex-direct-mcp"],
      "env": {
        "YANDEX_DIRECT_TOKEN": "ваш_токен"
      }
    }
  }
}

Claude Code

claude mcp add yandex-direct -e YANDEX_DIRECT_TOKEN=ваш_токен -- npx -y @theyahia/yandex-direct-mcp

設定(環境変数)

変数

必須

用途

YANDEX_DIRECT_TOKEN

はい

Yandex.DirectのOAuthトークン

YANDEX_DIRECT_SANDBOX

いいえ

1 — サンドボックスで動作(隔離されたデータ、費用発生なし)。同じトークン、URLのみ異なる

YANDEX_DIRECT_LOGIN

いいえ

エージェンシートークン用のクライアントログイン(Client-Loginヘッダー)。トークンがエージェンシー用の場合は必須

トークンの取得方法

OAuthトークンは、Yandex OAuthに登録されたアプリケーションに対して、Direct APIへのアクセス権付きで発行されます。詳細はアプリの登録とトークンの取得を参照。APIへのアクセスはDirectのインターフェースで申請する必要があります。

⚠️ 注意: 実際の費用が発生します

create_campaign、create_text_ad、add_keywords、set_keyword_bidsなどのツールは本番の広告アカウントを変更し、費用が発生する可能性があります。シナリオのデバッグにはサンドボックス(YANDEX_DIRECT_SANDBOX=1)を有効にしてください。

ツール(20)

キャンペーン

ツール

説明

list_campaigns

キャンペーンの一覧(ステータス/タイプによるフィルター、ページネーション)

get_campaign

IDによるキャンペーンの詳細情報

create_campaign

キャンペーンを作成(予算はルーブル、戦略の選択)

update_campaign

名前/予算および/またはステータスを更新(SUSPEND/RESUME/ARCHIVE/UNARCHIVE)

広告グループ

ツール

説明

list_ad_groups

選択したキャンペーンの広告グループ

create_ad_group

地域ターゲティング付きでグループを作成

delete_ad_groups

IDでグループを削除

set_ad_group_negative_keywords

グループのマイナスキーワードを設定

広告

ツール

説明

list_ads

グループ内の広告

create_text_ad

テキスト広告を作成(≤56/≤30/≤81)

update_text_ad

タイトル/テキスト/リンクを更新

manage_ads

suspend/resume/archive/unarchive/moderate/delete

キーワードと入札単価

ツール

説明

list_keywords

グループ内のキーワードフレーズ(入札単価はルーブル)

add_keywords

キーワードフレーズを追加

set_keyword_bids

フレーズ/グループ/キャンペーンに入札単価を設定(検索/ネットワーク、ルーブル)

manage_keywords

suspend/resume/delete

set_campaign_negative_keywords

キャンペーンのマイナスキーワードを設定

統計、アカウント、リファレンス

ツール

説明

get_statistics

期間別の統計(インプレッション、クリック、費用、CTR、CPC)

get_account_balance

アカウント残高(Live API v4)

get_regions

地域コードのリファレンス(225 = ロシア)

リクエスト例

Покажи все активные рекламные кампании
Создай кампанию "Летняя распродажа" с бюджетом 5000 ₽/день, старт 2026-05-01
Установи ставку 25 ₽ на ключевые фразы 111 и 222
Добавь минус-фразы "бесплатно", "скачать" в кампанию 12345
Какая статистика у кампаний 12345 и 67890 за последнюю неделю?
Найди код региона для Новосибирска
Покажи баланс аккаунта

開発

npm install
npm run build      # tsc → dist/
npm test           # vitest (моки fetch)
npm run dev        # tsx src/index.ts

ライセンス

MIT

Install Server
A
license - permissive license
A
quality
F
maintenance

How are these scores calculated?

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.

Tools

View all tools

Related MCP Servers

  • yandex-marketing-mcp

    skiddgoddamn
    A
    license
    B
    quality
    B
    maintenance
    MCP server for managing Yandex Direct advertising, Yandex Metrica analytics, Wordstat keyword research, and Yandex Webmaster SEO tools, with self-configuring OAuth; provides 153 tools for complete ad and search workflows from AI assistants.
    100
    15
    MIT

  • yandex-direct-mcp

    nikolaymokh-dev
    A
    license
    B
    quality
    B
    maintenance
    A hardened MCP server for managing Yandex.Direct advertising campaigns with read-only defaults, write and finance capabilities optional, using OAuth authentication.
    26
    MIT

  • yandex-mcp

    SvechaPVL
    A
    license
    Not graded
    quality
    D
    maintenance
    MCP server for Yandex Direct, Metrika, Wordstat, and Webmaster APIs, providing 132 tools to manage advertising campaigns, analytics, keyword research, and reporting through any MCP-compatible client.
    58
    MIT

View all related MCP servers

Related MCP Connectors

  • marketscore-direct-mcp

    MCP for Yandex Direct: manage ad campaigns & analytics from Claude or ChatGPT

  • HasData

    All HasData scraping tools in one MCP server: Google, TikTok, Instagram, maps, e-commerce and more.

  • Yandex Metrika MCP

    Read-only Yandex Metrika MCP. Query visits, sources, geo, devices and more in plain language.

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/theYahia/yandex-direct-mcp'

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