naver api hub search

Search operations often fail when relying on generic scrapers that hit bot detection or return stale data. This skill integrates directly with the official NAVER API HUB to fetch high-fidelity data from South Korea's leading search portal. It provides structured access to blogs, news, local business listings, and web documents without the fragility of web scraping.

What it does

• Multi-channel search fetches results from blogs, news, local businesses, images, and web documents.
• Trend analysis retrieves relative search volume data over specific periods for keyword groups.
• Smart parsing handles natural language requests for sorting by accuracy, date, or review count.
• Error handling interprets NAVER-specific error codes for authentication, quotas, and parameter bounds.
• Data cleaning automatically strips HTML tags and formats raw JSON into readable summaries.

How it works

1. Verify credentials in NAVER_API_HUB_CLIENT_ID and NAVER_API_HUB_CLIENT_SECRET.
2. Parse the user request to determine the search type, query, and optional sorting parameters.
3. Execute a curl request to the NAVER API HUB gateway using the appropriate GET or POST method.
4. Process the response through jq to clean metadata and extract core fields like titles, links, and dates.

Frameworks & tools

This skill uses Bash, curl, and jq for API interaction. It communicates with the NAVER API HUB (ntruss.com) and requires a Naver Cloud Platform account.

Why this beats prompting it yourself

Standard LLMs lack access to real-time Korean search indices and often hallucinate links. This skill ensures data is pulled from the official API gateway, providing valid source URLs, accurate local business addresses, and precise search volume ratios that an LLM cannot guess.

Use cases

• Researching local Korean business listings including addresses and review-based sorting.
• Monitoring recent Korean news or blog trends for specific technical topics or brands.
• Comparing relative search volume for multiple keywords to identify seasonal trends.
• Extracting clean web document summaries for RAG or competitive analysis.

Known limitations

Requires a Naver Cloud Platform account with NAVER API HUB enabled. Local search results are limited to 5 items per request, while other types allow up to 100.