🗄 Repository archiviert

Die Entwicklung ist umgezogen nach theYahia/YaAll — ein Build, in dem die gesamte Yandex-Schicht an einem Ort liegt: offizielle MCP-Server von Yandex, MCP für Direct und Metrika, der Skill YaGEO und das Wordstat-Gate.

Die aktuelle Version dessen, was hier lag: mcp/yandex-direct-mcp/

Hier wird nichts mehr aktualisiert. Aufgaben und Pull Requests — in 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

MCP-Server für die Yandex.Direct-API — Verwaltung von kontextueller Werbung aus jedem MCP-Client (Claude, Cursor u. a.): Kampagnen, Gruppen, Anzeigen, Keywords, Gebote, Minus-Phrasen, Statistiken, Guthaben. 20 Tools.

Geld — in Rubel (Budgets, Gebote bei Eingabe und Ausgabe); der Server konvertiert selbst in Mikroeinheiten der API. Unterstützt werden die Sandbox für sichere Tests und der Agentenmodus (Client-Login).

Related MCP server: yandex-direct-mcp

Installation

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

Konfiguration (Umgebungsvariablen)

So erhalten Sie einen Token

Der OAuth-Token wird für eine Anwendung ausgestellt, die in Yandex OAuth registriert ist, mit Zugriff auf die Direct-API. Details — Anwendungsregistrierung und Token-Erhalt. Der API-Zugriff muss in der Direct-Oberfläche beantragt werden.

⚠️ Achtung: echte Ausgaben

Die Tools create_campaign, create_text_ad, add_keywords, set_keyword_bids u. a. verändern das produktive Werbekonto und können Geld ausgeben. Aktivieren Sie für die Fehlersuche in Szenarien die Sandbox (YANDEX_DIRECT_SANDBOX=1).

Tools (20)

Kampagnen

Anzeigengruppen

Anzeigen

Keywords und Gebote

Statistiken, Konto, Verzeichnisse

Beispielanfragen

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

Entwicklung

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

Lizenz

MIT