核心用法
Naver News Search 是一个基于 Naver Search API 的韩语新闻检索工具，专为获取韩国最新新闻、特定主题资讯及每日新闻摘要而设计。
主要功能：
- 关键词搜索：支持 UTF-8 编码的韩语查询词
- 双模式排序：按相关性 (
sim) 或发布时间 (date) 排序 - 时间过滤：通过
--after参数筛选指定时间后的新闻（ISO 8601 格式） - 自动分页：
--min-results配合--max-pages确保获取足够结果，自动跨页请求 - 灵活输出：支持格式化文本或原始 JSON 输出
使用场景示例：
# 获取最新 AI 新闻（20条，按时间倒序） python scripts/search_news.py "AI 인공지능" --display 20 --sort date # 三星电子相关新闻（按相关性排序） python scripts/search_news.py "삼성전자" --sort sim # 自动分页获取至少 30 条今日新闻 python scripts/search_news.py "경제" --after "2026-01-29T09:00:00+09:00" --min-results 30
显著优点
1. 官方数据源：直接调用 Naver（韩国最大搜索引擎）官方 API，新闻覆盖全面、更新及时
2. 开发者友好：提供 Python 模块直接调用，也支持命令行脚本快速测试
3. 智能分页：自动分页机制减少手动处理多页结果的繁琐
4. 精准时间控制：支持相对时间表达式（如 1 hour ago）配合 shell 命令动态过滤
局限性与风险
- API 限制：每日 25,000 次调用上限，高频率使用需规划配额
- 结果格式：标题和摘要含
<b>高亮标签，需额外清理 - 链接跳转：
link字段可能指向 Naver News 聚合页或原媒体，行为不一致 - 地域依赖：仅覆盖韩语新闻，非韩国地区资讯受限
- 认证门槛：需注册 Naver 开发者账号并申请 Search API 权限
适合人群
- 需要追踪韩国市场动态的财经分析师、投资研究员
- 从事韩流文化、韩国政策研究的学术人员
- 面向韩国用户的资讯类应用开发者
- 需要自动化新闻聚合的数据工程师
常规风险
| 风险类型 | 说明 |
|---------|------|
| API 密钥泄露 | `NAVER_CLIENT_ID` 和 `NAVER_CLIENT_SECRET` 需妥善保管，避免硬编码提交至版本控制 |
| 配额耗尽 | 高频自动化任务可能触达日限额，导致服务中断 |
| 内容版权 | 抓取的新闻内容需遵守原媒体版权政策，商用需注意授权 |
| 时间解析错误 | `--after` 参数时区处理不当可能导致结果偏差，建议显式指定 `+09:00`（KST）|