keywordminer

keywordminer

Marketing Miner Profilers API によるキーワードとウェブサイトの分析を、MCP ツールとして提供します。検索ボリューム、CPC、 前年比の変化、季節性を、単一キーワードまたは最大 1000 件のバッチで取得できます。また、キーワード候補（質問／新着／ トレンド、ページネーション対応）や、過去の期間を指定したウェブサイトのトラフィック推定値と、オプションの競合他社比較も取得できます。対象市場： cs、sk、pl、hu、ro、gb、us。

すべてのツールで、任意の response_format を指定できます。markdown （デフォルト）では API ペイロードを読みやすい概要として表示し、 json では API JSON を構造化テキストとして返します。

設定

API トークンは環境変数から取得します。

• MARKETING_MINER_API_TOKEN（代替変数： MARKETING_MINER_API_KEY、MARKETING_MINER_TOKEN、 MM_API_TOKEN、MM_API_KEY）

トークンが設定されていない場合、すべての呼び出しで MARKETING_MINER_API_TOKEN を明示したエラーを返します。データを捏造することはありません。上流のベース URL のデフォルトは https://profilers-api.marketingminer.com で、 MARKETING_MINER_API_BASE で上書きできます。

CLI

export MARKETING_MINER_API_TOKEN=...
npx @reneturcios/keywordminer search-volume cs "seo nastroje"
npx @reneturcios/keywordminer search-volume us "running shoes" --json
npx @reneturcios/keywordminer --version

終了コード：成功時は 0、トークンの欠落や上流の HTTP エラーなどの実行時エラーでは 1、使用方法の エラーでは 2 です。

MCP サーバー

npx -y @reneturcios/keywordminer mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "keywordminer": {
      "command": "npx",
      "args": ["-y", "@reneturcios/keywordminer", "mcp"],
      "env": { "MARKETING_MINER_API_TOKEN": "..." }
    }
  }
}

ツール

• marketing_miner_get_search_volume — 1 つのキーワードの検索ボリュームです。 lang、keyword（必須）；response_format。 上流：GET /keywords/search-volume-data。
• marketing_miner_batch_search_volume — キーワードのバッチの検索ボリュームです。 lang、keywords（必須）；response_format。 上流：POST /keywords/search-volume-data。
• marketing_miner_get_keyword_suggestions — シードキーワードの候補です。 lang、keyword（必須）； suggestions_type、limit、offset、response_format。 上流：GET /keywords/suggestions。
• marketing_miner_get_website_stats — 対象のトラフィック推定値です。 lang、type、target（必須）； response_format。上流：GET /websites/stats。
• marketing_miner_get_website_stats_range — 競合他社との比較も可能な、過去の トラフィック推移です。lang、type、target（必須）；period、competitors、 response_format。上流：GET/POST /websites/stats-range （競合他社が指定された場合は POST）。

Docker

docker run -i -e MARKETING_MINER_API_TOKEN=... ghcr.io/cloudcorprecords/keywordminer

開発

npm install
npm run build   # tsc -> dist/
npm test        # tsx --test test/*.test.ts (fake fetch, no network)
npm run dev     # run the CLI from source

ライセンス

MIT — Copyright (c) 2026 Rene Turcios