steipete/whatsapp

WhatsApp ルータ:履歴/検索/読み取り/送信;wacrawl 読み取り専用、wacli ライブ。

whatsapp とは?

このスキルは、WhatsApp 開発作業のための統一的なエントリポイントを提供します。`wacrawl` と `wacli` という2つのツールを適切にルーティングし、データソース間の境界を明確に保ちます。`wacrawl` は WhatsApp Desktop のローカルアーカイブであり、読み取り専用で完全な履歴検索が可能です。一方、`wacli` はリンクデバイス(スマートフォンなど)として動作し、メッセージ送信、グループ変更、ライブ同期などのミューテーション操作をサポートします。安全性を重視し、明示的なユーザー意図なしに状態を変更しないよう設計されています。Claude Code、Cursor、Codex などの AI エージェントで使用でき、複数のWhatsAppアカウント管理や履歴調査に役立ちます。

対応~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.

関連スキル