基于 Naver 官方开放 API 的韩国新闻搜索工具，支持关键词检索、时间筛选与自动分页，为韩语内容研究者提供实时、权威的新闻数据源。
说明：
## 核心用法
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 中转页而非原始来源，部分新闻摘要存在截断；返回的标题和描述保留 `>` 高亮标签，需二次清洗。**认证门槛**：需注册 Naver 开发者账号并申请 API 密钥，流程对非韩国用户存在一定门槛。
## 适合的目标群体
– **韩语内容研究者**：需要追踪韩国社会、政治、经济动态的学者与分析师
– **跨境市场运营人员**：关注韩国消费趋势、品牌舆情的市场营销团队
– **新闻聚合开发者**：构建韩语新闻简报、舆情监控系统的工程师
– **语言学习者**：通过真实新闻语料提升韩语阅读能力的学习者
– **金融投研机构**：需要实时获取韩国股市、企业相关资讯的分析师
## 使用风险
**API 配额耗尽风险**：高频调用可能触发日限额，导致服务中断，建议实施调用计数与退避机制。**网络稳定性依赖**：Naver API 服务器位于韩国境外，中国大陆等地区访问可能存在延迟或间歇性连接问题。**凭证管理风险**：`NAVER_CLIENT_ID` 与 `NAVER_CLIENT_SECRET` 需妥善保管，泄露可能导致配额被恶意消耗。**数据时效性偏差**：API 返回时间为 Naver 索引时间，与原始新闻发布时间可能存在分钟级延迟，对实时性要求极高的场景（如突发新闻交易决策）需谨慎评估。**合规使用义务**：需遵守 Naver 开放平台服务条款，禁止将 API 数据用于垃圾信息生成、自动化点击等违规用途。
会员专属
