Авито Реклама MCP

A1 Авито Реклама MCP verbindet eine KI-Anwendung mit dem Werbekonto von Авито Реклама. Es hilft, Kampagnen und Statistiken zu prüfen, Budget und Gebot einer Gruppe zu verwalten, mit Agentur-Guthaben, Zugriffsrechten und ORD-Dokumenten zu arbeiten – in natürlicher Sprache.

Dies ist nicht die Verkäufer-API von Avito: Der Server arbeitet nicht mit Produkten, Nachrichten, Bestellungen oder der Bewerbung von Verkäufer-Anzeigen. Er arbeitet ausschließlich mit Media- und Performance-Kampagnen des Werbekontos von Авито Реклама.

• 25 Tools. Kampagnen, Gruppen, Creatives, Statistiken, Guthaben, Unterkonten, Benutzer und ORD-Dokumente.

• Schmale Kampagnenänderungen. Die API erlaubt nur die Änderung von Budget und Gebot einer Gruppe; Kampagnen, Gruppen und Creatives können nicht erstellt, bearbeitet, pausiert oder gelöscht werden.

• Irreversible Operationen sind sichtbar. Geld- oder Bonusüberweisungen, das Löschen eines Benutzers und technische API-Anfragen sind als destruktiv markiert.

• Wöchentliches API-Budget. Jeder Aufruf verbraucht Punkte; den Restbetrag apiPointBalance gibt der Server mit dem Ergebnis zurück.

Beginnen Sie mit einer Anfrage, die nur Daten liest:

Zeige die Kampagnen meines Avito-Kontos und die Ausgaben der letzten Woche nach Anzeigengruppen.

Server verbinden · Szenarien ansehen · Technische Dokumentation öffnen

In einer Minute in Aktion sehen

Sie: Zeige die Kampagnen meines Avito-Kontos und die Ausgaben der letzten Woche nach Anzeigengruppen.

Assistent: Zeigt Kampagnen, Gruppen, Ausgaben, Klicks und Impressionen. Es ändert sich nichts.

Sie: Bereite eine Gebotsänderung für Gruppe 101 auf 350 Rubel vor.

Assistent: Zeigt Konto, Gruppe, aktuelles und neues Gebot und fragt dann nach Bestätigung.

Sie: Ich bestätige.

Assistent: Ändert nur das Gebot dieser Gruppe. Kampagne, Creatives und andere Gruppen bleiben unverändert.

Related MCP server: VK Ads MCP

Inhalt

• Schnellstart

• Was man beauftragen kann

• Was sich ändern kann

• Zugriff erhalten

• Einrichtung

• Daten, Limits und Hintergrundarbeit

• Technische Dokumentation

• Support

Schnellstart

Erforderlich sind Node.js 20+, Client Key, Client Secret und die ID des Werbekontos von Авито Реклама. Für die Vergabe von Zugriffsrechten wird die Rolle eines Kontoadministrators benötigt.

1. Erhalten Sie Zugriff.

2. Fügen Sie den Server in die KI-Anwendung ein.

3. Senden Sie die sichere erste Anfrage oben.

Gehen Sie in Settings → Plugins → MCP servers auf Add server und fügen Sie npx -y mcp-avito-ads@latest mit AVITO_ADS_CLIENT_ID, AVITO_ADS_CLIENT_SECRET und AVITO_ADS_ACCOUNT_ID hinzu.

codex mcp add avito-ads \
  --env AVITO_ADS_CLIENT_ID=your_client_key \
  --env AVITO_ADS_CLIENT_SECRET=your_client_secret \
  --env AVITO_ADS_ACCOUNT_ID=your_account_id \
  -- npx -y mcp-avito-ads@latest
codex mcp list

Codex MCP-Dokumentation

claude mcp add \
  --env AVITO_ADS_CLIENT_ID=your_client_key \
  --env AVITO_ADS_CLIENT_SECRET=your_client_secret \
  --env AVITO_ADS_ACCOUNT_ID=your_account_id \
  --transport stdio --scope user avito-ads \
  -- npx -y mcp-avito-ads@latest
claude mcp list

Claude Code MCP-Dokumentation

Öffnen Sie Settings → Developer → Edit Config und fügen Sie hinzu:

{"mcpServers":{"avito-ads":{"command":"npx","args":["-y","mcp-avito-ads@latest"],"env":{"AVITO_ADS_CLIENT_ID":"your_client_key","AVITO_ADS_CLIENT_SECRET":"your_client_secret","AVITO_ADS_ACCOUNT_ID":"your_account_id"}}}}

Wenn Edit Config nicht verfügbar ist, bearbeiten Sie ~/Library/Application Support/Claude/claude_desktop_config.json auf macOS oder %APPDATA%\Claude\claude_desktop_config.json auf Windows. Claude Desktop MCP-Dokumentation

Fügen Sie {"mcpServers":{"avito-ads":{"type":"stdio","command":"npx","args":["-y","mcp-avito-ads@latest"],"env":{"AVITO_ADS_CLIENT_ID":"your_client_key","AVITO_ADS_CLIENT_SECRET":"your_client_secret","AVITO_ADS_ACCOUNT_ID":"your_account_id"}}}} in ~/.cursor/mcp.json auf macOS/Linux oder %USERPROFILE%\.cursor\mcp.json auf Windows ein. Cursor MCP-Dokumentation

Starten Sie MCP: Open User Configuration und fügen Sie hinzu:

{"servers":{"avito-ads":{"type":"stdio","command":"npx","args":["-y","mcp-avito-ads@latest"],"env":{"AVITO_ADS_CLIENT_ID":"${input:avito_client_id}","AVITO_ADS_CLIENT_SECRET":"${input:avito_client_secret}","AVITO_ADS_ACCOUNT_ID":"${input:avito_account_id}"}}},"inputs":[{"type":"promptString","id":"avito_client_id","description":"Avito Ads Client Key"},{"type":"promptString","id":"avito_client_secret","description":"Avito Ads Client Secret","password":true},{"type":"promptString","id":"avito_account_id","description":"ID рекламного аккаунта"}]}

Überprüfen Sie den Server mit dem Befehl MCP: List Servers. VS Code MCP-Dokumentation

Was man beauftragen kann

• Zeige Kampagnen, Gruppen, Creatives, Status und Statistiken für einen Zeitraum.

• Vergleiche Ausgaben, CTR, CPM, CPC oder VTR nach Gruppen und Creatives.

• Prüfe Guthaben und Unterkonten der Agentur.

• Bereite eine Änderung von Budget oder Gebot einer Gruppe vor.

• Erstelle einen Werbetreibenden und einen ORD-Vertrag, nachdem du die übermittelten Daten zuerst anzeigst.

• Füge einen Benutzer hinzu, ändere seine Rolle oder entziehe den Zugriff nach Bestätigung.

Was sich ändern kann

Kampagnen, Gruppen und Creatives können über diese API nicht erstellt, bearbeitet, pausiert, archiviert oder gelöscht werden. Creatives und Targeting sind ebenfalls nicht beschreibbar.

Zugriff erhalten

1. Öffnen Sie das Werbekonto von Авито Реклама mit einem Benutzer mit Administratorrolle.

2. Erstellen Sie eine API-Anwendung und kopieren Sie Client Key und Client Secret.

3. Kopieren Sie die ID des Werbekontos.

4. Übergeben Sie sie als AVITO_ADS_CLIENT_ID, AVITO_ADS_CLIENT_SECRET, AVITO_ADS_ACCOUNT_ID.

Der Server erhält ein Bearer-Token über OAuth2 client_credentials. Bewahren Sie Client Secret wie ein Passwort auf. Die Konton-ID ist durch die Konfiguration festgelegt: Tools können nicht versehentlich auf ein anderes Konto wechseln.

Für eine Probe von Schreibvorgängen kann AVITO_ADS_ENVIRONMENT=sandbox gesetzt werden. Die Sandbox ist keine vollständige Kopie der Produktion: Zum Beispiel ist das Guthaben dort nicht verfügbar.

Einrichtung

Daten, Limits und Hintergrundarbeit

• Wöchentliches Punktbudget. Punkte werden montags um 00:00 UTC aufgefüllt. Ein langer Bericht über bis zu 100 Tage ist in der Regel sparsamer als eine Reihe kurzer; der Server zeigt apiPointBalance mit jedem Ergebnis.

• Temporäre Fehler. Bei 429 werden Retry-After und der Punktestand im Fehler zurückgegeben. Schreibvorgänge werden nach Netzwerk- oder 5xx-Fehlern nicht wiederholt, um Geld nicht doppelt zu überweisen.

• Keine ständige Überwachung. Der Server arbeitet nur bei Aufruf. Wenn die KI-Anwendung geplante Aufgaben unterstützt, kann sie regelmäßig Statistiken und Punktestand sammeln.

• Anonyme Telemetrie. Sie enthält keine Geheimnisse, Kontodaten, Argumente und Prompts; Deaktivierung: ASKADS_TELEMETRY=0.

Technische Dokumentation

• Katalog der MCP-Fähigkeiten — Seiten zu Benutzeraufgaben für jedes Tool.

• Alle Tools und Parameter

• Entwicklungsdokumentation

• Veröffentlichungsdokumentation

• Offizielles Avito Ads SDK

Support

Fehler gefunden oder Szenario fehlt? Issue erstellen oder Telegram schreiben.