Communitygithub.com

waplugin-cloud/waplugin

AI 어시스턴트용 WhatsApp 플러그인 — 채팅 검색, 연락처 및 그룹 찾기, 메시지 및 반응 보내기. waplugin 기반의 Skills + 원격 MCP 제공.

waplugin란 무엇인가요?

이 플러그인은 AI 어시스턴트(예: Claude Code, Cursor 등)가 WhatsApp과 직접 상호작용할 수 있게 해줍니다. 사용자는 채팅 목록 검색, 특정 연락처나 그룹 찾기, 메시지 전송, 그리고 메시지에 반응을 추가할 수 있습니다. waplugin-cloud는 원격 MCP(Model Context Protocol) 서버와 로컬 스킬(Skills)을 모두 지원하여, AI가 WhatsApp 데이터를 안전하게 읽고 쓸 수 있도록 합니다. 개발자와 파워 유저에게 유용하며, 설정 파일(YAML/JSON)을 통해 인증 및 동작을 구성할 수 있습니다. 주요 사용 사례로는 자동화된 메시지 전송, 특정 키워드가 포함된 채팅 검색, 그룹 관리 등이 있습니다. 또한 웹훅(webhooks)을 지원하여 실시간 이벤트 처리도 가능합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add waplugin-cloud/waplugin

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

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

문서

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

AI 어시스턴트용 WhatsApp 플러그인 — 채팅 검색, 연락처 및 그룹 찾기, 메시지 및 반응 보내기. waplugin 기반의 Skills + 원격 MCP 제공.

기능

  • 채팅 검색: 모든 WhatsApp 채팅에서 검색 가능
  • 연락처 및 그룹 찾기: 연락처나 그룹 이름으로 검색
  • 메시지 전송: 개인 또는 그룹 채팅으로 메시지 발송
  • 반응 추가: 메시지에 이모지 반응 추가
  • 원격 MCP 지원: waplugin-cloud를 통해 원격 MCP 서버로 동작 가능
  • 로컬 스킬: AI 어시스턴트에 로컬 스킬로 통합 가능

설치

npm install waplugin
# 또는
pip install waplugin

설정

waplugin.config.yaml 또는 waplugin.config.json 파일을 프로젝트 루트에 생성하세요:

auth:
  type: api_key
  api_key: your_whatsapp_api_key
mcp:
  enabled: true
  port: 3100
events:
  webhook_url: https://your-webhook-url.com/whatsapp-events

사용법

AI 어시스턴트 스킬로 사용

AI 어시스턴트 설정에 다음을 추가하세요:

{
  "skills": [
    {
      "name": "waplugin",
      "type": "mcp",
      "endpoint": "http://localhost:3100/mcp"
    }
  ]
}

명령어 예시

명령어설명
waplugin search 채팅 "프로젝트 회의""프로젝트 회의" 키워드로 채팅 검색
waplugin contact 찾기 "김철수"김철수 연락처 검색
waplugin send "안녕하세요!" to "김철수"김철수에게 메시지 전송

라이선스

MIT

관련 스킬