Amazon Ads MCP Server

Ein Model Context Protocol (MCP)-Server, der Tools für die Interaktion mit der Amazon Advertising API bereitstellt. Dieser Server ermöglicht es KI-Assistenten, Amazon Ads-Kampagnen, Keywords, Leistungsdaten und mehr zu verwalten.

Funktionen

Dieser MCP-Server stellt die folgenden Tools bereit:

• get_profiles: Alle verfügbaren Amazon Ads-Profile/Konten auflisten

• get_campaigns: Werbekampagnen abrufen, optional gefiltert nach Status und Typ

• get_campaign_performance: Leistungsmetriken für Kampagnen abrufen (Impressionen, Klicks, Kosten, Umsatz)

• get_keywords: Keywords für Kampagnen oder Anzeigengruppen abrufen

• update_keyword_bid: Gebote für bestimmte Keywords aktualisieren

• create_campaign: Neue Werbekampagnen erstellen

• get_product_ads: Produktanzeigen für Kampagnen oder Anzeigengruppen abrufen

Related MCP server: TikTok Ads MCP Server

Voraussetzungen

1. Amazon Ads-Konto: Sie benötigen ein aktives Amazon Ads-Konto

2. API-Anmeldedaten: Registrieren Sie sich für den Zugriff auf die Amazon Ads API und erhalten Sie:

   • Client-ID

   • Client-Geheimnis

   • Aktualisierungstoken (Refresh Token)

Amazon Ads API-Anmeldedaten erhalten

Schritt 1: Registrieren Sie Ihre Anwendung

1. Gehen Sie zu Amazon Advertising API

2. Melden Sie sich mit Ihrem Amazon Ads-Konto an

3. Navigieren Sie zum Developer Center und erstellen Sie eine neue Anwendung

4. Sie erhalten eine Client-ID und ein Client-Geheimnis – bewahren Sie diese auf!

Schritt 2: Erhalten Sie Ihr Aktualisierungstoken

Wir stellen ein Hilfsskript bereit, um Ihr Aktualisierungstoken über den OAuth-Ablauf zu erhalten:

1. Erstellen Sie eine .env-Datei im Projektstamm:

   AMAZON_ADS_CLIENT_ID=your_client_id_here
   AMAZON_ADS_CLIENT_SECRET=your_client_secret_here

2. Führen Sie das OAuth-Hilfsskript aus:

   npm run get-token

3. Ihr Browser öffnet die Autorisierungsseite von Amazon

4. Melden Sie sich an und autorisieren Sie die Anwendung

5. Das Skript zeigt Ihr Aktualisierungstoken an – kopieren Sie es in Ihre .env-Datei

Schritt 3: Notieren Sie Ihre Region

Bestimmen Sie Ihre Werberegion:

• NA: Nordamerika (amazon.com)

• EU: Europa (amazon.co.uk, amazon.de usw.)

• FE: Fernost (amazon.co.jp usw.)

Installation

1. Klonen Sie dieses Repository:

git clone <your-repo-url>
cd amazonads-mcp

2. Installieren Sie die Abhängigkeiten:

npm install

3. Erstellen Sie das Projekt:

npm run build

Konfiguration

Umgebungsvariablen

Erstellen Sie eine .env-Datei oder setzen Sie die folgenden Umgebungsvariablen:

AMAZON_ADS_CLIENT_ID=your_client_id
AMAZON_ADS_CLIENT_SECRET=your_client_secret
AMAZON_ADS_REFRESH_TOKEN=your_refresh_token
AMAZON_ADS_REGION=NA  # Options: NA, EU, FE
AMAZON_ADS_SANDBOX=false  # Set to true for testing with sandbox API

Claude Desktop-Konfiguration

Fügen Sie diesen Server zu Ihrer Claude Desktop-Konfigurationsdatei hinzu:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "amazonads": {
      "command": "node",
      "args": ["/absolute/path/to/amazonads-mcp/build/index.js"],
      "env": {
        "AMAZON_ADS_CLIENT_ID": "your_client_id",
        "AMAZON_ADS_CLIENT_SECRET": "your_client_secret",
        "AMAZON_ADS_REFRESH_TOKEN": "your_refresh_token",
        "AMAZON_ADS_REGION": "NA"
      }
    }
  }
}

Verwendungsbeispiele

Sobald Sie in Claude Desktop konfiguriert sind, können Sie Claude bitten:

• „Zeig mir alle meine Amazon Ads-Kampagnen"

• „Wie sind die Leistungsmetriken für Kampagne 12345 vom 1. Januar bis 31. Januar?"

• „Liste alle Keywords für Kampagne 12345 auf"

• „Aktualisiere das Gebot für Keyword 67890 auf 1,50 $"

• „Erstelle eine neue Sponsored Products-Kampagne mit einem Tagesbudget von 50 $"

• „Zeig mir alle Produktanzeigen in Kampagne 12345"

Entwicklung

Projektstruktur

amazonads-mcp/
├── src/
│   ├── index.ts              # Main MCP server implementation
│   └── amazon-ads-client.ts  # Amazon Ads API client
├── build/                     # Compiled JavaScript output
├── package.json
├── tsconfig.json
└── README.md

Erstellen

npm run build

Entwicklungsmodus

Auf Änderungen achten und automatisch neu erstellen:

npm run watch

Testen des Servers

Führen Sie den Server direkt aus:

npm start

Der Server kommuniziert über stdio und erwartet MCP-Protokollnachrichten.

API-Abdeckung

Dieser Server unterstützt derzeit:

• Sponsored Products: Volle Unterstützung für Kampagnen, Keywords und Produktanzeigen

• Sponsored Brands: Kampagnenverwaltung (teilweise Unterstützung)

• Sponsored Display: Kampagnenverwaltung (teilweise Unterstützung)

• Reporting: Grundlegende Leistungsmetriken (vereinfachte Implementierung)

Wichtige Hinweise

1. Ratenbegrenzung: Die Amazon Ads API hat Ratenbegrenzungen. Der Client implementiert derzeit keine Logik zur Ratenbegrenzung.

2. Reporting-API: Das Tool get_campaign_performance verwendet eine vereinfachte Implementierung. Für den Produktionseinsatz sollten Sie den vollständigen asynchronen Reporting-Ablauf implementieren:

   • Berichtsanfrage erstellen

   • Auf Abschluss des Berichts warten

   • Bericht herunterladen und analysieren

3. Fehlerbehandlung: API-Fehler werden an den Aufrufer zurückgegeben. Stellen Sie sicher, dass die Anmeldedaten korrekt konfiguriert sind, um Authentifizierungsfehler zu vermeiden.

4. Regionen: Stellen Sie sicher, dass Sie die richtige Region (NA, EU, FE) basierend auf Ihrem Amazon Ads-Konto festlegen.

Sicherheit

• Committen Sie niemals Ihre .env-Datei und geben Sie keine API-Anmeldedaten preis

• Aktualisierungstokens sollten sicher gespeichert werden

• Erwägen Sie die Implementierung einer Anmeldedatenrotation für den Produktionseinsatz

Ressourcen

• Amazon Ads API-Dokumentation

• Model Context Protocol-Dokumentation

• MCP TypeScript SDK

Lizenz

MIT

Mitwirken

Beiträge sind willkommen! Bitte zögern Sie nicht, einen Pull Request einzureichen.