whatsapp-skill

WhatsApp スキル - メッセージの自動化

WhatsApp Web の自動化を通じて、メッセージの送信、チャットの閲覧、WhatsApp の検索を行います。

重要：メッセージの送信には確認が必要です

WhatsApp メッセージを送信する前に、必ずユーザーから明示的な確認を得てください。

ユーザーからメッセージの送信を依頼された場合：

1. まず、メッセージの詳細をすべて提示します：
   • 送信先（電話番号またはグループ）
   • メッセージ全文
   • 使用するセッション
2. 「この WhatsApp メッセージを送信してもよろしいですか？」と尋ねます。
3. ユーザーが明示的に確認した後にのみ、送信コマンドを実行します。
4. 確認なしに送信してはいけません。

初回セットアップ

cd ~/.claude/skills/whatsapp-skill
npm install

以下がインストールされます：

• whatsapp-web.js - WhatsApp Web の自動化
• qrcode-terminal - 認証用 QR コードの表示

認証

初回は、スマートフォンで QR コードをスキャンする必要があります：

node ~/.claude/skills/whatsapp-skill/whatsapp_skill.js auth

1. ターミナルに QR コードが表示されます
2. スマートフォンで WhatsApp を開きます
3. 設定 → リンク済みデバイス → デバイスをリンク に移動します
4. QR コードをスキャンします
5. セッションは次回以降のために保存されます

コマンド

認証とステータス

# Authenticate (scan QR)
node ~/.claude/skills/whatsapp-skill/whatsapp_skill.js auth [--session NAME]

# Check status
node ~/.claude/skills/whatsapp-skill/whatsapp_skill.js status [--session NAME]

# Logout
node ~/.claude/skills/whatsapp-skill/whatsapp_skill.js logout [--session NAME]

メッセージの送信（確認が必要）

# Send to phone number (include country code, no + or spaces)
node ~/.claude/skills/whatsapp-skill/whatsapp_skill.js send 14155551234 "Hello!" [--session NAME]

# Send to group
node ~/.claude/skills/whatsapp-skill/whatsapp_skill.js send-group GROUP_ID "Hello group!" [--session NAME]

チャットとメッセージの閲覧

# List recent chats
node ~/.claude/skills/whatsapp-skill/whatsapp_skill.js chats [--limit N] [--session NAME]

# Get messages from a chat
node ~/.claude/skills/whatsapp-skill/whatsapp_skill.js messages CHAT_ID [--limit N] [--session NAME]

# Search messages
node ~/.claude/skills/whatsapp-skill/whatsapp_skill.js search "query" [--session NAME]

連絡先とグループ

# List contacts
node ~/.claude/skills/whatsapp-skill/whatsapp_skill.js contacts [--session NAME]

# List groups
node ~/.claude/skills/whatsapp-skill/whatsapp_skill.js groups [--session NAME]

複数アカウントのサポート

異なる WhatsApp アカウントには --session フラグを使用します：

# Personal account
node ~/.claude/skills/whatsapp-skill/whatsapp_skill.js auth --session personal

# Work account
node ~/.claude/skills/whatsapp-skill/whatsapp_skill.js auth --session work

# Send from specific account
node ~/.claude/skills/whatsapp-skill/whatsapp_skill.js send 14155551234 "Hi" --session work

セッションは ~/.claude/skills/whatsapp-skill/sessions/ に保存されます。

電話番号の形式

必ず、+ やスペースを含めず、国際形式の完全な番号を使用します：

• 米国：14155551234（1 = 国番号）
• 英国：447911123456（44 = 国番号）
• インド：919876543210（91 = 国番号）

チャット ID

チャット ID は chats コマンドで返されます：

• 個人チャット：[email protected]
• グループチャット：[email protected]

使用例

短いメッセージを送信する

node ~/.claude/skills/whatsapp-skill/whatsapp_skill.js send 14155551234 "Meeting at 3pm today?"

最近のチャットを確認する

node ~/.claude/skills/whatsapp-skill/whatsapp_skill.js chats --limit 5

連絡先からのメッセージを読む

node ~/.claude/skills/whatsapp-skill/whatsapp_skill.js messages [email protected] --limit 10

何かを検索する

node ~/.claude/skills/whatsapp-skill/whatsapp_skill.js search "meeting agenda"

出力

すべてのコマンドは、解析しやすい JSON を出力します。

要件

• Node.js 16+
• npm
• Chrome/Chromium（puppeteer により自動的にインストールされます）

重要な注意事項

• セッションごとに電話番号は1つ：各 WhatsApp アカウントを同時にリンクできるセッションは1つだけです
• 接続を維持する：スマートフォンが長時間インターネットに接続できないと、WhatsApp が切断されることがあります
• レート制限：スパムを送信しないでください。不審なアクティビティがあると、WhatsApp がアカウントを停止することがあります
• ビジネスアカウント：個人アカウントと WhatsApp Business アカウントの両方で動作します

セキュリティに関する注意事項

• メッセージの送信には確認が必要です - Claude はメッセージを送信する前に確認する必要があります
• セッションデータは ~/.claude/skills/whatsapp-skill/sessions/ に保存されます
• セッションには認証データが含まれています。安全に保管してください
• ログアウトすると、コンピューターからセッションデータが削除されます（ただし、WhatsApp でリンクを解除するまでデバイスのリンクは維持されます）

トラブルシューティング

QR コードが表示されませんか？

• puppeteer の依存関係がインストールされていることを確認してください：npx puppeteer browsers install chrome

認証に繰り返し失敗しますか？

• セッションフォルダーを削除して、再認証してください
• スマートフォンがインターネットに接続されていることを確認してください

メッセージを送信できませんか？

• 電話番号の形式を確認してください（国番号を含め、スペースやハイフンは使用しない）
• 連絡先にブロックされていないか確認してください
• スマートフォンで WhatsApp が引き続き接続されていることを確認してください