Marketing Miner MCP Server

MCP-Server für die Marketing Miner Profilers API. Verbindet Claude, Cursor, Windsurf und andere MCP-Clients mit der Keyword-Recherche und Website-Analyse von Marketing Miner.

Verfügbare Tools

Jedes Tool gibt markdown (Standard, menschenlesbar) oder json (response_format: "json") zurück, sowie structuredContent mit allen API-Feldern. Jedes Tool deklariert ein outputSchema für die clientseitige Validierung.

Installation

Holen Sie sich ein API-Token von marketingminer.com/en/features/api und wählen Sie dann eine der folgenden Optionen.

Option A — Claude Code CLI Einzeiler (empfohlen, plattformübergreifend)

Funktioniert unter macOS, Windows und Linux — die Claude Code CLI verwaltet den Speicherort der Konfigurationsdatei für Sie.

claude mcp add marketing-miner \
  -s user \
  -e MARKETING_MINER_API_TOKEN=YOUR_TOKEN \
  -- npx -y github:lukaskostka/marketing-miner-mcp

• -s user → installiert global (verfügbar in jedem Projekt)

• -e → setzt das API-Token als Umgebungsvariable

• Ersetzen Sie YOUR_TOKEN durch Ihr tatsächliches Marketing Miner API-Token

Zum späteren Entfernen: claude mcp remove marketing-miner -s user.

Option B — npx direkt von GitHub (kein Klonen erforderlich)

Das Repository enthält den gebauten dist/-Ordner, sodass npx ihn direkt ausführen kann.

Konfiguration für Claude Desktop / Cursor / Windsurf:

{
  "mcpServers": {
    "marketing-miner": {
      "command": "npx",
      "args": ["-y", "github:lukaskostka/marketing-miner-mcp"],
      "env": {
        "MCP_TRANSPORT": "stdio",
        "MARKETING_MINER_API_TOKEN": "your_token_here"
      }
    }
  }
}

Option C — Repository klonen (für Entwicklung / Anpassung)

git clone https://github.com/lukaskostka/marketing-miner-mcp.git
cd marketing-miner-mcp
npm install
npm run build

Verweisen Sie dann Ihren MCP-Client auf die gebaute Binärdatei:

{
  "mcpServers": {
    "marketing-miner": {
      "command": "node",
      "args": ["/absolute/path/to/marketing-miner-mcp/dist/index.js"],
      "env": {
        "MCP_TRANSPORT": "stdio",
        "MARKETING_MINER_API_TOKEN": "your_token_here"
      }
    }
  }
}

Lokal ausführen mit MARKETING_MINER_API_TOKEN=xxx npm start (stdio, Standard) oder MCP_TRANSPORT=http MARKETING_MINER_API_TOKEN=xxx npm start (Streamable HTTP auf Port 8000).

Option D — Docker (selbstgehostetes HTTP)

git clone https://github.com/lukaskostka/marketing-miner-mcp.git
cd marketing-miner-mcp
docker build -t marketing-miner-mcp .
docker run -p 8000:8000 -e MARKETING_MINER_API_TOKEN=your_token_here marketing-miner-mcp

Verbindung von einem Remote-Client über eine Streamable HTTP-URL (siehe Verbindung von einem MCP-Client unten).

Konfiguration

Alternative Token-Namen: MARKETING_MINER_API_KEY, MARKETING_MINER_TOKEN, MM_API_TOKEN, MM_API_KEY.

Konfiguration des Remote-HTTP-Clients

Wenn Sie den Server über Streamable HTTP (Option D oben oder einen beliebigen Remote-Host) betreiben, verbinden sich MCP-Clients nur über die URL:

{
  "mcpServers": {
    "marketing-miner": {
      "url": "https://your-host.example.com/mcp"
    }
  }
}

Anwendungsbeispiele

1. Suchvolumen für ein einzelnes Keyword:

"Was ist das Suchvolumen und die Saisonalität von marketing in CZ?" → marketing_miner_get_search_volume({lang:"cs", keyword:"marketing"})

2. Batch-Verarbeitung:

"Vergleiche das Suchvolumen von SEO-Begriffen" → marketing_miner_batch_search_volume({lang:"cs", keywords:["seo","ppc","google ads","content marketing"]})

3. Fragen-Recherche für FAQ:

"Finde Fragen rund um hypoteka" → marketing_miner_get_keyword_suggestions({lang:"cs", keyword:"hypoteka", suggestions_type:"questions", limit:50})

4. Paginierung von Vorschlägen:

Nächste Seite abrufen → marketing_miner_get_keyword_suggestions({lang:"cs", keyword:"hypoteka", limit:50, offset:50})

5. Wettbewerberanalyse:

"Wie viel Traffic erhält seznam.cz?" → marketing_miner_get_website_stats({lang:"cs", type:"domain", target:"seznam.cz"})

6. Wettbewerber-Trends:

"Vergleiche Traffic-Trends von seznam.cz vs. idnes.cz" → marketing_miner_get_website_stats_range({lang:"cs", type:"domain", target:"seznam.cz", period:"monthly", competitors:["idnes.cz"]})

Unterstützte Märkte

cs, sk, pl, hu, ro, gb, us

Architektur

• Node 18+, TypeScript (strikt), ESM

• MCP SDK ^1.18 (McpServer.registerTool, Zod-Eingabe- + Ausgabe-Schemas, Tool-Annotationen)

• Streamable HTTP (zustandsloser Transport pro Anfrage) + stdio

• Zod-Laufzeitvalidierung mit .strict() (lehnt unbekannte Schlüssel ab)

• structuredContent + outputSchema bei jedem Tool

• Antwortkürzung für sowohl Markdown (25k Zeichen) als auch zu große structuredContent-Arrays

• Optionaler DNS-Rebinding-Schutz (Origin-Header-Validierung bei Bindung an Loopback)

Lizenz

MIT