MCP-сервер Marketing Miner

MCP-сервер для API Marketing Miner Profilers. Подключает Claude, Cursor, Windsurf и другие MCP-клиенты к инструментам исследования ключевых слов и веб-аналитики Marketing Miner.

Доступные инструменты

Каждый инструмент возвращает markdown (по умолчанию, для чтения человеком) или json (response_format: "json"), а также structuredContent со всеми полями API. Каждый инструмент объявляет outputSchema для валидации на стороне клиента.

Установка

Получите API-токен на marketingminer.com/en/features/api, затем выберите один из вариантов ниже.

Вариант A — Одной командой через Claude Code CLI (рекомендуется, кроссплатформенно)

Работает в macOS, Windows и Linux — Claude Code CLI сам управляет расположением файла конфигурации.

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

• -s user → устанавливает глобально (доступно из любого проекта)

• -e → устанавливает API-токен как переменную окружения

• Замените YOUR_TOKEN на ваш реальный API-токен Marketing Miner

Для удаления позже: claude mcp remove marketing-miner -s user.

Вариант B — npx напрямую из GitHub (клонирование не требуется)

Репозиторий содержит собранную папку dist/, поэтому npx может запустить его напрямую.

Конфигурация 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"
      }
    }
  }
}

Вариант C — клонирование репозитория (для разработки / кастомизации)

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

Затем укажите вашему MCP-клиенту путь к собранному бинарному файлу:

{
  "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"
      }
    }
  }
}

Запустите локально с помощью MARKETING_MINER_API_TOKEN=xxx npm start (stdio, по умолчанию) или MCP_TRANSPORT=http MARKETING_MINER_API_TOKEN=xxx npm start (Streamable HTTP на порту 8000).

Вариант D — Docker (самостоятельный 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

Подключайтесь с удаленного клиента через URL Streamable HTTP (см. Подключение из MCP-клиента ниже).

Конфигурация

Альтернативные названия токенов: MARKETING_MINER_API_KEY, MARKETING_MINER_TOKEN, MM_API_TOKEN, MM_API_KEY.

Конфигурация удаленного HTTP-клиента

Если вы запускаете сервер через Streamable HTTP (вариант D выше или любой удаленный хост), MCP-клиенты подключаются только по URL:

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

Примеры использования

1. Объем поиска для одного ключевого слова:

"Какой объем поиска и сезонность у marketing в CZ?" → marketing_miner_get_search_volume({lang:"cs", keyword:"marketing"})

2. Пакетная обработка:

"Сравни объем поиска SEO-терминов" → marketing_miner_batch_search_volume({lang:"cs", keywords:["seo","ppc","google ads","content marketing"]})

3. Исследование вопросов для FAQ:

"Найди вопросы по теме hypoteka" → marketing_miner_get_keyword_suggestions({lang:"cs", keyword:"hypoteka", suggestions_type:"questions", limit:50})

4. Пагинация предложений:

Получить следующую страницу → marketing_miner_get_keyword_suggestions({lang:"cs", keyword:"hypoteka", limit:50, offset:50})

5. Анализ конкурентов:

"Сколько трафика получает seznam.cz?" → marketing_miner_get_website_stats({lang:"cs", type:"domain", target:"seznam.cz"})

6. Тренды конкурентов:

"Сравни тренды трафика seznam.cz и idnes.cz" → marketing_miner_get_website_stats_range({lang:"cs", type:"domain", target:"seznam.cz", period:"monthly", competitors:["idnes.cz"]})

Поддерживаемые рынки

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

Архитектура

• Node 18+, TypeScript (строгий режим), ESM

• MCP SDK ^1.18 (McpServer.registerTool, схемы ввода/вывода Zod, аннотации инструментов)

• Streamable HTTP (транспорт без сохранения состояния для каждого запроса) + stdio

• Валидация Zod во время выполнения с .strict() (отклоняет неизвестные ключи)

• structuredContent + outputSchema для каждого инструмента

• Усечение ответов как для markdown (25 тыс. символов), так и для слишком больших массивов structuredContent

• Опциональная защита от DNS-rebinding (валидация заголовка Origin при привязке к loopback)

Лицензия

MIT