korean-data-mcp

Instructions

Implementation Reference

• src/korean_data_mcp/server.py:116-140 (handler)

  The implementation of the search_daangn tool, which is a handler that uses the _run_actor helper to interface with an Apify actor.

  @mcp.tool()
  async def search_daangn(
      keyword: str,
      region: str = "",
      max_items: int = 30,
  ) -> list[dict]:
      """
      Search Daangn Market (당근마켓) listings.
  
      Args:
          keyword: Search keyword in Korean or English
          region: Optional region filter (e.g. '서울', '강남구')
          max_items: Maximum number of listings to return (default 30, max 100)
  
      Returns:
          List of listing objects with title, price, location, image, url fields.
      """
      max_items = min(max_items, 100)
      input_data: dict[str, Any] = {"keyword": keyword, "maxItems": max_items}
      if region:
          input_data["region"] = region
      return await _run_actor(
          f"{APIFY_ACCOUNT}/daangn-market-scraper",
          input_data,
      )