keywordminer

Name: keywordminer
Author: CloudCorpRecords

本地服务

github.com/CloudCorpRecords商业与营销01 周前更新

代码仓库

关于 keywordminer

keywordminer 通过 MCP 工具和命令行提供 Marketing Miner Profiler 数据，涵盖关键词指标与建议，以及网站流量估算和历史对比。

主要功能

01单个及批量关键词指标
02分页获取关键词建议
03网站流量估算
04历史趋势及竞品对比
05Markdown 或 JSON 响应

适用场景

01查看搜索量和 CPC
02按类型查找关键词建议
03跟踪网站流量变化
04与竞品比较流量

MCP 相关

提供 Marketing Miner 工具，用于查询关键词指标与建议、网站统计和历史流量范围。调用需要 Marketing Miner API 令牌。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "cloudcorprecords-keywordminer": {
      "command": "npx",
      "args": [
        "-y",
        "@reneturcios/keywordminer"
      ]
    }
  }
}

启动命令npx -y @reneturcios/keywordminer

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@reneturcios/keywordminer0.1.0stdio

ocighcr.io/cloudcorprecords/keywordminer:0.1.0stdio

工具

收录的工具列表 · 更新于 1 周前

参数	类型	必填	说明
lang	string	是	市场／语言代码，例如 "cs"、"sk"、"pl"、"hu"、"ro"、"gb" 或 "us"
keyword	string	是	要查询的关键词
response_format	enum	否	响应格式："markdown"（默认值，便于阅读）或 "json"markdown \| json

详细介绍

keywordminer

来自 Marketing Miner Profilers API 的关键词和网站分析，封装为 MCP 工具：单个关键词或最多 1000 个关键词的批次搜索量、CPC、同比变化和季节性；关键词建议（问题、新增、趋势，可分页）；以及具有历史范围和可选竞品比较的网站流量估算。市场： 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，发生运行时错误时为 1（包括缺少令牌或上游 HTTP 错误），发生用法错误时为 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 — 查询单个关键词的搜索量。必需参数：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