功能描述

Search, brief, and monitor Korean used-market listings across 당근마켓, 번개장터, and 중고나라. Use when the user wants 중고 매물 찾아줘, 당근/번장/중고나라 동시 검색, 아이폰/맥북 같은 물건의 신규 매물...

使用说明 (SKILL.md)

Used Market Watch

Name: Used Market Watch
Author: twbeatles

한국 중고거래 매물을 자연어 검색 / 채팅형 브리핑 / 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:

tmp/used-market-notifier-upstream
public repo: twbeatles/used-market-notifier

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

Scripts

1) 자연어 파싱 확인

python skills/used-market-watch/scripts/used_market_watch.py parse "잠실에서 아이폰 15 프로 120만원 이하 당근 번장만 -깨짐"

2) 원샷 검색 / 브리핑

python skills/used-market-watch/scripts/used_market_watch.py search "잠실에서 아이폰 15 프로 120만원 이하 당근 번장만 -깨짐"
python skills/used-market-watch/scripts/used_market_watch.py search "맥북 에어 m2 중고나라 포함" --json

출력 특징:

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

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

python skills/used-market-watch/scripts/used_market_watch.py watch-plan "아이폰 15 프로 1시간마다 신규만 감시해줘"
python skills/used-market-watch/scripts/used_market_watch.py watch-plan "맥북 에어 가격 내려가면 알려줘" --json
python skills/used-market-watch/scripts/used_market_watch.py watch-plan "플스5 매일 아침 8시에 브리핑해줘"
python skills/used-market-watch/scripts/used_market_watch.py integration-plan "아이폰 15 프로 신규 매물만 1시간마다 감시해줘"
python skills/used-market-watch/scripts/used_market_watch.py integration-plan "플스5 매일 아침 8시에 브리핑해줘" --json
python skills/used-market-watch/scripts/used_market_watch.py integration-plan "맥북 에어 가격 내려가면 알려줘" --persist --json
python skills/used-market-watch/scripts/used_market_watch.py watch-upsert "아이폰 15 프로 1시간마다 신규만 감시해줘"
python skills/used-market-watch/scripts/used_market_watch.py watch-upsert '"잠실 맥북 하락" 맥북 에어 m2 잠실 가격하락만 감시'

동작 특징:

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

4) watch rule 목록 / 상태 관리

python skills/used-market-watch/scripts/used_market_watch.py watch-list
python skills/used-market-watch/scripts/used_market_watch.py watch-enable "잠실 맥북 하락"
python skills/used-market-watch/scripts/used_market_watch.py watch-disable "잠실 맥북 하락"
python skills/used-market-watch/scripts/used_market_watch.py watch-remove "잠실 맥북 하락"

5) watch 점검 / 이벤트 피드

python skills/used-market-watch/scripts/used_market_watch.py watch-check
python skills/used-market-watch/scripts/used_market_watch.py watch-check --alerts-only --json
python skills/used-market-watch/scripts/used_market_watch.py watch-events --limit 20
python skills/used-market-watch/scripts/used_market_watch.py watch-events "잠실 맥북 하락" --json

점검 결과:

신규 매물(new_listing)
가격하락(price_drop)
각 rule별 snapshot 요약
summary.event_counts 포함 JSON
최근 이벤트 조회용 watch-events

Runtime notes

필수 준비:

pip install playwright
python -m playwright install chromium

테스트:

python -m pytest skills/used-market-watch/tests -q

Stored files

data/watch-rules.json: watch rule + last_seen + dedupe event state
references/upstream-notes.md: upstream 분석 메모
dist/used-market-watch.skill: 배포용 패키지 아티팩트

Recommended workflow

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

Current limitations

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

安全使用建议

This skill appears internally consistent: it scrapes Korean marketplace websites with Playwright, parses natural-language watch rules, and keeps local state in data/watch-rules.json. Before installing, note: (1) you must install Playwright and Chromium (these download browser binaries); (2) the skill will open network connections to third-party marketplaces (당근마켓, 번개장터, 네이버/중고나라) — be aware of site terms-of-service and possible bot-blocking; (3) it will create/modify data/watch-rules.json in the skill directory (check file permissions and contents); (4) no credentials are needed, and there are no hidden remote endpoints observed in the provided files. If you want extra assurance, review watch_store.py and the truncated parts locally to confirm there are no webhooks or unexpected external uploads, run the bundled tests (pytest), and run the tool in a sandboxed environment before giving it broader access or integrating into automated channels.

功能分析

Type: OpenClaw Skill Name: used-market-watch Version: 0.4.1 The skill is a legitimate tool for searching and monitoring Korean used-market listings across Daangn, Bunjang, and Joonggonara. It utilizes Playwright for web scraping and maintains local state in 'data/watch-rules.json' to track new items and price changes. The code is transparent, well-documented, and its functionalities—including cron-job suggestions in 'watch_intent.py' and natural language parsing in 'query_parser.py'—are strictly aligned with its stated purpose of market monitoring without any signs of malicious intent or data exfiltration.

能力评估

✓ Purpose & Capability

Name/description (search, brief, persistent watch of Korean used-market listings) match the code and CLI commands. The code implements Playwright-based scrapers for 당근마켓, 번개장터, 중고나라, natural-language parsing, local watch-rule storage, and watch/check flows — all coherent with the stated purpose.

✓ Instruction Scope

SKILL.md and scripts direct the agent to run local Python CLI commands, parse queries, run Playwright to scrape marketplaces, and read/write a local state file (data/watch-rules.json). There are no instructions to read unrelated system files or to transmit data to unexpected external endpoints.

ℹ Install Mechanism

There is no packaged install spec in the manifest (instruction-only), but runtime instructions require 'pip install playwright' and 'python -m playwright install chromium', which will download browser binaries. The repository includes all scraper code (no external download URLs). The required Playwright browser download is expected for headless scraping but is the only notable install-side action.

✓ Credentials

No environment variables, credentials, or config paths are requested. The skill stores state locally in data/watch-rules.json. No unrelated secrets or multiple service credentials are required.

✓ Persistence & Privilege

always is false and the skill persists only its own local state (data/watch-rules.json and events/last_seen structures). It does not attempt to alter other skills or system-wide agent configuration.

版本历史

v0.4.1

Improve natural-language query parsing and ignore local runtime artifacts

v0.4.0

Add integration-plan automation bundle for Korean monitoring requests, persistence shortcuts, and cron/operator guidance.

v0.3.0

Used Market Watch 0.3.0 adds support for parsing natural language scheduling and periodic watch requests. - Added support for interpreting time-based expressions (e.g., "1시간마다", "매일 아침 8시") in watch rules and natural language commands. - Enhanced intent parsing to detect periodic/cron-like scheduling and "브리핑" requests. - Watch rule planning now outputs recommended execution and cron examples for automation. - Updated documentation and usage examples to reflect new scheduling and briefing features. - Improved tests to cover scheduled rule parsing and relevant behaviors.

v0.2.0

Add natural-language monitoring workflows, watch planning/upsert commands, event feeds, and richer operator docs.

v0.1.0

Initial release: Korean used-market search, watch rules, and alert-friendly outputs.

元数据

Slug used-market-watch

版本 0.4.1

许可证 MIT-0

累计安装 1

当前安装数 1

历史版本数 5

常见问题