get_search_path
Retrieve search path analysis results for a given keyword and region using Hubble's Path Finder API. Specify keyword, region code (kr, jp), and limit to process and return structured data.
Instructions
Make a request to the Path Finder API of Hubble with proper error handling. Args: keyword: str, 검색 키워드 gl: str, 지역 코드 한국 일본(kr, jp) limit: int, 검색 경로 분석 결과 최대 개수(기본값 200) Returns: dict[str, Any] | None: 검색 경로 분석 결과
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gl | No | kr | |
| keyword | Yes | ||
| limit | No |
Implementation Reference
- data_api.py:281-303 (handler)The handler function implementing the 'get_search_path' MCP tool. It is decorated with @mcp.tool() for registration and @async_retry for error handling. The function sends a POST request to the Hubble API's path_finder endpoint with the provided keyword, gl, and limit parameters, returning the response text or None on failure.@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
- data_api.py:281-281 (registration)The @mcp.tool() decorator registers the get_search_path function as an MCP tool in the FastMCP server.@mcp.tool()