Lukaskostka99 Marketing Miner Mcp

ai.smithery由 smithery.ai 發布官方發布者v1.14.0更新於 Oct 24, 2026

Discover high-impact keyword ideas across Central and Eastern European and English markets. Analyz…

發布方自己的服務：222wcnm Bilistalkermcp

已驗證Streamable HTTP可網頁執行網頁搜尋與抓取資料與分析商業與電商

概覽

AI 產生的概覽

讓助理取得 Marketing Miner 的關鍵字研究與網站流量分析資料，涵蓋中東歐及英語市場。

可以做什麼
包裝 Marketing Miner Profilers API，提供五個工具：單一關鍵字的搜尋量、CPC、年增率與季節性；1 至 1000 個關鍵字的批次搜尋量；關鍵字建議（問題、新詞、趨勢詞）及難度與 SERP 特徵，支援 limit/offset 分頁；網站預估流量與關鍵字數量；以及含競爭對手比較的歷史流量趨勢。結果以 markdown 或 JSON 回傳，並附帶結構化內容與每個工具的輸出結構定義。
適用情境
適合 SEO 與內容規劃情境，例如助理需要查詢 cs、sk、pl、hu、ro、gb、us 等市場的搜尋量、關鍵字靈感或競爭對手流量估計。若你已有 Marketing Miner API 權杖，並希望在 MCP 用戶端內直接查詢，值得加入。
執行需求
需要 Marketing Miner API 權杖，透過 MARKETING_MINER_API_TOKEN 提供（也可使用 MARKETING_MINER_API_KEY、MARKETING_MINER_TOKEN、MM_API_TOKEN、MM_API_KEY）。託管端點要求在 Authorization 標頭中提供 Bearer 權杖。本機執行需要 Node.js 18+ 或 Docker，並需要連線至 Marketing Miner API 的網路。
安裝前請注意
API 權杖是計費憑證，會以明文透過環境變數或 Authorization 標頭傳遞，請避免寫入共用設定與日誌。這些工具只讀取 Marketing Miner 資料，但查詢詞與關鍵字會傳送給該第三方服務。批次呼叫最多可提交 1000 個關鍵字，可能消耗 API 配額。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Lukaskostka99 Marketing Miner Mcp，將其新增到工作區。
  2. 連接 Authorization token 憑證。它們會被私密儲存，絕不會在公開頁面上展示。
  3. 為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式，或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南，先向你展示發布者、端點和登入方式，經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/ai.smithery%2Flukaskostka99-marketing-miner-mcp/install.md，並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前，先告訴我它的發布者、端點和登入方式，等我確認。不要把 API 金鑰寫進命令或我會提交的檔案；問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "lukaskostka99-marketing-miner": {
      "type": "http",
      "url": "https://server.smithery.ai/@lukaskostka99/marketing-miner-mcp/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

Marketing Miner MCP Server

MCP server for the Marketing Miner Profilers API. Connects Claude, Cursor, Windsurf and other MCP clients to Marketing Miner keyword research and website analytics.

Available tools

ToolEndpointDescription
marketing_miner_get_search_volumeGET /keywords/search-volume-dataSearch volume + CPC + YoY + seasonality for a single keyword
marketing_miner_batch_search_volumePOST /keywords/search-volume-dataBatch processing of 1–1000 keywords
marketing_miner_get_keyword_suggestionsGET /keywords/suggestionsKeyword suggestions (questions / new / trending) with difficulty and SERP features. Supports limit + offset with has_more / next_offset in the response.
marketing_miner_get_website_statsGET /websites/statsEstimated traffic, keyword count, breakdown by result_type
marketing_miner_get_website_stats_rangeGET/POST /websites/stats-rangeHistorical traffic trend + competitor comparison

Every tool returns markdown (default, human-readable) or json (response_format: "json"), plus structuredContent with all API fields. Each tool declares an outputSchema for client-side validation.

Installation

Get an API token from marketingminer.com/en/features/api, then pick one of the options below.

Option A — Claude Code CLI one-liner (recommended, cross-platform)

Works on macOS, Windows and Linux — Claude Code CLI handles the config file location for you.

bash
claude mcp add marketing-miner \  -s user \  -e MARKETING_MINER_API_TOKEN=YOUR_TOKEN \  -- npx -y github:lukaskostka/marketing-miner-mcp
  • -s user → installs globally (available from any project)
  • -e → sets the API token as environment variable
  • Replace YOUR_TOKEN with your actual Marketing Miner API token

To remove later: claude mcp remove marketing-miner -s user.

Option B — npx straight from GitHub (no clone needed)

The repo ships the built dist/ folder, so npx can run it directly.

Claude Desktop / Cursor / Windsurf config:

json
{  "mcpServers": {    "marketing-miner": {      "command": "npx",      "args": ["-y", "github:lukaskostka/marketing-miner-mcp"],      "env": {        "MCP_TRANSPORT": "stdio",        "MARKETING_MINER_API_TOKEN": "your_token_here"      }    }  }}

Option C — clone the repo (for development / customization)

bash
git clone https://github.com/lukaskostka/marketing-miner-mcp.gitcd marketing-miner-mcpnpm installnpm run build

Then point your MCP client at the built binary:

json
{  "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"      }    }  }}

Run locally with MARKETING_MINER_API_TOKEN=xxx npm start (stdio, default) or MCP_TRANSPORT=http MARKETING_MINER_API_TOKEN=xxx npm start (Streamable HTTP on port 8000).

Option D — Docker (self-hosted HTTP)

bash
git clone https://github.com/lukaskostka/marketing-miner-mcp.gitcd marketing-miner-mcpdocker build -t marketing-miner-mcp .docker run -p 8000:8000 -e MARKETING_MINER_API_TOKEN=your_token_here marketing-miner-mcp

Connect from a remote client via Streamable HTTP URL (see Connecting from an MCP client below).

Configuration

VariableDefaultDescription
MARKETING_MINER_API_TOKEN—Required. API token from marketingminer.com/en/features/api
MCP_TRANSPORTstdiostdio (local MCP clients) or http (Streamable HTTP for hosted deployments)
HOST0.0.0.0HTTP bind host
PORT8000HTTP port
MCP_HTTP_PATH/mcpHTTP path

Alternative token names: MARKETING_MINER_API_KEY, MARKETING_MINER_TOKEN, MM_API_TOKEN, MM_API_KEY.

Remote HTTP client config

If you are running the server over Streamable HTTP (Option D above or any remote host), MCP clients connect via URL only:

json
{  "mcpServers": {    "marketing-miner": {      "url": "https://your-host.example.com/mcp"    }  }}

Usage examples

1. Search volume for a single keyword:

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

2. Batch processing:

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

3. Question research for FAQ:

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

4. Paginating suggestions:

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

5. Competitor analysis:

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

6. Competitor trends:

"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"]})

Supported markets

cs, sk, pl, hu, ro, gb, us

Architecture

  • Node 18+, TypeScript (strict), ESM
  • MCP SDK ^1.18 (McpServer.registerTool, Zod input + output schemas, tool annotations)
  • Streamable HTTP (stateless per-request transport) + stdio
  • Zod runtime validation with .strict() (rejects unknown keys)
  • structuredContent + outputSchema on every tool
  • Response truncation for both markdown (25k chars) and oversized structuredContent arrays
  • Optional DNS-rebinding protection (Origin header validation when bound to loopback)

License

MIT

來源：README.md，提交 fccdf93

工具

0
SourceWeft 尚未讀取此伺服器的工具。

版本歷史

1
  1. v1.14.0最新Sep 16, 2026

評分

已滿足適用檢查項的 85%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Smithery 整合

222wcnm Bilistalkermcp

ai.smithery官方發布者

Bilibili 創作者分析伺服器，讓助理查詢指定使用者的個人資料、影片、動態、專欄、字幕、追蹤清單與留言。

Streamable HTTP可網頁執行
知識與記憶尚未收錄Oct 24, 2026

Zwldarren Akshare One Mcp

ai.smithery官方發布者

遠端 MCP 伺服器，讓助理以唯讀方式取得中國股市資料：歷史與即時行情、新聞和財務報表。

Streamable HTTP可網頁執行驗證方式
金融需要憑證Oct 24, 2026

Zhaoganghao Hellomcp

ai.smithery官方發布者

一個小型遠端 MCP 伺服器，讓助理依名字向人問候，並介紹「Hello, World」的由來。

Streamable HTTP可網頁執行
尚未收錄Oct 24, 2026

Zeta Chain Cli

ai.smithery官方發布者

一個遠端 MCP 伺服器，讓助理為任意姓名或受眾產生友善、可自訂的問候語。

Streamable HTTP可網頁執行驗證方式
需要憑證Oct 24, 2026

Yuna0x0 Hackmd Mcp

ai.smithery官方發布者

一個連接 HackMD API 的 MCP 伺服器，讓助理讀取、建立、更新和刪除 HackMD 筆記並管理團隊。

Streamable HTTP可網頁執行
溝通與協作尚未收錄Oct 25, 2026