get_search_path
Analyze search path patterns for keywords using Hubble's Path Finder API to understand user navigation behavior across Korean and Japanese markets.
Instructions
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: 검색 키워드의 검색 경로 분석 결과
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| keyword | Yes | ||
| gl | No | kr | |
| limit | No |
Implementation Reference
- data_api.py:281-303 (handler)The handler function for the 'get_search_path' MCP tool. It sends a POST request to the Hubble API's path_finder endpoint to retrieve search path analysis for the given keyword, region (kr/jp), and limit. Includes type hints serving as input schema and @mcp.tool() decorator for registration.
@mcp.tool() @async_retry(exceptions=(Exception), tries=2, delay=0.3) async def get_search_path(keyword: str, gl: Literal['kr', 'jp'] = "kr", limit=300) -> dict[str, Any] | None: """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: 검색 키워드의 검색 경로 분석 결과 """ payload = {"keyword": keyword, "gl": gl, "limit": limit} headers = {"X-API-Key": HUBBLE_API_KEY} async with httpx.AsyncClient() as client: response = await client.post( f"{HUBBLE_API_URL}/path_finder", headers=headers, json=payload, timeout=30.0) response.raise_for_status() return response.text