Whatsapp Reader

whatsapp-reader

**Lê as suas conversas do WhatsApp e as entrega a um agente por MCP. Não envia mensagem.**

*Read-only WhatsApp bridge exposing MCP tools. It never sends messages — sending is refused by design, not missing by accident. Written for a Portuguese-language plugin; docs below are in Portuguese.*

---

Não procure aqui o que ele não faz

Se você chegou querendo **disparar mensagem, automatizar atendimento ou responder cliente sozinho**, este não é o projeto — e não é falta de tempo de implementar. Enviar em massa é o que faz uma conta de WhatsApp ser bloqueada, e quem usa isto atende do número pessoal, onde estão os clientes dele.

O que sai daqui é texto para uma pessoa ler, copiar e enviar com o próprio dedo.

Para que existe

Ele serve à [Oficina Kapstan](https://kapstan.com.br/oficina) — um pack de dez skills para corretor de imóveis. Sem ele, o corretor cola a conversa na mão, e tudo funciona igual. Com ele, o agente lê a conversa direto.

**O conector é opcional em todo o pack.** Nenhuma skill exige, e é o contrato delas que garante isso.

O que é, e o que não é

Não é fork de nada. São ~720 linhas que usam o [whatsmeow](https://github.com/tulir/whatsmeow), a biblioteca que fala o protocolo do WhatsApp:

banco.go     esquema SQLite e as consultas
servir.go    o daemon: conecta, pareia, captura histórico e mensagens
mcp.go       o protocolo MCP, JSON-RPC sobre stdio, escrito à mão
main.go      os dois subcomandos

O MCP é escrito à mão porque são quatro métodos — `initialize`, `ping`, `tools/list`, `tools/call`. Um SDK custaria mais que o protocolo inteiro.

Compilar

Precisa de Go. **Não precisa de compilador C**: o driver SQLite é `modernc.org/sqlite`, em Go puro.

git clone https://github.com/kapstanhq/whatsapp-reader
cd whatsapp-reader
CGO_ENABLED=0 go build -o whatsapp-reader .

Compilação cruzada funciona de qualquer máquina para qualquer alvo:

CGO_ENABLED=0 GOOS=darwin GOARCH=arm64 go build -o what