Community생산성 & 협업github.com

steipete/whatsapp

WhatsApp 라우터: 기록/검색/읽기/보내기; wacrawl 읽기 전용, waccli 라이브.

whatsapp란 무엇인가요?

이 스킬은 WhatsApp 관련 작업을 위한 중앙 라우터 역할을 합니다. 두 가지 주요 도구를 구분하여 사용합니다: 'wacrawl'은 WhatsApp Desktop 아카이브를 읽기 전용으로 검색하고 기록을 제공하며, 'wacli'는 연결된 기기 계정을 통해 라이브 동기화, 인증, 메시지 전송, 채팅 및 그룹 변형 등 쓰기 작업을 처리합니다. 사용자가 두 도구 중 하나를 특정하면, 해당 도구의 개별 스킬 문서도 함께 참조하도록 지시합니다. 이 스킬은 데이터 소스의 신선도와 정확성을 유지하기 위한 다양한 안전 장치를 포함하며, 명시적인 사용자 요청 없이는 메시지 전송이나 상태 변경을 절대 수행하지 않습니다. 주로 Claude Code, Cursor, Codex와 같은 AI 에이전트 플랫폼에서 사용되며, 사용자의 의도를 명확히 파악하여 적절한 읽기/쓰기 작업을 지시하도록 설계되었습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/whatsapp

Installed? Explore more 생산성 & 협업 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

whatsapp은(는) 무엇을 하나요?

WhatsApp 작업의 첫 번째 진입점으로 사용하세요. 소스 경계를 명확히 유지하세요:

  • wacrawl: 기본 WhatsApp Desktop 아카이브입니다. 읽기 전용, 최상의 로컬 기록, 네트워크 없음, 전송 없음.
  • wacli: 연결된 기기 계정입니다. 대체 계정, 라이브 동기화, 인증, 전송, 채팅/그룹 변형, WhatsApp Web 프로토콜 질문에 사용합니다.

사용자가 wacrawl 또는 wacli 저장소 작업을 구체적으로 언급하는 경우, 해당 도구의 자체 스킬도 읽어보세요.

라우팅

  • 기본 WhatsApp 읽기/검색/기록: wacrawl을 사용하세요.
  • WhatsApp Desktop의 읽음/안 읽음 개수: wacrawl을 사용하세요. 채팅 수준의 안 읽음 개수는 있지만 메시지별 읽음 상태는 없습니다.
  • 신선도가 중요한 기본 읽기: wacrawl status를 확인하고, 요청 시 또는 현재 데이터가 중요한 경우 wacrawl sync를 실행하세요.
  • me, molty 또는 이름이 지정된 저장소와 같은 대체 계정: wacli --account NAME을 사용하세요.
  • 전송, 반응, 상태, 보관/고정/음소거/읽음 표시, 그룹/채널 변형: 명시적인 사용자 의도가 있을 때만 wacli를 사용하세요.
  • 소스 간 적용 범위 비교: wacrawl을 기본 기록의 Desktop 아카이브 진실로, wacli를 연결된 기기/라이브 적용 범위(프로토콜 제한 있음)로 취급하세요.

안전

  • 명시적으로 요청되지 않는 한 WhatsApp 상태를 전송하거나 변경하지 마세요.
  • 검사에는 읽기 전용 wacli 명령을 선호하세요: --read-only 플래그를 전달하거나 WACLI_READONLY=1을 설정하세요.
  • WhatsApp Desktop의 앱 컨테이너에 쓰지 마세요.
  • wacli session.db를 직접 편집하지 마세요.
  • 이름이 지정된 wacli 계정을 격리된 상태로 유지하고 저장소를 병합하지 마세요.
  • 로컬 저장소에서 답변할 때 소스 신선도, 계정 이름 및 알려진 차이점을 보고하세요.

일반 명령어

기본 아카이브

신선도 및 상태:

wacrawl status
wacrawl doctor
wacrawl sync

안 읽음 트리지:

wacrawl chats --limit 20
wacrawl unread --limit 20
wacrawl --json unread --limit 100

메시지 검색 및 슬라이스:

wacrawl messages --after 2026-01-01 --limit 50
wacrawl messages --chat JID --asc --limit 100
wacrawl messages --has-media --limit 50
wacrawl --json search "query"
wacrawl search "query" --after 2026-01-01 --from-them

미디어 또는 백업 아카이브(요청 시에만):

wacrawl import --copy-media
wacrawl backup status
wacrawl --sync never backup push

대체/라이브 계정

계정 검색 및 읽기 전용 검사:

wacli accounts list --json
wacli --account me auth status --read-only --json
wacli --account me chats list --read-only --json
wacli --account me messages list --read-only --json --limit 50
wacli --account me messages search --read-only --json "query"

백그라운드 라이브 동기화(요청 시에만). 팔로우 모드에는 tmux를 선호하세요:

wacli --account me sync --follow --events
wacli --account me sync --once --events

미디어, 전송 및 라이브 변형(명시적으로 요청된 경우에만):

wacli --account me media download --chat JID --id MESSAGE_ID
wacli --account me send text --to JID_OR_NAME --message "message"
wacli --account me send file --to JID_OR_NAME --file ./file.jpg --caption "caption"
wacli --account me send text --to JID --reply-to MESSAGE_ID --message "reply"

비교

wacrawl과 wacli를 비교할 때는 두 도구의 개수와 중복을 모두 비교하세요:

  • 메시지 개수 및 날짜 범위
  • 채팅 개수
  • 최신 메시지 타임스탬프
  • msg_id로 중복 확인
  • JID가 충분히 정규화된 경우 chat_jid + msg_id로 중복 확인
  • 연결된 기기 기록 제한과 Desktop 아카이브 적용 범위 간의 차이로 설명되는 명백한 차이점

저장소 포인터

  • ~/Projects/wacrawl: Desktop 아카이브 임포터/검색/백업.
  • ~/Projects/wacli: 연결된 기기 클라이언트/동기화/전송.
  • 글로벌 스킬 복사본: ~/Projects/agent-scripts/skills/wacrawl 및 ~/Projects/agent-scripts/skills/wacli.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

관련 스킬