名称： naver-news
描述： 使用 Naver 搜索 API 搜索韩国新闻文章。适用于搜索韩国新闻、获取最新新闻动态、查找特定主题的新闻或准备每日新闻摘要。支持按相关性和日期排序。
主页： https://developers.naver.com/docs/serviceapi/search/news/news.md
元数据： {"openclaw":{"emoji":"📰","requires":{"bins":["python3"],"env":["NAVER_CLIENT_ID","NAVER_CLIENT_SECRET"]}}}

Naver 新闻搜索

使用 Naver 搜索 API 搜索韩国新闻文章。

快速开始

使用提供的脚本搜索新闻：

python scripts/search_news.py "검색어" --display 10 --sort date

选项：
- --display N：每页结果数（1-100，默认：10）
- --start N：分页起始位置（1-1000，默认：1）
- --sort sim|date：按相关性（sim）或日期（date，默认）排序
- --after DATETIME：仅显示此时间之后发布的新闻（ISO 8601 格式，例如 2026-01-29T09:00:00+09:00）
- --min-results N：要获取的最小结果数（启用自动分页）
- --max-pages N：自动分页时尝试的最大页数（默认：5）
- --json：输出原始 JSON 而非格式化文本

设置

环境变量

从 https://developers.naver.com/ 获取必需的凭证：

NAVER_CLIENT_ID=your_client_id
NAVER_CLIENT_SECRET=your_client_secret

配置位置：
- 沙盒环境（默认）： 添加到 OpenClaw 配置中的 agents.defaults.sandbox.docker.env
- 主机环境： 添加到 OpenClaw 配置中的 env.vars

获取 API 凭证

1. 访问 https://developers.naver.com/
2. 注册一个应用
3. 启用“검색”（搜索）API
4. 复制客户端 ID 和客户端密钥
5. 将凭证添加到相应的配置部分（见上文）

常见用例

获取主题的最新新闻

python scripts/search_news.py "AI 인공지능" --display 20 --sort date

按相关性排序搜索

python scripts/search_news.py "삼성전자" --sort sim

按时间筛选（仅限近期新闻）

# 今天上午 9 点后发布的新闻
python scripts/search_news.py "경제" --display 50 --sort sim --after "2026-01-29T09:00:00+09:00"

# 过去一小时的新闻（编程使用）
python scripts/search_news.py "속보" --after "$(date -u -d '1 hour ago' '+%Y-%m-%dT%H:%M:%S%z')"

自动分页以确保最小结果数

# 获取至少 30 条结果（如果需要会自动请求多页）
python scripts/search_news.py "AI" --sort sim --after "2026-01-29T09:00:00+09:00" --min-results 30 --display 50

# 最多限制为 3 页
python scripts/search_news.py "게임" --min-results 50 --max-pages 3

自动分页工作原理：
1. 获取第一页（例如 50 条结果）
2. 应用日期筛选（例如剩余 10 条结果）
3. 如果低于 --min-results，自动获取下一页
4. 达到最小值或达到 --max-pages 限制时停止

分页获取更多结果

# 前 10 条结果
python scripts/search_news.py "경제" --display 10 --start 1

# 接下来 10 条结果
python scripts/search_news.py "경제" --display 10 --start 11

在 Python 代码中使用

直接导入并使用搜索函数：

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 详情

完整的 API 参考，包括响应结构、错误码和速率限制，请参阅：

references/api.md

注意事项

• 搜索查询必须使用 UTF-8 编码
• 结果中搜索词匹配部分会包含 <b> 标签（清理文本时需移除）
• 每日限制：每个应用 25,000 次 API 调用
• link 字段可能指向 Naver 新闻或原始来源，取决于可用性