核心用法
naver-news 是一款专为韩国新闻检索设计的 Agent Skill，通过调用 Naver 官方搜索 API 实现新闻内容的程序化获取。用户可通过命令行脚本或 Python 模块直接调用，支持关键词搜索、结果数量控制、相关性/时间排序、时间范围过滤及自动分页等核心功能。典型使用场景包括：获取特定主题的实时新闻动态、生成每日新闻摘要、追踪热点事件发展、以及为研究或分析工作批量采集韩语新闻数据。
显著优点
官方 API 背书：直接对接 Naver 开放平台，数据来源权威可靠，响应结构标准化，包含标题、摘要、链接、发布时间等完整字段。功能设计完善：支持 sim（相关性）与 date（时间）双模式排序，提供 ISO 8601 标准的时间过滤参数，独创的 --min-results 自动分页机制可智能补全结果集，避免手动处理分页逻辑。零依赖架构：纯 Python 标准库实现，仅依赖 urllib、、json、、datetime 等内置模块，彻底规避第三方包供应链风险。双语支持友好：原生支持 UTF-8 编码的韩文搜索，对韩语内容处理无乱码问题，适合韩语研究者与国际用户跨语言使用。
潜在缺点与局限性
地理与语言限制：仅覆盖 Naver 新闻生态，无法获取其他韩国门户（如 Daum）或国际媒体内容；搜索结果以韩语为主，非韩语用户需额外处理翻译。配额与性能瓶颈：每日 25,000 次调用上限对高频监控场景可能不足；单次请求最大 100 条结果，大规模数据采集需多次 API 往返。内容完整性约束：link 字段可能指向 Naver 中转页而非原始来源，部分新闻摘要存在截断；返回的标题和描述保留 <b>> 高亮标签，需二次清洗。认证门槛：需注册 Naver 开发者账号并申请 API 密钥，流程对非韩国用户存在一定门槛。
适合的目标群体
- 韩语内容研究者：需要追踪韩国社会、政治、经济动态的学者与分析师
- 跨境市场运营人员：关注韩国消费趋势、品牌舆情的市场营销团队
- 新闻聚合开发者：构建韩语新闻简报、舆情监控系统的工程师
- 语言学习者：通过真实新闻语料提升韩语阅读能力的学习者
- 金融投研机构：需要实时获取韩国股市、企业相关资讯的分析师
使用风险
API 配额耗尽风险：高频调用可能触发日限额，导致服务中断，建议实施调用计数与退避机制。网络稳定性依赖：Naver API 服务器位于韩国境外，中国大陆等地区访问可能存在延迟或间歇性连接问题。凭证管理风险：NAVER_CLIENT_ID 与 NAVER_CLIENT_SECRET 需妥善保管，泄露可能导致配额被恶意消耗。数据时效性偏差：API 返回时间为 Naver 索引时间，与原始新闻发布时间可能存在分钟级延迟，对实时性要求极高的场景（如突发新闻交易决策）需谨慎评估。合规使用义务：需遵守 Naver 开放平台服务条款，禁止将 API 数据用于垃圾信息生成、自动化点击等违规用途。