The Hubble MCP Server is a Python-based server that provides tools for keyword analysis, web crawling, and search data extraction:
Keyword Analysis: Retrieve search paths, keyword information (search volume, intent, demographics, trends), and keyword relationship graphs/clusters.
Web Crawling: Extract content from specified URLs and web pages.
Google SERP Analysis: Collect Search Engine Results Page data, Google suggest extensions, and Google trends data over specific timeframes.
Regional Data: Supports geographic targeting with region codes (e.g.,
kr
for Korea,jp
for Japan).Error Handling: Includes proper error handling for API requests.
hubble_mcp
⚠️ 주의
현재는 사내 VPN 환경에서만 사용 가능합니다.
간혹 API 가 실패 할수 있으니, 데이터 응답을 정상적으로 수신 했는지 확인이 필요 합니다.
(클로드가 툴 사용한 메시지를 클릭하면, API 응답 메시지 확인이 가능합니다. )
set-up-your-environment
- Claude Desktop 설치
- uv 설치 (hubble MCP Server 는 파이썬으로 작성되었습니다.) - https://modelcontextprotocol.io/quickstart/server#set-up-your-environment
- Windows일부 보안 프로그램의 실시간 감시에서
uv
명령어가 차단될 경우, 실시간 감시를 중단 또는 해당 파일을 제외 시켜 주세요~ - MacOS/Linux
- Windows
- Hubble MCP Server 다운로드
- https://github.com/ascentkorea/hubble_mcp/releases
- zip 파일 다운로드후, 압축해제 (아래 설정파일 에서 해당 경로 필요)
- 가장 최신 버전 사용
- https://github.com/ascentkorea/hubble_mcp/releases
- HUBBLE_API_KEY 발급
claude_desktop_config.json 파일 설정
- 클로드 데스크탑 > 파일 > 설정(Ctrl + ,) > 개발자 > 설정 편집
- json 파일 수정 이후, 클로드 데스크탑 > 파일 > 종료 를 통해서 다시 시작 필요!
- 맥일경우 uv 실행 파일의 절대 경로 필요, 아래 맥 샘플 참조
Windows 설정 파일 샘플
MacOS/Linux 설정 파일 샘플
제공 되는 tool(기능) 설명 ( https://hubble-data-api.ascentlab.io/ )
- get_search_path: 검색 경로 API
- get_keyword_info: 키워드에 대한 검색량(월별 검색량), 구글 SERP에 출현하는 feature type 요약, 검색 인텐트(INCT), 한국의 경우 성비/연령비
- get_graph_info: 키워드간의 관계 정보
- crawl_google_serp: 구글 SERP API
- crawl_web_page: 일반 웹페이지 수집 API
- crawl_google_suggest_extension: 구글 서제스트 API
- crawl_google_trends: 구글 트렌드 API
local-only server
The server can only run on the client's local machine because it depends on local resources.
Tools
A Python-based Model Context Protocol server that integrates with Claude Desktop, allowing users to connect to Hubble API services by configuring the server with their Hubble API key.
Related MCP Servers
- -securityAlicense-qualityThis tool creates a Model Context Protocol (MCP) server that acts as a proxy for any API that has an OpenAPI v3.1 specification. This allows you to use Claude Desktop to easily interact with both local and remote server APIs.Last updated -191792MIT License
- -securityAlicense-qualityA Python-based server that implements the Model Context Protocol to interface with Claude Desktop as an MCP client, supporting interaction through efficient memory management.Last updated -1MIT License
- -securityFlicense-qualityA Model Context Protocol server built with mcp-framework that allows users to create and manage custom tools for processing data, integrating with the Claude Desktop via CLI.Last updated -265
- AsecurityAlicenseAqualityA collection of Model Context Protocol servers that enable Claude Desktop to provide development assistance capabilities with filesystem, Git, shell command, and web search functionality without incurring API usage costs.Last updated -219MIT License