Marketing Miner MCPサーバー

Marketing Miner Profilers API用のMCPサーバーです。Claude、Cursor、WindsurfなどのMCPクライアントをMarketing Minerのキーワード調査やウェブサイト分析に接続します。

利用可能なツール

各ツールは markdown（デフォルト、人間が読みやすい形式）または json (response_format: "json") を返し、さらにすべてのAPIフィールドを含む structuredContent を返します。各ツールはクライアント側の検証用に outputSchema を宣言しています。

インストール

marketingminer.com/en/features/api から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 を実際のMarketing Miner APIトークンに置き換えてください

後で削除する場合: claude mcp remove marketing-miner -s user

オプション B — GitHubから直接 npx を実行（クローン不要）

リポジトリにはビルド済みの 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 (ポート8000でStreamable HTTPを実行)。

オプション 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

Streamable HTTP URL経由でリモートクライアントから接続します（以下の「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. 単一キーワードの検索ボリューム:

"CZにおける marketing の検索ボリュームと季節性を教えて" → 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 (strict)、ESM

• MCP SDK ^1.18 (McpServer.registerTool、Zod入力 + 出力スキーマ、ツールアノテーション)

• Streamable HTTP (リクエストごとのステートレス転送) + stdio

• .strict() を使用したZodランタイム検証（未知のキーを拒否）

• すべてのツールで structuredContent + outputSchema を使用

• Markdown（25k文字）および巨大な structuredContent 配列のレスポンス切り捨て

• オプションのDNSリバインディング保護（ループバックにバインドされている場合の Origin ヘッダー検証）

ライセンス

MIT