核心用法
naver-news 是一个基于 Naver 官方搜索 API 的韩语新闻检索工具。用户可通过命令行脚本或 Python 函数直接调用，支持关键词搜索、分页获取、时间过滤及自动分页机制。主要接口包括 search_news() 函数和 scripts/search_news.py CLI 工具，提供灵活的参数配置如 --display（结果数）、--sort（排序方式）、--after（时间过滤）以及 --min-results 自动分页。
显著优点
1. 官方数据源：直接对接 Naver 搜索 API，覆盖韩国主流新闻源，数据权威性和时效性有保障
2. 灵活的过滤机制：支持 ISO 8601 格式的时间戳过滤，可按发布时段精准筛选新闻
3. 智能分页：--min-results 参数配合自动分页逻辑，确保获取足够结果量，避免手动多次请求
4. 双语支持：CLI 和 Python API 双接口，既适合快速命令行查询，也便于集成到自动化工作流
5. 结构化输出：可选 JSON 原始输出，方便下游程序解析处理
潜在局限
- 地理限制：仅支持韩语新闻，非韩国地区或英文新闻覆盖不足
- API 配额：每日 25,000 次调用上限，高频监控场景需规划用量
- 认证门槛：需注册 Naver 开发者账号并申请搜索 API 权限，配置流程较繁琐
- 内容标记：返回结果包含
<b>高亮标签，需额外清洗处理 - 链接跳转：部分
link字段指向 Naver 新闻中间页而非原始来源，可能影响直接引用
适合人群
- 韩语内容研究者、韩国市场分析师
- 需要监控韩国热点的新闻聚合服务开发者
- 跨境业务团队（游戏、电商、文娱等）的舆情监控人员
- 韩语学习者的每日新闻摘要自动化需求
常规风险
- API 密钥泄露风险：
NAVER_CLIENT_ID和NAVER_CLIENT_SECRET需妥善保管，避免硬编码提交至代码仓库 - 合规使用：需遵守 Naver API 使用条款，禁止爬取缓存后大规模转售数据
- 时效性依赖：API 返回结果依赖 Naver 索引更新时间，突发新闻可能存在分钟级延迟