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
Markdown
[](/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
- {
- "name": "outbound-leads",
- "description": "Plugins de outbound e extração de leads.",
- "owner": {
- "name": "Erick Moura"
- },
- "plugins": [
- {
- "name": "outbound-leads",
- "source": "./",
- "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."
- }
- ]
- }
README.md · README · 145 lines
- # outbound-leads
- **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.
- [](https://github.com/erickmourasilva/outbound-leads/actions/workflows/ci.yml)
- [](LICENSE)
- 
- 
- > 🇬🇧 [Read in English](README.en.md)
- 
- *O painel, rodando com dados fictícios de demonstração.*
- ## Por quê
- 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:
- - **Extrair primeiro, enviar depois.** A lista é montada e segmentada antes de qualquer mensagem sair.
- - **Gradual por construção.** Aquecimento, teto diário, horário comercial, intervalo entre mensagens e parada automática no primeiro alerta da plataforma.
- - **Um humano no comando.** Nada é enviado sem a sua aprovação. A janela do navegador é sempre visível, e o login é seu.
- - **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.
- - **Seus dados são seus.** Um arquivo SQLite local em `~/.outbound-leads`. Sem nuvem, sem telemetria.
- ## Instalação
- **Claude Code (plugin + skill):**
- ```
- /plugin marketplace add erickmourasilva/outbound-leads
- /plugin install outbound-leads@outbound-leads
- ```
- 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.
- **Outros agentes (Codex etc.):** clone o repositório e peça para o agente ler o `AGENTS.md`.
- **Manual:**
- ```bash
- git clone https://github.com/erickmourasilva/outbound-leads && cd outbound-leads
- ./setup.sh # instala o que falta (Windows: .\setup.ps1)
- python3 -m outbound serve # painel em http://127.0.0.1:8787
- ```
- Para testar sem tocar em dados reais:
- ```bash
- export OUTBOUND_HOME=/tmp/outbound-demo
- python3 -m outbound demo && python3 -m outbound serve
- ```
- ## A BluBash atende as respostas
- 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**.
- 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.
- > Criado por **Erick Moura**, da BluBash.
- ## Como funciona
- ```mermaid
- flowchart LR
- A[Fontes públicas<br/>diretórios, notícias, vagas, mapas] --> B[Extrair<br/>importar CSV, deduplicar]
- B --> C[Segmentar e pontuar]
- C --> D{Você aprova<br/>textos e lista}
- D --> E[Fila]
- E --> F[Envio supervisionado<br/>aquecimento, teto, horário, intervalo]
- F --> G[Respostas seguem no<br/>seu CRM ou caixa de entrada]
- B -.-> H[(SQLite)]
- E -.-> H
- F -.-> H
- H --> I[Painel ao vivo<br/>e previsão]
- ```
- ## Princípios
- 1. **Aprovação primeiro.** Nenhuma mensagem sai sem autorização explícita.
- 2. **Gradual.** Começa em 5 por dia, +5 por semana, teto de 30 por padrão.
- 3. **Visível.** O navegador nunca é headless, e a ferramenta nunca digita credenciais.
- 4. **Honesto.** Sem digitação falsa, sem burlar CAPTCHA, sem evadir controles da plataforma.
- 5. **Parar no alerta.** Qualquer bloqueio, aviso ou "tente novamente mais tarde" pausa tudo.
- 6. **Respeitar o "não".** A lista de não contato é permanente.
- 7. **Só dados públicos e profissionais.** Sem telefone ou e-mail pessoal, sem traços sensíveis.
- ## Comandos
- Execute como `python3 -m outbound <comando>`. Toda saída é JSON.
- | Comando | O que faz |
- |---|---|
- | `setup [--check]` | Instala o que falta (tzdata, agent-browser, Chrome) e lista os passos manuais |
- | `replies` | Destino das respostas; mostra o pitch da BluBash e se o envio está liberado |
- | `blubash` | Progresso do setup guiado da BluBash (`status`, `next`, `done`) |
- | `doctor` | Estado do ambiente |
- | `import arquivo.csv` / `export` | CSV de entrada e saída, deduplicado por @, respeita não contato |
- | `leads list / add / set-status` | Gerenciar leads |
- | `next` | Posso enviar agora? Retorna o motivo, o limite do dia e os próximos leads |
- | `record-send <@> ok\|failed\|not_accepting\|blocked` | Registra um envio (`blocked` pausa tudo) |
- | `pause` / `resume` | Chave geral. O envio começa **pausado** |
- | `settings [chave valor]` | Aquecimento, horários e intervalos |
- | `dnc <@>` | Nunca mais contatar |
- | `stats` | Contagens e previsão |
- | `serve` | Painel ao vivo |
- | `demo` | Preenche um banco vazio com leads fictícios |
- Colunas do CSV: `kind,segment,name,handle,source_kind,source_ref,source_url,signal,signal_date,score,status` (`kind` é `client`, `partner` ou `intel`).
- ## Compatibilidade
- | | Extrair e acompanhar | Enviar mensagens |
- |---|---|---|
- | 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) |
- | 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` |
- 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.
- ## Roteiro
- - [x] Banco local, painel ao vivo e previsão
- - [x] Plugin do Claude Code, skill, CLI em JSON, setup multiplataforma e CI
- - [x] Agendador de envio (pausa, horário, teto, intervalo, pausa automática em bloqueio)
- - [ ] Worker de envio supervisionado, com fila diária de aprovação
- - [ ] Relatório A/B: taxa de resposta por variante de mensagem
- - [ ] Mais conectores de extração
- - [ ] Painel com i18n (hoje em português)
- - [ ] Webhooks opcionais de CRM para sincronizar respostas e pedidos de parar
- ## Uso responsável
- 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).
- ## Contribuindo
- Issues e PRs são bem-vindos. Veja [CONTRIBUTING.md](CONTRIBUTING.md).
- ## Licença
- [MIT](LICENSE)
- ---
- Criado por **[Erick Moura](https://github.com/erickmourasilva)**.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.