核心用法
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 带时区格式,否则可能因时区歧义漏检