Naver news Search

核心用法

Naver News Search 是一个基于 Naver Search API 的韩语新闻检索工具，专为获取韩国最新新闻、特定主题资讯及每日新闻摘要而设计。

主要功能：

• 关键词搜索：支持 UTF-8 编码的韩语查询词
• 双模式排序：按相关性 (sim) 或发布时间 (date) 排序
• 时间过滤：通过 --after 参数筛选指定时间后的新闻（ISO 8601 格式）
• 自动分页：--min-results 配合 --max-pages 确保获取足够结果，自动跨页请求
• 灵活输出：支持格式化文本或原始 JSON 输出

使用场景示例：

# 获取最新 AI 新闻（20条，按时间倒序）
python scripts/search_news.py "AI 인공지능" --display 20 --sort date

# 三星电子相关新闻（按相关性排序）
python scripts/search_news.py "삼성전자" --sort sim

# 自动分页获取至少 30 条今日新闻
python scripts/search_news.py "경제" --after "2026-01-29T09:00:00+09:00" --min-results 30

显著优点

1. 官方数据源：直接调用 Naver（韩国最大搜索引擎）官方 API，新闻覆盖全面、更新及时
2. 开发者友好：提供 Python 模块直接调用，也支持命令行脚本快速测试
3. 智能分页：自动分页机制减少手动处理多页结果的繁琐
4. 精准时间控制：支持相对时间表达式（如 1 hour ago）配合 shell 命令动态过滤

局限性与风险

• API 限制：每日 25,000 次调用上限，高频率使用需规划配额
• 结果格式：标题和摘要含 <b> 高亮标签，需额外清理
• 链接跳转：link 字段可能指向 Naver News 聚合页或原媒体，行为不一致
• 地域依赖：仅覆盖韩语新闻，非韩国地区资讯受限
• 认证门槛：需注册 Naver 开发者账号并申请 Search API 权限

适合人群

• 需要追踪韩国市场动态的财经分析师、投资研究员
• 从事韩流文化、韩国政策研究的学术人员
• 面向韩国用户的资讯类应用开发者
• 需要自动化新闻聚合的数据工程师

常规风险

| 风险类型 | 说明 |

|---------|------|

| API 密钥泄露 | `NAVER_CLIENT_ID` 和 `NAVER_CLIENT_SECRET` 需妥善保管，避免硬编码提交至版本控制 |

| 配额耗尽 | 高频自动化任务可能触达日限额，导致服务中断 |

| 内容版权 | 抓取的新闻内容需遵守原媒体版权政策，商用需注意授权 |

| 时间解析错误 | `--after` 参数时区处理不当可能导致结果偏差，建议显式指定 `+09:00`（KST）|

核心功能与用法

naver-news 是一个专为韩语新闻检索设计的Skill，通过调用Naver Search API实现实时新闻搜索。核心使用方式为命令行调用 python scripts/search_news.py，支持多种参数组合：

• 排序策略：--sort sim（按相关度）或 date（按发布时间，默认）
• 时间过滤：--after 参数支持ISO 8601格式，可筛选特定时间后的新闻
• 自动分页：--min-results 配合 --max-pages 实现智能多页抓取，解决API单页返回量限制
• 输出格式：默认格式化文本，可加 --json 获取原始API响应

Python代码中可直接导入 search_news() 函数，返回包含标题、摘要、链接的结构化数据。

显著优点

1. 官方数据源：Naver是韩国最大门户网站，新闻覆盖度和时效性远超通用搜索
2. 零依赖设计：仅使用Python标准库（urllib/json/argparse等），无供应链风险
3. 完善的过滤机制：时间戳过滤对新闻追踪场景极为实用，避免陈旧结果干扰
4. 灵活的获取策略：自动分页模式可突破单次查询限制，确保数据完整性
5. 合规的凭证管理：API密钥通过环境变量注入，无硬编码敏感信息

局限性与注意事项

• API配额限制：每日25,000次调用上限，高频场景需规划请求频率
• 韩文内容专属：搜索结果以韩语为主，非韩语查询效果有限
• 需要前置注册：必须在Naver Developers平台注册应用并开通搜索权限
• 返回结果含HTML标签：标题和摘要中的 <b> 高亮标签需自行清洗
• 网络依赖单一：仅支持Naver官方API，无备用源

适用人群

• 韩语新闻监测与舆情分析从业者
• 需要韩国市场资讯的金融/商业研究人员
• 多语言内容聚合平台的开发者
• 对韩国科技、娱乐、政治动态有追踪需求的用户

常规风险提示

API调用需配置有效的Client ID/Secret，凭证泄露可能导致配额被滥用。建议通过安全的密钥管理系统注入，避免提交到版本控制。自动分页功能虽便捷，但会消耗更多API配额，需权衡数据完整性与配额消耗。