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 — 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_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 적용

• 마크다운(25k 문자) 및 대용량 structuredContent 배열에 대한 응답 잘림 처리

• 선택적 DNS 리바인딩 보호 (루프백에 바인딩된 경우 Origin 헤더 검증)

라이선스

MIT