Skip to main content
Glama
Hubble MCP Server

Hubble MCP Server

by ascentkorea

hubble_mcp

⚠️注意

目前仅在本地 VPN 环境中可用。

由于API偶尔可能会失败,您需要检查数据响应是否正常收到。
(如果点击Claude用作工具的消息,您可以检查API响应消息。)

设置你的环境

Related MCP server: PostHog MCP Server

设置 claude_desktop_config.json 文件

  • Claude 桌面 > 文件 > 偏好设置 (Ctrl + ,) > 开发者 > 编辑偏好设置

    • 修改json文件后需要重启Claude Desktop>File>Exit!

  • 如果您使用的是 Mac,则需要 uv 可执行文件的绝对路径,请参阅下面的 Mac 示例。

{
  "mcpServers": {
    "hubble": {
      "command": "uv",
      "args": [
          "--directory",
          "<Hubble MCP Server 다운로드후 zip 파일 압축 해제후 data_api.py 파일 있는 경로>",
          "run",
          "data_api.py"
      ],
      "env": {
        "HUBBLE_API_KEY": "<HUBBLE_API_KEY>"
      }
    }
  }
}

示例 Windows 设置文件

{
  "mcpServers": {
    "hubble": {
      "command": "uv",
      "args": [
          "--directory",
          "C:\\Users\\XXXX\\Documents\\hubble\\hubble_mcp",
          "run",
          "data_api.py"
      ],
      "env": {
        "HUBBLE_API_KEY": "xxx-xxxx-xxxx-xxx"
      }
    }
  }
}

示例 MacOS/Linux 配置文件

{
  "mcpServers": {
    "hubble": {
      "command": "/Users/XXX/.local/bin/uv",
      "args": [
          "--directory",
          "/Users/XXX/workspace/hubble/hubble_mcp",
          "run",
          "data_api.py"
      ],
      "env": {
        "HUBBLE_API_KEY": "xxx-xxxx-xxxx-xxx"
      }
    }
  }
}

所提供工具(功能)的描述( https://hubble-data-api.ascentlab.io/ )

  • get_search_path:搜索路径 API

  • get_keyword_info:关键词的搜索量(月搜索量)、Google SERP 中出现的特征类型摘要、搜索意图(INCT)、韩国的性别/年龄比例

  • get_graph_info:关键词之间的关系信息

  • crawl_google_serp:Google SERP API

  • crawl_web_page:通用网页采集API

  • crawl_google_suggest_extension:Google Suggest API

  • crawl_google_trends:Google 趋势 API

Available Tools

7 tools
crawl_google_serpD

구글 SERP API 요청

Inputs: keyword (required), gl.

crawl_google_suggestC
입력된 키워드에 대해 구글 서제스트에 나타난 키워드 수집 요청
args:
    keyword: str, 키워드
    gl: Literal['kr', 'us', 'jp'] = "kr", 국가 코드
returns:
    dict[Any] | None: 구글 서제스트 수집 결과
키워드 suggestions
한국 (gl: kr)
미국 (gl: us)
일본 (gl: jp)

Inputs: q (required), gl.

crawl_web_pageC
웹 페이지 크롤링
args:
    url_list: List[str], 크롤링할 웹 페이지 리스트
returns:
    dict[Any] | None: 크롤링 결과

Inputs: url_list (required).

get_graph_infoA
키워드 관계 정보(리스닝마인드의 클러스터 파인더의 결과 조회, 키워드 관계 정보 조회)
모든 키워드는 소문자로 변환하여 요청
args:
    req_param: ClusterParameters, 키워드 관계 정보 조회 요청 파라미터
returns:
    dict[ClusterResponse, Any] | None: 키워드 관계 정보 조회 결과
ClusterResponse 는 아래와 같은 정보를 포함합니다:  

nodes: 조회한 키워드의 앞과 뒤로 2혹은 2hop 거리 안에서 검색된 모든 키워드(노드) 리스트
nodes_count: 키워드(노드) 수
rels: 관계 리스트
rels_count: 관계 수
closeness: 관계에서 키워드가 출현한 위치.
distance: 모든 관계에서 키워드가 출현한 위치.
type: PEOPLE_ALSO_SEARCH_FOR | RELATED_SEARCHES | REFINEMENTS | PEOPLE_ALSO_ASK_FOR  

Inputs: req_param (required).

get_keyword_infoA
    키워드 정보 조회 (최대 1000개 키워드 조회 가능)
    모든 키워드는 소문자로 변환하여 요청
    키워드 정보 조회 결과는 키워드 정보 조회 결과 형식에 따라 반환됩니다.
    args:
        req_param: KeywordParameters, 키워드 정보 조회 요청 파라미터
    returns:
        dict[KeywordResponse, Any] | None: 키워드 정보 조회 결과
KeywordResponse 는 아래와 같은 정보를 포함합니다:
ads_metrics:
    - competition: 경쟁도 수준 (LOW: 0-33, MEDIUM: 34-66, HIGH: 67-100)
    - competition_index: 구글 검색광고 경쟁도 (0-100)
    - cpc: 클릭당 비용
    - volume_avg: 최근 3개월 월평균 검색량
    - volume_total: 최근 12개월 총 검색량
    - volume_trend: 3개월 전 대비 검색량 증감율
    - gg_volume_avg: 구글 최근 3개월 월평균 검색량
    - gg_volume_total: 구글 최근 12개월 총 검색량 
    - gg_volume_trend: 구글 검색량 증감율
    - nv_volume_avg: 네이버 최근 3개월 월평균 검색량
    - nv_volume_total: 네이버 최근 12개월 총 검색량
    - nv_volume_trend: 네이버 검색량 증감율
intents:
    - I: Informational - 잠재 소비자가 제품 자체 정보나 제품이 포함된 카테고리 등에 대한 정보를 얻기 위한 검색
    - N: Navigational - 잠재 소비자가 특정 웹사이트나 브랜드 혹은 매장 위치를 찾기 위한 검색
    - C: Commercial - 구매 전 단계에서 비교, 리뷰, 추천 등의 구매 의사 결정에 도움이 되는 정보를 구하려는 목적의 검색
    - T: Transactional - 구매를 목적으로 하는 검색
monthly_volume:
    - month: 해당 월
    - gg: 구글 검색량
    - nv: 네이버 검색량
    - total: 구글 + 네이버 검색량

Inputs: req_param (required).

get_search_pathB

Make a request to the Path Finder API of Hubble with proper error handling. Args: keyword: str, 검색 키워드(모든 키워드는 소문자로 변환하여 요청) gl: str, 지역 코드 한국 일본(kr, jp) limit: int, 검색 경로 분석 결과 최대 개수(기본값 300) Returns: dict[str, Any] | None: 검색 키워드의 검색 경로 분석 결과

Inputs: keyword (required), gl, limit.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 7 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: SERP, suggestions, trends, web page crawling, keyword graph info, keyword details, and search path. No overlap or ambiguity.

    Naming Consistency4/5

    All tool names use snake_case and follow a verb_noun pattern (crawl_*, get_*). The two verb prefixes are consistent with their functionality, though they differ from each other.

    Tool Count5/5

    7 tools is well-scoped for a keyword research and analysis server. Each tool covers a distinct aspect of SEO/keyword research without redundancy.

    Completeness4/5

    The set covers the main workflow: data collection (SERP, suggestions, trends, web pages) and analysis (graph, keyword info, search path). Minor gaps (e.g., no export or comparison tool) but core functionality is solid.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers