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）排序（默认：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

配置位置：

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

获取 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

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

# 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')"

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

# 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

自动分页的工作原理：

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

分页以获取更多结果

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

# Next 10 results
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调用
• 链接该字段可能指向Naver新闻或原始来源，具体取决于可用性