lukaskostka99-marketing-miner-mcp

Marketing Miner MCP サーバー

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

利用可能なツール

ツール	エンドポイント	説明
marketing_miner_get_search_volume	GET /keywords/search-volume-data	1 つのキーワードの検索ボリューム、CPC、前年比、季節性
marketing_miner_batch_search_volume	POST /keywords/search-volume-data	1〜1000 件のキーワードを一括処理
marketing_miner_get_keyword_suggestions	GET /keywords/suggestions	難易度と SERP 機能を含むキーワード候補（質問／新着／トレンド）。レスポンスの has_more／next_offset とともに limit + offset をサポートします。
marketing_miner_get_website_stats	GET /websites/stats	推定トラフィック、キーワード数、result_type 別の内訳
marketing_miner_get_website_stats_range	GET/POST /websites/stats-range	トラフィックの過去の推移と競合他社との比較

各ツールは 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_TOKEN	—	必須。 marketingminer.com/en/features/api から取得した API トークン
MCP_TRANSPORT	stdio	stdio（ローカルの MCP クライアント）または http（ホスト型デプロイメント向けの Streamable HTTP）
HOST	0.0.0.0	HTTP のバインド先ホスト
PORT	8000	HTTP ポート
MCP_HTTP_PATH	/mcp	HTTP パス

代替のトークン名：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