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 — 直接通过 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（端口 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. 单个关键词的搜索量：

"What is the search volume and seasonality of marketing in CZ?" → marketing_miner_get_search_volume({lang:"cs", keyword:"marketing"})

2. 批量处理：

"Compare search volume of SEO terms" → marketing_miner_batch_search_volume({lang:"cs", keywords:["seo","ppc","google ads","content marketing"]})

3. FAQ 问题研究：

"Find questions around hypoteka" → marketing_miner_get_keyword_suggestions({lang:"cs", keyword:"hypoteka", suggestions_type:"questions", limit:50})

4. 分页获取建议：

Fetch next page → marketing_miner_get_keyword_suggestions({lang:"cs", keyword:"hypoteka", limit:50, offset:50})

5. 竞争对手分析：

"How much traffic does seznam.cz get?" → marketing_miner_get_website_stats({lang:"cs", type:"domain", target:"seznam.cz"})

6. 竞争对手趋势：

"Compare traffic trends of seznam.cz vs. 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

• 使用 .strict() 进行 Zod 运行时验证（拒绝未知键）

• 每个工具均包含 structuredContent + outputSchema

• 针对 markdown（25k 字符）和超大 structuredContent 数组的响应截断

• 可选的 DNS 重绑定保护（绑定到回环地址时进行 Origin 标头验证）

许可证

MIT