Naver 新闻：搜索与分析韩国新闻 - Openclaw Skills

什么是 Naver 新闻？

Naver 新闻技能为 Openclaw Skills 用户提供了一个强大的接口，将高质量的韩国新闻数据集成到自动化工作流中。通过利用官方 Naver 搜索 API，该技能允许智能体以编程方式查询新闻文章，按相关性或日期排序，并应用严格的时间筛选。这对于构建需要实时掌握韩国市场趋势、科技新闻或一般时事的智能体的开发者来说非常有价值。

该技能在开发时充分考虑了开发者体验，处理了 API 通信的复杂性，提供命令行界面和直接的 Python 集成。它旨在在 Openclaw Skills 生态系统内无缝运行，提供结构化的 JSON 输出，方便 LLM 进行总结、分析或报告生成。

下载入口:https://github.com/openclaw/skills/tree/main/skills/steamb23/naver-news

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install naver-news

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 /skills/

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 naver-news。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。

Naver 新闻 应用场景

• 监控韩国市场内特定的行业趋势或公司新闻。
• 获取最相关的文章，对特定的韩国话题进行深入研究。
• 筛选在特定时间戳之后发布的最新突发新闻，用于实时警报。
• 为每日新闻简报或自动新闻策展智能体收集数据。

Naver 新闻 工作原理

1. 用户或智能体提供搜索查询及可选参数，如显示数量、排序方式或时间筛选。
2. 该技能执行 Python 脚本，使用配置的客户端凭据格式化并向 Naver 搜索 API 发送请求。
3. 脚本处理 API 响应，如果筛选后的结果数量低于指定的最小值，则处理自动分页。
4. 最终数据集以易于人类阅读的格式化文本或供 Openclaw Skills 智能体使用的原始 JSON 形式返回。

Naver 新闻 配置指南

要使用此技能，您必须首先从 Naver Developers 门户获取 API 凭据并启用搜索 API。获得客户端 ID 和密钥后，请在 Openclaw Skills 环境中进行配置：

# 添加到环境变量
export NAVER_CLIENT_ID=your_client_id
export NAVER_CLIENT_SECRET=your_client_secret

要从命令行运行基本搜索：

python scripts/search_news.py "AI ????" --display 10 --sort date

Naver 新闻 数据架构与分类体系

该技能返回结构化数据，其中包含每个新闻项的以下元数据：

字段	描述
title	新闻文章的标题，通常包含用于关键词高亮的 HTML 标签。
originallink	指向原始来源网站的直接 URL。
link	指向该文章 Naver 新闻门户版本的 URL。
description	文章内容的摘要或片段。
pubDate	文章的发布日期和时间。

---

name: naver-news description: Search Korean news articles using Naver Search API. Use when searching for Korean news, getting latest news updates, finding news about specific topics, or preparing daily news summaries. Supports relevance and date-based sorting. homepage: https://developers.naver.com/docs/serviceapi/search/news/news.md metadata: {"openclaw":{"emoji":"??","requires":{"bins":["python3"],"env":["NAVER_CLIENT_ID","NAVER_CLIENT_SECRET"]}}}

Naver News Search

Search Korean news articles using the Naver Search API.

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 https://developers.naver.com/:

NAVER_CLIENT_ID=your_client_id
NAVER_CLIENT_SECRET=your_client_secret

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

1. Visit https://developers.naver.com/
2. Register an application
3. Enable "??" (Search) API
4. Copy Client ID and Client Secret
5. Add credentials to 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:

1. Fetches first page (e.g., 50 results)
2. Applies date filter (e.g., 10 results remain)
3. If below --min-results, automatically fetches next page
4. 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)
• Daily limit: 25,000 API calls per application
• link field may point to Naver News or original source depending on availability