naver-news-briefing

# naver-news-briefing Use the CLI script at `scripts/naver_news_briefing.py`. ## Onboarding - Treat Naver Search API credentials as mandatory before the first real use. - Tell the user early that search/briefing/watch flows will fail until `client_id` and `client_secret` are stored. - If the user has not completed setup yet, direct them to run: - `python scripts/naver_news_briefing.py setup --client-id ... --client-secret ...` - `python scripts/naver_news_briefing.py check-credentials --json` - Present setup as the first-run path, not an optional advanced step. - When helping with installation or first use, mention that credentials are stored in `data/config.json` and use DPAPI-backed secret storage on Windows when possible. ## Workflow 1. Store credentials once before any search/brief/watch command. - `python scripts/naver_news_briefing.py setup --client-id ... --client-secret ...` - Verify with `python scripts/naver_news_briefing.py check-credentials --json` 2. Run a one-shot briefing. - `python scripts/naver_news_briefing.py search "최근 3일 반도체 뉴스 브리핑 -광고"` - Add `--json` for machine-readable output. 3. Manage persistent watch rules with optional operator metadata. - Add: `python scripts/naver_news_briefing.py watch-add semiconductor "최근 7일 반도체 -광고" --label "반도체 감시" --tag watch --template watch-alert` - List: `python scripts/naver_news_briefing.py watch-list` - Remove: `python scripts/naver_news_briefing.py watch-remove semiconductor` - Check: `python scripts/naver_news_briefing.py watch-check semiconductor --json` 4. Manage persistent keyword groups for recurring briefings. - Add: `python scripts/naver_news_briefing.py group-add market-watch "최근 3일 반도체 -광고" "오늘 AI 데이터센터 -주가" --label "아침 시장" --tag 테크 --context "오전 보고용" --template morning-briefing` - List: `python scripts/naver_news_briefing.py group-list` - Inspect one group: `python scripts/naver_news_briefing.py group-list market-watch --json` - Update: `python scripts/naver_news_briefing.py group-update market-watch --add-query "배터리 공급망 -광고" --tag 공급망 --template analyst` - Remove: `python scripts/naver_news_briefing.py group-remove market-watch` 5. Run combined briefings. - `python scripts/naver_news_briefing.py brief-multi --group market-watch` - `python scripts/naver_news_briefing.py brief-multi --group market-watch --query "환율 뉴스" --template morning-briefing --json` - If `--template` is omitted, prefer the saved group template when present. 6. Convert chat-style automation requests into structured plans. - Inspect plan: `python scripts/naver_news_briefing.py plan "반도체 뉴스 1시간마다 모니터링해줘" --json` - Build an OpenClaw-friendly integration bundle: `python scripts/naver_news_briefing.py integration-plan "반도체 뉴스 1시간마다 모니터링해줘" --json` - Support practical Korean patterns such as `매일 아침 7시에 반도체랑 AI 데이터센터 뉴스 브리핑해줘` and `증권사 리포트 빼고 삼성전자 뉴스 계속 체크해줘`. 7. Materialize plans into persistent configs. - Watch: `python scripts/naver_news_briefing.py plan-save "반도체 뉴스 1시간마다 모니터링해줘" --as watch --name semiconductor-hourly` - Group: `python scripts/naver_news_briefing.py plan-save "매일 아침 7시에 반도체랑 AI 데이터센터 뉴스 브리핑해줘" --as group --name morning-tech --label "아침 브리핑"` ## Behavior - Parse positive keywords and `-제외어` using the upstream tab-search policy. - Interpret recent-news phrases such as `오늘`, `최근 3일`, `최근 2주`, `한달`, `이번주`, `지난주` as a date window and remove that phrase from the API search query. - Normalize more natural Korean sentence inputs by stripping request phrases, common 조사, duplicate tokens, and Korean exclusion phrases such as `A 말고`, `B 빼고`, `C 제외` into `-제외어` tokens. - Parse practical schedule intent from Korean chat requests into `interval`, `daily`, `weekly`, or `manual` plans. - Preserve operator-facing metadata on saved watch/group entries: `label`, `tags`, `template`, `schedule`, `operator_hints`, and original request context. - Use DPAPI-backed secret storage on Windows when possible. - Deduplicate watch notifications by `(watch_id, link)` so repeated cron runs emit only newly seen items. - `plan` returns cron-friendly operator hints, recommended commands, and a storage-target recommendation (`watch` vs `group`). - `integration-plan` returns a more practical operator bundle: save command, run command, schedule object, cron line, OpenClaw-friendly systemEvent text, and a Korean confirmation summary. - `plan-save` materializes a parsed plan into a saved `watch` or `group` configuration without owning cron wiring itself. - `brief-multi` returns chat-friendly combined text by default and structured JSON with `--json`. ## Notes - Read `references/upstream-notes.md` before major edits. - The skill uses headline/summary metadata from the Naver Search API. It does not fetch or summarize full article bodies. - Keep additions additive: preserve existing `search`, `watch-add`, `watch-list`, `watch-remove`, and `watch-check` flows. - Public user-facing documentation lives in `README.md`; keep it Korean-first and concrete.