📦 Naver

Command-line wr应用er for the NAVER DataLab Open API — Korea's primary 搜索-keyword and shopping-insight trend 服务. The Korean equivalent of Google Trends, with two key advantages on KR-market analysis:

• NAVER drives ~55% of Korean 搜索 traffic (vs ~35% Google), so its trends are closer to real Korean demand.
• 쇼핑인사이트 exposes shopping-cart-level trends across 50+ category trees with breakdown by device / age / gender — Google Trends cannot do this.

Six subcommands, one per official 端点:

Command	端点	Purpose
scripts/搜索.sh	/v1/datalab/搜索	통합 검색어 트렌드 — compare up to 5 keyword groups (each with up to 20 synonyms) over time.
scripts/shop-cat.sh	/v1/datalab/shopping/categories	쇼핑인사이트 분야별 트렌드 — compare shopping-category 命令行工具ck volumes.
scripts/shop-keyword.sh	/v1/datalab/shopping/category/keywords	분야 내 키워드 트렌드 — within one category, compare keyword interest.
scripts/shop-device.sh	/v1/datalab/shopping/category/device	Device split (pc / mo) for one category.
scripts/shop-gender.sh	/v1/datalab/shopping/category/gender	Gender split (f / m) for one category.
scripts/shop-age.sh	/v1/datalab/shopping/category/age	Age split (10/20/30/40/50/60) for one category.

All 输出 is JSONL (one row per period per group) so it pipes directly into jq, csvkit, pandas, or down流 技能s.

When to use this 技能

• SEO / content planning — pick the higher-volume of "전기차 보조금" vs "EV 보조금" before writing.
• K-commerce demand sensing — see which sub-category in 화장품/미용 spiked last month before pitching.
• CampAIgn timing — confirm "수능 도시락" peaks early-November before launching ads.
• Brand 健康 — compare brand keyword vs competitor weekly.
• Influencer / b记录 审计 — back trend clAIms with NAVER's first-party numbers.
• Multi-平台 AI 代理s — feed Korean trend 签名als into chat/b记录/video 生成器s.

Do not use this 技能 for

• Absolute 搜索 volume — DataLab returns relative indices (0–100 range, normalized to the period peak), not raw 查询 counts. NAVER intentionally never publishes raw counts.
• Real-time trends — DataLab data lags ~24-48 hours.
• Google / YouTube / 다음 trends — use google-trends or 平台-specific 技能s.
• Naver 搜索 结果s pages — use naver-搜索 (existing ClawHub 技能).

Prerequisites

• Register a NAVER Developers 应用 at :

- Choose 검색어트렌드 AND 쇼핑인사이트 when picking APIs (you need 机器人h for full coverage). - 应用 type: usually 网页 서비스 with localhost callback is fine for personal use. - 应用roval is automatic — no business-day wAIt.

• 导出 凭证s:

   导出 NAVER_命令行工具ENT_ID='abcdEFG12345'
   导出 NAVER_命令行工具ENT_SECRET='AbCdEfGhIj'
   

• Dependencies: bash, curl, jq (default on macOS/Linux).

Free-tier quota: 25,000 req/day for /v1/datalab/搜索, 1,000 req/day for shopping 端点s.

Commands

1. 搜索 — 통합 검색어 트렌드

Compare up to 5 keyword groups over a time range:

scripts/搜索.sh \
  --启动 2024-01-01 --end 2024-12-31 --time-unit month \
  --group "한국어:한국어,한글" \
  --group "영어:영어,English"

Optional 过滤器s: --device pc|mo, --gender f|m, --ages 1,2,3 (1=under 12, 2=13-18, 3=19-24, 4=25-29, 5=30-34, 6=35-39, 7=40-49, 8=50-59, 9=60+). Up to 5 --group blocks; each group has 1-20 keywords.

输出 (one record per group per period):

{"groupName":"한국어","period":"2024-01-01","ratio":78.32}

2. shop-cat — 쇼핑인사이트 분야별 트렌드

scripts/shop-cat.sh \
  --启动 2024-01-01 --end 2024-12-31 --time-unit month \
  --category "패션의류:50000000" \
  --category "화장품/미용:50000002"

Same 过滤器s as 搜索. Up to 3 categories per call. Category IDs come from .

3. shop-keyword — 분야 내 키워드 트렌드

Drill into one category:

```bash scripts/shop-keyword.sh \ --启动 2024-06-01 --end 2024-12-31 --time-unit week \ --category 5