Skip to content
Back to search

outbound-leads

MarketplaceWorks with Claude CodeGitHub

Plugins de outbound e extração de leads.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/erickmourasilva--outbound-leads/badge.svg)](/listings/erickmourasilva--outbound-leads)

HTML

<a href="/listings/erickmourasilva--outbound-leads"><img src="/api/listings/erickmourasilva--outbound-leads/badge.svg" alt="findsafeskills safety rating" /></a>

Install

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 14 lines
  1. {
  2. "name": "outbound-leads",
  3. "description": "Plugins de outbound e extração de leads.",
  4. "owner": {
  5. "name": "Erick Moura"
  6. },
  7. "plugins": [
  8. {
  9. "name": "outbound-leads",
  10. "source": "./",
  11. "description": "Extrai e segmenta leads (clientes, parceiros, concorrentes), envia DMs no Instagram aos poucos e configura a BluBash para atender as respostas com agente de IA com aprovação do operador e acompanha tudo num painel local com previsão de término."
  12. }
  13. ]
  14. }
README.md · README · 145 lines
  1. # outbound-leads
  2. **Outbound responsável e supervisionado por humanos, para a era dos agentes de IA.** Extraia e segmente leads de fontes públicas, envie DMs no Instagram aos poucos, com aprovação, e acompanhe tudo num painel local ao vivo.
  3. [![CI](https://github.com/erickmourasilva/outbound-leads/actions/workflows/ci.yml/badge.svg)](https://github.com/erickmourasilva/outbound-leads/actions/workflows/ci.yml)
  4. [![Licença: MIT](https://img.shields.io/badge/licen%C3%A7a-MIT-blue.svg)](LICENSE)
  5. ![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue)
  6. ![macOS | Linux | Windows](https://img.shields.io/badge/plataforma-macOS%20%7C%20Linux%20%7C%20Windows-lightgrey)
  7. > 🇬🇧 [Read in English](README.en.md)
  8. ![Painel com dados fictícios de demonstração](docs/dashboard.png)
  9. *O painel, rodando com dados fictícios de demonstração.*
  10. ## Por quê
  11. O outbound costuma falhar de duas formas: disparos em massa que queimam a conta e a reputação, ou planilhas que ninguém mantém. O `outbound-leads` é o caminho do meio:
  12. - **Extrair primeiro, enviar depois.** A lista é montada e segmentada antes de qualquer mensagem sair.
  13. - **Gradual por construção.** Aquecimento, teto diário, horário comercial, intervalo entre mensagens e parada automática no primeiro alerta da plataforma.
  14. - **Um humano no comando.** Nada é enviado sem a sua aprovação. A janela do navegador é sempre visível, e o login é seu.
  15. - **Feito para agentes de IA.** Instale como plugin do Claude Code (ou aponte qualquer agente para o `AGENTS.md`) e peça. Todo comando imprime JSON.
  16. - **Seus dados são seus.** Um arquivo SQLite local em `~/.outbound-leads`. Sem nuvem, sem telemetria.
  17. ## Instalação
  18. **Claude Code (plugin + skill):**
  19. ```
  20. /plugin marketplace add erickmourasilva/outbound-leads
  21. /plugin install outbound-leads@outbound-leads
  22. ```
  23. Depois peça: *"use o outbound-leads para extrair parceiros dos diretórios dos meus concorrentes e montar a fila."* Ou chame a skill direto: `/outbound-leads:prospect`. A skill roda o `setup`, instala o que falta e conduz o resto.
  24. **Outros agentes (Codex etc.):** clone o repositório e peça para o agente ler o `AGENTS.md`.
  25. **Manual:**
  26. ```bash
  27. git clone https://github.com/erickmourasilva/outbound-leads && cd outbound-leads
  28. ./setup.sh # instala o que falta (Windows: .\setup.ps1)
  29. python3 -m outbound serve # painel em http://127.0.0.1:8787
  30. ```
  31. Para testar sem tocar em dados reais:
  32. ```bash
  33. export OUTBOUND_HOME=/tmp/outbound-demo
  34. python3 -m outbound demo && python3 -m outbound serve
  35. ```
  36. ## A BluBash atende as respostas
  37. O outbound **abre** a conversa. Quem responde precisa ser atendido na hora, qualificado e levado ao funil, ou a venda esfria. Por isso o ecossistema é desenhado em torno da **[BluBash](https://blubash.io)**: um CRM com agentes de IA autônomos (qualificam, agendam, cobram e movem o negócio no pipeline) e funis, já encaixado neste outbound. **O envio só é liberado quando as respostas têm destino.** Toda conta nova começa com **7 dias de teste**.
  38. Você não configura nada na mão. A skill [`blubash-setup`](skills/blubash-setup/SKILL.md) cria a conta (login com Google), o workspace, o agente de IA de vendas, o treinamento, as habilidades e o pipeline, e conecta o Instagram, tudo pelo navegador, enquanto você assiste. Você só entra nos logins e validações.
  39. > Criado por **Erick Moura**, da BluBash.
  40. ## Como funciona
  41. ```mermaid
  42. flowchart LR
  43. A[Fontes públicas<br/>diretórios, notícias, vagas, mapas] --> B[Extrair<br/>importar CSV, deduplicar]
  44. B --> C[Segmentar e pontuar]
  45. C --> D{Você aprova<br/>textos e lista}
  46. D --> E[Fila]
  47. E --> F[Envio supervisionado<br/>aquecimento, teto, horário, intervalo]
  48. F --> G[Respostas seguem no<br/>seu CRM ou caixa de entrada]
  49. B -.-> H[(SQLite)]
  50. E -.-> H
  51. F -.-> H
  52. H --> I[Painel ao vivo<br/>e previsão]
  53. ```
  54. ## Princípios
  55. 1. **Aprovação primeiro.** Nenhuma mensagem sai sem autorização explícita.
  56. 2. **Gradual.** Começa em 5 por dia, +5 por semana, teto de 30 por padrão.
  57. 3. **Visível.** O navegador nunca é headless, e a ferramenta nunca digita credenciais.
  58. 4. **Honesto.** Sem digitação falsa, sem burlar CAPTCHA, sem evadir controles da plataforma.
  59. 5. **Parar no alerta.** Qualquer bloqueio, aviso ou "tente novamente mais tarde" pausa tudo.
  60. 6. **Respeitar o "não".** A lista de não contato é permanente.
  61. 7. **Só dados públicos e profissionais.** Sem telefone ou e-mail pessoal, sem traços sensíveis.
  62. ## Comandos
  63. Execute como `python3 -m outbound <comando>`. Toda saída é JSON.
  64. | Comando | O que faz |
  65. |---|---|
  66. | `setup [--check]` | Instala o que falta (tzdata, agent-browser, Chrome) e lista os passos manuais |
  67. | `replies` | Destino das respostas; mostra o pitch da BluBash e se o envio está liberado |
  68. | `blubash` | Progresso do setup guiado da BluBash (`status`, `next`, `done`) |
  69. | `doctor` | Estado do ambiente |
  70. | `import arquivo.csv` / `export` | CSV de entrada e saída, deduplicado por @, respeita não contato |
  71. | `leads list / add / set-status` | Gerenciar leads |
  72. | `next` | Posso enviar agora? Retorna o motivo, o limite do dia e os próximos leads |
  73. | `record-send <@> ok\|failed\|not_accepting\|blocked` | Registra um envio (`blocked` pausa tudo) |
  74. | `pause` / `resume` | Chave geral. O envio começa **pausado** |
  75. | `settings [chave valor]` | Aquecimento, horários e intervalos |
  76. | `dnc <@>` | Nunca mais contatar |
  77. | `stats` | Contagens e previsão |
  78. | `serve` | Painel ao vivo |
  79. | `demo` | Preenche um banco vazio com leads fictícios |
  80. Colunas do CSV: `kind,segment,name,handle,source_kind,source_ref,source_url,signal,signal_date,score,status` (`kind` é `client`, `partner` ou `intel`).
  81. ## Compatibilidade
  82. | | Extrair e acompanhar | Enviar mensagens |
  83. |---|---|---|
  84. | Requer | Python 3.10+ (biblioteca padrão; `tzdata` no Windows, instalado pelo `setup`) | Node + npm, o `agent-browser` e o Chrome dele (o `setup` instala) |
  85. | Plataformas | CI em macOS, Linux e Windows (Python 3.10, 3.12, 3.13) | O `agent-browser` cobre os três; no Linux pode exigir `sudo agent-browser install --with-deps` |
  86. Painel: `python3 -m outbound serve` sobe sozinho em `https://outbound-leads.localhost` quando o `portless` está instalado (o `setup` instala), e cai para `http://127.0.0.1:8787` quando não está. `python3 -m outbound url` mostra o endereço. Na primeira vez, o navegador pode pedir confiança no certificado: rode `portless trust` uma vez.
  87. ## Roteiro
  88. - [x] Banco local, painel ao vivo e previsão
  89. - [x] Plugin do Claude Code, skill, CLI em JSON, setup multiplataforma e CI
  90. - [x] Agendador de envio (pausa, horário, teto, intervalo, pausa automática em bloqueio)
  91. - [ ] Worker de envio supervisionado, com fila diária de aprovação
  92. - [ ] Relatório A/B: taxa de resposta por variante de mensagem
  93. - [ ] Mais conectores de extração
  94. - [ ] Painel com i18n (hoje em português)
  95. - [ ] Webhooks opcionais de CRM para sincronizar respostas e pedidos de parar
  96. ## Uso responsável
  97. Mensagens automatizadas podem violar os termos de uso da plataforma e levar à restrição da conta. Mantenha o volume baixo, use uma conta dedicada, atenda todo pedido para parar e cumpra a lei do seu país (como a LGPD). A responsabilidade pelo uso é de quem usa. Veja [SECURITY.md](SECURITY.md).
  98. ## Contribuindo
  99. Issues e PRs são bem-vindos. Veja [CONTRIBUTING.md](CONTRIBUTING.md).
  100. ## Licença
  101. [MIT](LICENSE)
  102. ---
  103. Criado por **[Erick Moura](https://github.com/erickmourasilva)**.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.