Used Market Watch

한국 중고거래 매물을 자연어 검색 / 채팅형 브리핑 / persistent watch rule / 신규·가격하락 체크 / 주기 해석 기반 운영 계획 형태로 다루는 OpenClaw 스킬이다.

핵심 원칙:

• - chat-first: 사람이 읽는 한국어 브리핑을 먼저 만든다.
• json-ready: cron/상위 레이어 연결용 JSON도 바로 뽑는다.
• watch-state 단순화: GUI/DB 대신 data/watch-rules.json 하나로 상태를 유지한다.
• natural-language ops: 검색과 감시 등록을 분리하지 않고 한 줄 한국어 요청에서 watch intent를 최대한 바로 해석한다.
• plan-aware: 1시간마다, 30분마다, 매일 아침 8시, 브리핑해줘 같은 운영 문장을 rule 메타와 실행 힌트로 변환한다.
• upstream 계승: used-market-notifier의 마켓 범위, 가격 파싱, Playwright 검색 감각, 신규/가격하락 개념을 OpenClaw용 CLI로 재구성했다.

Source dependency / analysis

분석 기준 upstream:

• - INLINECODE6
• public repo: INLINECODE7

핵심 참고 내용은 references/upstream-notes.md에 정리돼 있다.

Scripts

1) 자연어 파싱 확인

2) 원샷 검색 / 브리핑

출력 특징:

• - 마켓별 개수 요약
• 대표 매물 리스트
• 링크 포함
• text / JSON 선택 가능

3) 자연어 watch 미리보기 / 저장

동작 특징:

• - 신규만, 가격하락만, 가격 내려가면 같은 표현을 해석한다.
• INLINECODE12, 30분마다, 매일 아침 8시 같은 주기 표현을 해석한다.
• INLINECODE15, 요약해줘 같은 표현을 브리핑 모드로 해석한다.
• INLINECODE17, 10건 같은 limit 힌트를 반영한다.
• 이름을 따로 안 주면 keyword 기반 규칙 이름을 만든다.
• 같은 이름이 있으면 watch-upsert가 갱신한다.
• INLINECODE20은 저장 명령, 실행 명령, cron payload, systemEvent 힌트, 사용자 확인 문구까지 한 번에 묶어 준다.
• 해석 결과에 권장 실행 명령과 cron 예시를 포함한다.

4) watch rule 목록 / 상태 관리

5) watch 점검 / 이벤트 피드

점검 결과:

• - 신규 매물(new_listing)
• 가격하락(price_drop)
• 각 rule별 snapshot 요약
• INLINECODE23 포함 JSON
• 최근 이벤트 조회용 INLINECODE24

Runtime notes

필수 준비:
CODEBLOCK5

테스트:
CODEBLOCK6

Stored files

• - data/watch-rules.json: watch rule + last_seen + dedupe event state
• INLINECODE26: upstream 분석 메모
• INLINECODE27: 배포용 패키지 아티팩트

Recommended workflow

1. 1. 사용자가 한 줄로 원하는 물건/가격/마켓을 말하면 search로 먼저 브리핑한다.
2. 반복 추적이 필요하면 watch-plan으로 해석을 확인하거나 바로 watch-upsert로 규칙을 저장한다.
3. 채팅 자동화/cron 연결이 목적이면 integration-plan으로 저장 명령, 실행 명령, cron payload, systemEvent 힌트를 한 번에 만든다.
4. heartbeat/cron에서는 watch-check --alerts-only --json 또는 특정 rule 대상 watch-check "이름" --json을 사용한다.
5. 운영 중에는 watch-list, watch-events, watch-enable, watch-disable로 상태를 관리한다.
6. 상위 레이어(OpenClaw)가 텔레그램/디스코드 전달을 담당한다.

Current limitations

• - 각 마켓 DOM 구조 변경에 민감하다.
• 로그인 필요/봇 차단이 강한 상황에서는 결과가 줄 수 있다.
• 중고나라는 네이버 검색 결과 기반이라 가격 정보가 제한적일 수 있다.
• 현재는 Playwright 단일 경로이며 Selenium fallback은 넣지 않았다.