Direct Manager — MCP für Yandex Direct

Verbinden Sie Claude oder ChatGPT mit Yandex Direct und verwalten Sie Werbung im Dialog: „Wo fließt Geld unnötig ab?“ → Der Assistent findet Kampagnen mit ROAS < 1 und schlägt vor, was deaktiviert werden sollte.

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

Kostenlos testen — 7 Tage Tarif „Profi“ →

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

Was ist das

marketscore-direct-mcp ist ein schlanker Connector zum Host-MCP-Server Direct Manager. Der Server selbst, der Zugriff auf die Direct API und die gesamte Logik laufen auf der Seite des Dienstes – dieses Paket verbindet lediglich Ihren KI-Assistenten damit.

Der Dienst hat zwei unabhängige MCP-Server: einen für Werbung (Direct, VK, Avito, Wordstat) und einen für SEO (Webmaster, Search Console, Metrika, Topvisor) – siehe Abschnitt zu SEO unten.

So sieht die Arbeit aus:

Sie: Wo fließt bei mir in den letzten 14 Tagen Geld unnötig ab?

Claude: Habe 3 Probleme für 12.400 ₽ gefunden: Die Kampagne „Wohnungsrenovierung – YAN“ hat 4.210 ₽ ohne eine einzige Conversion ausgegeben; die Plattform dsp.example liefert einen ROAS von 0,2; 6 Keywords mit Ausgaben und null Anfragen. Plattform deaktivieren und Keywords als negative Keywords hinzufügen?

Related MCP server: meta-ads-mcp-server

Was kann es

Bis zu 116 Tools über die Direct API v5 und Reports API (bei den Tarifen „Assistent“ und „Profi“ – 111, bei „Agentur“ – 116, inklusive des Portfolio-Überblicks accounts_overview):

• Analytik und Statistiken – Kampagnenmetriken nach Zeiträumen und Segmenten: Geräte, Geschlecht, Alter, YAN-Plattformen, Geo; Suchanfragen; Impression-Share.

• Suche nach ineffizienten Ausgaben – Kampagnen mit ROAS < 1, Ausgaben ohne Conversions, überflüssige Plattformen und Keywords.

• Verwaltung – Pause/Fortsetzen, Tages- und Wochenbudget, Strategien (einschließlich Conversion-Strategien mit Ziel und Ziel-CPA/ROAS), negative Keywords, Keywords, Gebote und Anpassungen.

• Kampagnenerstellung von Grund auf – Kampagne → Anzeigengruppe → Anzeige mit Quicklinks und UTM.

• KI-Schlussfolgerungen – Prognose von Ausgaben und Conversions für 30 Tage, Diagnose von Einbrüchen (Traffic/CR/CPC), Erklärung von Veränderungen im Periodenvergleich mit Treibern, rangierte Top-Funde in Rubel, fertiges wöchentliches Briefing mit einem einzigen Aufruf.

• Wordstat – Keyword-Recherche mit Häufigkeiten.

• Für Agenturen – Portfolio-Überblick über alle Konten: Ausgaben, Gewinn, unnötige Ausgaben und Budgetrest pro Kunde in einer Antwort.

Schreibaktionen sind mit separaten Annotationen versehen – der Assistent und der Client sehen, was genau geändert wird, bevor die Korrektur angewendet wird. Fehler der Direct API werden korrekt behandelt, einschließlich „stiller“ Fehler (wenn die API mit 200 antwortet, die Korrektur aber nicht angewendet wurde).

MarketScore SEO – zweiter MCP, für Suchmaschinenoptimierung

Zum selben Konto gibt es einen separaten MCP-Server für SEO: Er dreht sich nicht um Werbung, sondern um die organische Suche – Yandex Webmaster, Google Search Console, Yandex Metrika, Topvisor und Wordstat in einem Assistenten.

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

Dies ist eine andere Adresse und ein anderes Abonnement: Der SEO-Tarif ist nicht in den Direct-Tarifen enthalten und umgekehrt. Direct-Tools erscheinen nicht auf der SEO-Adresse und umgekehrt.

Sie: Warum ist der Traffic aus der Suche in den letzten 28 Tagen eingebrochen?

Claude: Die Klicks sind von 940 auf 610 gefallen. Der Vergleich wird nur für Quellen berechnet, die beide Zeiträume gemessen haben: Search Console – ja, Webmaster – ja, Topvisor ist nicht verbunden, Positionen wurden nicht unabhängig überprüft. Der Haupteinbruch ist im Bereich /catalog: 18 Seiten sind aus der Yandex-Suche mit dem Grund „Duplikat“ gefallen, Webmaster sieht dies seit dem 3. August. Liste der Adressen anzeigen?

21 Tools, von denen nur drei etwas ändern (seo_add_keywords, seo_add_competitors, seo_request_recrawl) – die anderen lesen:

• Suchdaten – seo_overview (Klicks, Impressionen, CTR, durchschnittliche Position, Top-3/Top-10 und Periodenvergleich), seo_search_queries (Anfragen und Seiten von Webmaster und Search Console nach Geräten und Regionen), seo_positions (letzte Überprüfung durch Topvisor), seo_indexation (wie viele Seiten in der Yandex-Suche sind, was ausgeschlossen ist und aus welchem Grund), seo_metrika (Verhalten der Besucher aus der Suche und Zielerreichung), seo_landing_pages (Besuche und Anfragen aufgeschlüsselt nach Einstiegsseite).

• Arbeit mit der Website – seo_audit (Analyse der Indexierung, Technik, On-Page und Konkurrenz der Seiten mit Quellenangabe für jede Schlussfolgerung), seo_page_analysis (Geschwindigkeit, Core Web Vitals und On-Page-Signale der Seite), seo_opportunities (Anfragen nahe der Spitze, Seiten mit niedrigem CTR, Impressionen ohne Klicks, Kannibalisierung), seo_sitemaps (sehen Yandex und Google die Sitemap?), seo_url_inspection (Googles Urteil zu einer bestimmten Adresse), seo_request_recrawl (eine Adresse zur erneuten Indexierung an Yandex senden), seo_text_check (KI-Floskeln, Bürokratendeutsch und Keyword-Stuffing in fertigem russischem Text).

• Nachfrage – seo_keyword_demand: Häufigkeit, ähnliche Phrasen, Rauschmarkierung und Saisonalität aus Wordstat.

• Keywords und Überprüfungen – seo_keywords (was auf Positionsüberprüfung steht), seo_add_keywords (Phrasen zur Überprüfung einstellen), seo_positions_plan (Überprüfungsplan, Startkosten und Topvisor-Guthaben).

• Konkurrenten – seo_competitors (unsere Positionen neben ihren Positionen), seo_add_competitors (Konkurrenz-Websites zum Projekt hinzufügen).

• Projekt – seo_projects (Websites des Kontos) und seo_sources (was verbunden ist, was abgelaufen ist und was genau nicht mehr bekannt ist, solange die Quelle nicht funktioniert).

Was hier anders gemacht wurde als bei Wrappern über dieselben APIs:

• Die Antwort trägt eine Herkunftsangabe. Jede Zahl hat eine Quelle und ein Erfassungsdatum. Ein entzogener Zugriff auf Webmaster wird als Quellenausfall sichtbar, nicht als Null-Traffic: „keine Daten“ und „keine Probleme“ sind unterschiedliche Antworten, und das Modell sollte sie nicht verwechseln.

• Nicht durchgeführte Überprüfungen werden aufgelistet. Ein Audit mit einer stummen Quelle oder ohne bestätigte Rechte an der Website gibt eine Liste zurück, „was genau nicht überprüft wurde und warum“, und begrenzt die Bewertung nach oben, anstatt sie auf „alles in Ordnung“ herunterzusetzen.

• Die Grenze des Schreibens wurde an den Kosten gezogen. Der kostenpflichtige Start einer Positionsüberprüfung, die Änderung des Zeitplans, das Löschen von Keywords und Konkurrenten im Chat wurden bewusst nicht implementiert – sie belasten das Topvisor-Guthaben, und der Preis sollte vor der Belastung auf dem Bildschirm sichtbar sein. Zwei schreibende Tools verteuern die nächste Positionsüberprüfung, und der Assistent ist verpflichtet, diese Konsequenz vor dem Aufruf zu nennen.

• Was wir nicht versprechen: Es gibt keinen vollständigen Website-Crawl – es wird eine Seite pro Aufruf überprüft; die Text-Einzigartigkeit wird nicht überprüft (wir haben keine Quelle dafür); Positionen ohne verbundenes Topvisor werden nicht erfunden.

SEO-Tarife (separates Abonnement, 7 Tage kostenlos): „Start“ – 590 ₽/Monat (1 Website, 2 Audits, 20 Wordstat-Anfragen), „Profi“ – 1.490 ₽/Monat (5 Websites, 10 Audits, 200 Wordstat), „Agentur“ – 9.900 ₽/Monat (20 Websites, 60 Audits, 2.000 Wordstat). Alle 21 Tools sind in jedem aktiven SEO-Tarif verfügbar. Positionsüberprüfungen laufen über das Guthaben Ihres Topvisor-Kontos – es gibt keinen eigenen Aufschlag darauf.

Mehr Details: https://app.marketscore.ru/seo

Installation

Claude (Desktop, Web, Code) und ChatGPT – per Link

Fügen Sie den Remote-MCP-Connector hinzu:

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

Der Assistent öffnet den Login – autorisieren Sie sich per OAuth. Das Yandex-Token wird nicht an den Assistenten weitergegeben. Zwei Adressen können gleichzeitig hinzugefügt werden: Es sind unabhängige Connectors mit unabhängigen Abonnements.

Lokale MCP-Clients (Cursor, VS Code, Cline, Zed) – über eine Brücke

npx -y marketscore-direct-mcp

Beispielkonfiguration des MCP-Clients:

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

Tarife und Zugang

Der Connector benötigt ein Direct Manager-Konto. Bei der Registrierung – 7 Tage des Tarifs „Profi“ kostenlos (inklusive KI-Assistent in Claude/ChatGPT). Danach:

• „Assistent“ – 990 ₽/Monat: vollständiger MCP-Satz (111 Tools) für die Arbeit aus dem KI-Chat, bis zu 3 Direct-Konten. Ohne Web-Dashboard – nur Assistent.

• „Profi“ – 1.990 ₽/Monat: dieselben 111 Tools plus Web-Dashboard mit Analytik und Autopilot, bis zu 5 Direct-Konten.

• „Agentur“ – 9.900 ₽/Monat: 116 Tools (plus Portfolio-Überblick accounts_overview), bis zu 20 Konten.

• SEO – separate Tarifachse (590 / 1.490 / 9.900 ₽/Monat) und separate Connector-Adresse. Der Direct-Tarif gewährt keinen Zugang zu SEO-Tools und umgekehrt.

Ohne aktiven Tarif liefert der Server 0 Tools aus. Registrierung: https://app.marketscore.ru/register · Tarife: https://app.marketscore.ru/pricing · SEO: https://app.marketscore.ru/seo

Was ist der Unterschied zu Open-Source-Wrappern über die Direct API

Es gibt Self-Host-MCP-Wrapper über die Direct API (z. B. mcp-yandex-direct). Ein ehrlicher Vergleich:

Sicherheit

• Autorisierung – OAuth 2.1: Das Yandex-Token wird nicht an den Assistenten weitergegeben und liegt nicht in der Client-Konfiguration, es wird auf der Seite des Dienstes gespeichert.

• Ein Passwortwechsel des Direct Manager-Kontos widerruft alle ausgestellten MCP-Zugriffe.

• Schreibaktionen sind mit Annotationen versehen und werden auf der Seite des MCP-Clients bestätigt.

• Personenbezogene Daten werden auf Servern in der Russischen Föderation gespeichert (152-FZ).

FAQ

Ist das kostenlos? Die ersten 7 Tage – ja (Testversion des Tarifs „Profi“ bei der Registrierung). Danach – Tarif ab „Assistent“ (990 ₽/Monat, MCP-only) und höher.

Wo landet das Direct-Token? Es wird dem Dienst Direct Manager bei der OAuth-Verbindung ausgestellt und auf dessen Servern gespeichert. Der Assistent und der MCP-Client sehen das Token nicht.

Kann der Assistent etwas im Konto kaputt machen? Schreib-Tools sind separat markiert, und der MCP-Client fordert vor ihrem Aufruf eine Bestätigung an. Kampagnenpausen und Budgets berührt der Autopilot nicht selbst – nur auf Ihren Befehl hin.

Funktioniert es mit ChatGPT, Cursor, VS Code? Ja: Claude und ChatGPT werden direkt per URL verbunden, Cursor/VS Code/Cline/Zed – über dieses Paket (npx -y marketscore-direct-mcp).

Was ist der Unterschied zu kostenlosen MCP-Wrappern? Neben dem API-Zugriff – eine KI-Schlussfolgerungsschicht, Audit, Dashboard, Telegram-Bot und Portfolio-Überblick; das Yandex-Token wird nicht in der Konfiguration gespeichert. Details – Tabelle oben.

Funktioniert es ohne Abonnement? Nein – ohne aktiven Tarif liefert der Server 0 Tools aus.

Können Sie auch SEO? Ja, als separaten MCP-Server: https://app.marketscore.ru/api/mcp/seo – 21 Tools über Yandex Webmaster, Google Search Console, Metrika, Topvisor und Wordstat. Das Abonnement dafür ist getrennt von den Direct-Tarifen, es gibt eine 7-tägige Testversion.

Docker

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

Die OAuth-URL wird in stdout ausgegeben – der Browser aus dem Container wird nicht geöffnet, folgen Sie dem Link manuell. Die mcp-remote-Tokens leben in ~/.mcp-auth – mounten Sie ein Volume, um sich nicht bei jedem Start neu zu autorisieren.

Nützliche Links

• Was ist ein MCP-Server für Яндекс Директа: https://app.marketscore.ru/blog/mcp-server-yandex-direct

• KI für Яндекс Директа — Tools 2026: https://app.marketscore.ru/blog/ii-dlya-yandex-direkta-instrumenty-2026

• Verwaltung von Директом über Claude und ChatGPT: https://app.marketscore.ru/blog/upravlenie-yandex-direct-cherez-claude-chatgpt

• MCP-Server für Яндекс Вебмастера: https://app.marketscore.ru/blog/mcp-server-yandex-webmaster

• Neuronales Netz für SEO — was wirklich automatisiert wird: https://app.marketscore.ru/blog/nejroset-dlya-seo-avtomatizaciya

• Warum Klicks in Search Console nicht übereinstimmen: https://app.marketscore.ru/blog/search-console-kliki-ne-shodyatsya

Englisch

Direct Manager ist ein KI/MCP-Dienst für Yandex Direct (russische Suchwerbung). Dieses Paket ist ein dünner Connector zum gehosteten Direct Manager MCP-Server: Es ermöglicht Claude, ChatGPT oder jedem MCP-Client, Kampagnenanalysen zu lesen und Aktionen (Pause, Gebote, Budgets, negative Keywords) auf einem Yandex Direct Konto aus dem Chat auszuführen.

Installation (remote, Claude/ChatGPT): Connector-URL https://app.marketscore.ru/api/mcp hinzufügen und über OAuth anmelden.

Installation (lokale MCP-Clients — Cursor, VS Code, Cline, Zed):

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

Tools: bis zu 116 Tools auf Basis von Direct API v5 und Reports API — Kampagnenanalysen nach Gerät/Geschlecht/Alter/Placements/Geo, Suchanfragen, Impression Share, Erkennung verschwendeter Ausgaben (ROAS < 1), Kampagnenverwaltung (Pause, Budgets, Strategien, negative Keywords, Gebote), Aufbau von Kampagnen von Grund auf, KI-Einblicke (Ausgabenprognose, Rückgangsdiagnose, Änderungserklärung, wöchentliches Briefing), Wordstat-Keyword-Recherche und ein kontenübergreifender Portfolio-Überblick für Agenturen.

SEO-MCP (separater Server): https://app.marketscore.ru/api/mcp/seo — 21 Tools für organische Suche auf Basis von Yandex Webmaster, Google Search Console, Yandex Metrica, Topvisor und Wordstat: Suchleistung und Zeitraumvergleich, Suchanfragen und Seiten, Yandex-Indexierungsstatus mit Ausschlussgründen, Wachstumschancen (Near-Top-Suchanfragen, Seiten mit niedriger CTR, Impressionen ohne Klicks, Kannibalisierung), ein vollständiges SEO-Audit mit Quelle und Datum hinter jedem Befund, technische Analyse einer einzelnen Seite (PageSpeed, Core Web Vitals, On-Page-Signale), Sitemap-Status in beiden Suchmaschinen, Google-URL-Inspektion, Yandex-Re-Crawl-Anfragen, Wettbewerbspositionen, Keyword-Verwaltung in Topvisor, Landingpage-Conversions aus Metrica und eine deterministische russischsprachige Textprüfung. Nur drei Tools schreiben etwas; bezahlte Positionsprüfungen werden bewusst aus dem Chat herausgehalten. Jede Antwort trägt eine Herkunftsangabe — eine widerrufene Quelle erscheint als Quellenfehler, niemals als null Traffic. Separates Abonnement (590 / 1 490 / 9 900 ₽/Monat, 7-Tage-Testversion): https://app.marketscore.ru/seo

Preise: Ein Direct Manager Konto ist erforderlich; die Anmeldung beinhaltet eine 7-tägige kostenlose Pro-Testversion. Assistant — 990 ₽/Monat (111 Tools, nur Chat, 3 Direct-Konten); Pro — 1 990 ₽/Monat (111 Tools + Web-Dashboard, 5 Konten); Agentur — 9 900 ₽/Monat (116 Tools inkl. Portfolio-Übersicht, 20 Konten). SEO ist eine separate Tarifachse auf einer separaten Connector-URL. Ohne aktiven Tarif stellt der Server null Tools bereit.

FAQ:

Ist es kostenlos? Die ersten 7 Tage sind es (Pro-Testversion bei der Anmeldung); danach ist ein Abonnement erforderlich.

Wohin geht mein Yandex-Token? Er bleibt im Direct Manager Dienst — der Assistent und der MCP-Client sehen ihn nie, und er wird in keiner lokalen Konfiguration gespeichert.

Kann der Assistent mein Werbekonto beschädigen? Schreib-Tools sind separat gekennzeichnet, und der MCP-Client fragt vor der Ausführung um Bestätigung.

Schlüsselwörter: Yandex Direct, Яндекс Директ, MCP, Model Context Protocol, MCP server, PPC, ads management, campaign analytics, ROAS, negative keywords, Wordstat, Claude, ChatGPT, Cursor, AI marketing, SEO MCP, Yandex Webmaster, Яндекс Вебмастер, Google Search Console, Yandex Metrica, Topvisor, SEO audit, ИИ-менеджер для Яндекс Директа, ИИ для рекламы.

Lizenz

MIT — siehe LICENSE. Der Connector ist offen; der Direct Manager Dienst ist ein kostenpflichtiger SaaS. / Der Connector ist offen; der Direct Manager Dienst ist ein kostenpflichtiger SaaS.