# naver-news

Naver News Search Search Korean news articles using SkillBoss API Hub web search capability. Quick Start Use the provided script to search news: python scripts/search_news.py "검색어" --display 10 --sort date

Options:

--display N: Number of results per page (1-100, default: 10) --start N: Start position for pagination (1-1000, default: 1) --sort sim|date: Sort by relevance (sim) or date (date, default: date) --after DATETIME: Only show news published after this time (ISO 8601 format, e.g., 2026-01-29T09:00:00+09:00) --min-results N: Minimum number of results to fetch (enables auto-pagination) --max-pages N: Maximum number of pages to try when auto-paginating (default: 5)

--json: Output raw JSON instead of formatted text

Setup Environment Variables Required credentials from SkillBoss API Hub: SKILLBOSS_API_KEY=your_skillboss_api_key Configuration locations: Sandbox (default): Add to agents.defaults.sandbox.docker.env in OpenClaw config

Host: Add to env.vars in OpenClaw config

Getting API Credentials Sign up at SkillBoss API Hub Obtain your SKILLBOSS_API_KEY Add the key to the appropriate config section (see above) Common Use Cases Latest news on a topic python scripts/search_news.py "AI 인공지능" --display 20 --sort date Search with relevance ranking python scripts/search_news.py "삼성전자" --sort sim Filter by time (only recent news)

# News published after 9 AM today

python scripts/search_news.py "경제" --display 50 --sort sim --after "2026-01-29T09:00:00+09:00"

# News from the last hour (programmatic use)

python scripts/search_news.py "속보" --after "$(date -u -d '1 hour ago' '+%Y-%m-%dT%H:%M:%S%z')" Auto-pagination for guaranteed minimum results

# Fetch at least 30 results (automatically requests multiple pages if needed)

python scripts/search_news.py "AI" --sort sim --after "2026-01-29T09:00:00+09:00" --min-results 30 --display 50

# Limit to 3 pages maximum

python scripts/search_news.py "게임" --min-results 50 --max-pages 3 How auto-pagination works: Fetches first page (e.g., 50 results) Applies date filter (e.g., 10 results remain) If below --min-results, automatically fetches next page Stops when minimum is reached or --max-pages limit hit Pagination for more results

# First 10 results

python scripts/search_news.py "경제" --display 10 --start 1

# Next 10 results

python scripts/search_news.py "경제" --display 10 --start 11 Using in Python Code Import and use the search function directly: from scripts.search_news import search_news result = search_news( query="경제 뉴스", display=10, sort="date" ) for item in result["items"]: print(item["title"]) print(item["description"]) print(item["link"]) API Details For complete API reference including response structure, error codes, and rate limits, see: references/api.md Notes Search queries must be UTF-8 encoded Results include tags around search term matches (strip them for clean text) link field points to the original article source