用途:该技能面向 Naver API HUB 的三类数据请求——搜索、DataLab 搜索趋势、Shopping Insight 类别或关键词趋势。支持搜索类型为 blog、news、cafearticle、kin、local、encyc、webkr、image、adult、errata。已下线的 shop、book、doc 搜索类型不受支持,也不处理任意 URL 或端点、网页抓取、Naver 登录自动化或无关研究;若目标是网页而非 API HUB,应改用浏览器工具。
主要能力:检查本地 CLI 是否可用、版本与配置状态;按官方方式安装已发布包;通过其支持命令写入本地 CLI 配置;创建临时请求输入并发起所需 API 调用。使用 --json 时便于机器解析。趋势比值属于归一化指数(最大为 100),并非绝对搜索量,需在结果中说明。
使用方式:先确认 Node.js 不低于 20,并检查 naver-api 是否可用;缺失时用文档给出的全局 npm 命令安装 @kood/naver-api-cli,再执行 naver-api --help 验证。运行 naver-api config validate 检查配置;若配置缺失或无效,通过 CLI 的隐藏提示或 stdin 流程让用户输入自己的 API HUB apiKeyId 与 apiKey,不要将密钥粘贴到对话,也不要写入参数、日志或提交文件。构造最小有效请求,趋势输入使用临时 YAML/JSON 文件或 stdin,且不在其中保存凭据。执行一次后检查 stdout、stderr 与退出状态,仅在确定是用法或配置形状错误时修正并重试一次,不盲目重试认证、限流、上游或网络故障。
适用场景:Naver 新闻、博客等搜索请求;DataLab 中多关键词的搜索趋势比较;Shopping Insight 类别或关键词趋势对比,并需要 JSON 输出时。
限制:需具备命令执行、Node.js/npm 与网络访问能力;缺少安装权限或能力、Node.js 低于 20、凭据不可用、范围无效或出现不可重试的 API 错误时应阻断。不要编辑产品代码或调用未注册端点。CLI 行为依据其 README 与包元数据;若信息不足,以实际 CLI 版本与 README 为准。具体收费、价格与更多功能细节暂未提供。