通过 Naver 官方搜索 API 获取韩国新闻,支持相关度/时间排序、时间过滤与自动分页,适合韩语新闻追踪与日常简报准备。
说明:
## 核心用法
**naver-news** 是一个基于 Naver 官方 Search API 的韩国新闻检索技能,提供命令行脚本与 Python 模块两种调用方式。用户可通过 `search_news.py` 执行关键词搜索,支持韩文与英文查询,默认按时间排序返回最新资讯。
### 关键功能
– **排序模式**:`–sort sim`(相关度)或 `date`(时间,默认)
– **时间过滤**:`–after` 支持 ISO 8601 格式精确筛选发布时段
– **自动分页**:`–min-results` 配合 `–max-pages` 自动请求多页直至满足结果数
– **灵活输出**:`–json` 输出原始 API 响应便于二次处理
### 显著优点
1. **官方数据源**:直接对接 Naver 搜索 API,覆盖韩国主流新闻媒体
2. **韩语原生优化**:针对韩文分词与排序算法优化,检索质量高于通用搜索引擎
3. **高效工作流**:内置分页与日期过滤,无需手动拼接多页请求
4. **轻量集成**:纯 Python 实现,仅需标准库与 requests,易于嵌入现有项目
### 潜在缺点与局限性
– **地理限制**:仅限韩国新闻生态,国际新闻覆盖有限
– **API 配额**:每日 25,000 次调用,高并发场景需配额管理
– **内容摘要限制**:返回的 `description` 为截断片段,非完整正文
– **链接不确定性**:部分结果指向 Naver 新闻聚合页而非原始媒体源
– **认证门槛**:需注册 Naver 开发者账号并单独申请搜索 API 权限
### 适合人群
– 需要追踪韩国本地新闻的分析师与研究员
– 构建韩语舆情监控系统的开发者
– 为韩语用户生成每日新闻摘要的内容运营者
– 学习韩语或研究韩国社会动态的学术用户
### 常规风险
– **API 密钥泄露**:`NAVER_CLIENT_ID` 与 `SECRET` 若硬编码存在泄露风险,建议通过环境变量注入
– **频率限制触发**:超出 25,000 次/日配额将导致服务中断
– **内容准确性**:Naver 搜索结果可能包含未经验证的自媒体内容,需人工复核关键信息
– **时区处理**:`–after` 参数需严格使用 ISO 8601 带时区格式,否则可能因时区歧义漏检









