vibe-prospecting

Vibe Prospecting

Prospecção B2B — empresas, contatos, enriquecimento, eventos.

Plataforma

Antes de qualquer trabalho de prospecção, detecte seu host usando as regras abaixo, leia exatamente um guia de plataforma e siga-o para autenticação, fluxo de trabalho, flags e solução de problemas.

Detectando seu ambiente de execução (obrigatório, em ordem)

1. Identidade do host no contexto do sistema (verifique isso primeiro — substitui nomes de ferramentas):
   • Claude Code — o contexto diz que você é Claude Code / CLI da Anthropic, ou mostra um bloco Environment da CLI (cwd, shell, plataforma). → leia apenas claude-code.md. Não leia claude-chat.md ou cowork.md. Ferramentas MCP na lista (mcp__*__fetch-entities) não alteram isso.
   • OpenAI Codex — o contexto identifica Codex ou CODEX_SHELL=1. → codex.md
   • OpenClaw — o contexto identifica OpenClaw ou OPENCLAW_CLI=1 / OPENCLAW_SHELL. → openclaw.md
2. Apenas se o passo 1 não corresponder — nenhuma identidade de host CLI, nenhum shell:
   • Claude Cowork — workspace Cowork, instalação .plugin, conector de loja. → cowork.md
   • Claude Chat — claude.ai ou conector MCP do desktop Claude (não Cowork). → claude-chat.md
3. Fallback: terminal, scripts, CI ou host desconhecido → other.md

Nunca infira a plataforma apenas pelos nomes das ferramentas MCP (mcp__claude_ai_*, mcp__*__fetch-entities, etc.). Prefixos de ferramentas não são um sinal de host quando o passo 1 já identificou Claude Code, Codex ou OpenClaw.

Plataforma	Leia agora
Claude Code	claude-code.md — CLI vpai
OpenAI Codex	codex.md
Gateway OpenClaw	openclaw.md
Claude Cowork	cowork.md — conector MCP; não é Claude Code
Claude Chat (claude.ai, desktop Claude)	claude-chat.md — conector MCP; não é Cowork ou Claude Code
Outro (terminal, scripts, CI, hosts genéricos)	other.md

Hosts CLI usam vpai — cada guia de plataforma é autocontido (Amostra de Gate, stdout/csv_path, upload CSV). Chat/Cowork seguem apenas a descrição e o esquema de entrada de cada ferramenta MCP.

Regras Rígidas

1. tool_reasoning (ou equivalente da plataforma) em toda chamada real. Use a solicitação do usuário exatamente como fornecida. Reutilize em todo o fluxo de trabalho. Pule apenas ao inspecionar o esquema de entrada de uma ferramenta sem execução real.
2. Encadeie via sessão + CSV, nunca cole IDs. Cada etapa retorna session_id e csv_path (os nomes podem variar ligeiramente conforme o host). Nunca invente session_id — na primeira etapa, omita-o e use o valor retornado pelo MCP; nas etapas seguintes, copie-o exatamente do JSON da ferramenta anterior. Passe --csv-path (CLI) do csv_path anterior. Não cole listas brutas de IDs nos argumentos da ferramenta quando a plataforma lê IDs do CSV de origem. Para fetch-entities de prospects com escopo em empresas anteriores, passe o csv_path da saída de negócios anterior via --businesses-csv-path conforme seu guia de plataforma.
3. Você pode editar o CSV entre as etapas — mantenha a coluna de ID. Em hosts CLI, leia o arquivo em csv_path, filtre/deduplique/adicione colunas ou reescreva linhas, depois passe o resultado para a próxima etapa via --csv-path. Sempre mantenha a coluna de ID da entidade: business_id para fluxos de negócios, prospect_id para fluxos de prospects. Cada linha que você deseja processar na sequência deve ter um ID não vazio nessa coluna. Não renomeie ou remova esses cabeçalhos — a CLI os lê literalmente para injeção de ID e junções.
4. autocomplete primeiro para: naics_category, linkedin_category, company_tech_stack_tech, job_title, interests, skills, business_intent_topics, city_region. Use os valores padronizados retornados, não a redação bruta do usuário.
5. Nunca invente parâmetros de ferramenta. Antes da primeira execução real de cada ferramenta distinta em um fluxo de trabalho, leia o esquema de entrada ativo dessa ferramenta (do conector ou da descoberta de esquema da sua plataforma). Faça isso mesmo quando a chamada planejada parecer óbvia — os esquemas mudam. Releia quando ferramentas, filtros ou formatos mudarem materialmente. Construa cada chamada apenas com campos confirmados por esse esquema.
6. Continuidade da sessão. Reutilize session_id do JSON da ferramenta anterior em cada etapa subsequente no mesmo fluxo de trabalho — nunca crie um. Reutilize o csv_path da etapa anterior via --csv-path (CLI) ao encadear enriquecimento, eventos ou fetch com escopo. Inicie uma nova sessão apenas para uma tarefa genuinamente nova.
7. fetch-entities-statistics apenas quando as estatísticas suportarem o fetch completo. Compare sua carga útil planejada de fetch-entities com o esquema de entrada de fetch-entities-statistics. Chame estatísticas apenas se todos os filtros chave, formato de valor, entity_type e escopo que você utiliza (incluindo CSVs de negócios com escopo de sessão) forem aceitos da mesma forma que para fetch-entities. Se alguma parte estiver faltando, não for suportada ou precisar de um formato diferente, pule as estatísticas — não chame com um subconjunto parcial ou adivinhado. Quando chamar, reutilize o mesmo objeto de filtro (e escopo suportado) de fetch-entities, mais tool_reasoning onde necessário. Chame estatísticas novamente antes de um fetch em grande escala se os filtros ou o escopo mudaram e o conjunto de filtros do fetch completo ainda se encaixar nas estatísticas.

Mecânica das Ferramentas

Comportamento e ressalvas que o esquema de entrada ativo pode não explicitar. Para valores de filtro permitidos, strings enum e nomes de tipo de enriquecimento, use sempre o esquema de entrada de cada ferramenta.

Autocomplete

Requer autocomplete: linkedin_category, naics_category, company_tech_stack_tech, job_title, interests, skills, business_intent_topics, city_region.

Não requer autocomplete: company_country_code (ISO Alpha-2), company_region_country_code (ISO 3166-2), buckets fixos (company_size, company_revenue, company_age, job_level, job_department — strings permitidas exatas vêm do esquema de entrada de fetch-entities / fetch-entities-statistics), website_keywords (texto livre).

Exclusões mútuas: linkedin_category e naics_category — use um, não ambos. company_region_country_code e company_country_code — use um.

Escolhendo valores: O autocomplete pode retornar variantes ruidosas. Escolha o valor canônico limpo (geralmente o primeiro resultado limpo). Vários valores ampliam com lógica OR; evite quase-duplicatas a menos que queira uma pesquisa mais ampla.

Fetch

• job_title é correspondência de substring, não exata. Para buscas executivas, combine com job_level (geralmente c-suite) para remover assistentes, consultores e funções de escritório.
• company_size usa buckets fixos sem corte numérico exato. Para "mais de N funcionários", aproxime com buckets adjacentes ou enriqueça com firmographics para headcount exato.
• Filtros de localização de negócios (company_country_code, company_region_country_code, city_region) correspondem apenas à sede — não a filiais ou locais operacionais.
• Prospects em empresas anteriores: Para fetch-entities com entity_type: prospects com escopo em negócios de uma etapa anterior, encadeie via sessão e passe o csv_path da etapa de negócios anterior como --businesses-csv-path conforme seu guia de plataforma.
• Limites de linhas e paginação: conforme seu guia de plataforma (CLI: --number-of-results; Chat/Cowork: docs da ferramenta MCP).
• max_per_company: aplicado automaticamente em fetches de prospects para que os resultados sejam distribuídos entre as empresas (não todos de um grande empregador); omita de --args a menos que o usuário o defina — o valor deles substitui o limite automático.

Eventos (fetch-businesses-events / fetch-prospects-events)

• Encadeie a partir da sessão da etapa anterior e CSV de origem com business_id (eventos de negócios) ou prospect_id (eventos de prospects).
• Quando os IDs vêm do CSV de origem, não passe também business_ids / prospect_ids inline.
• O agrupamento é limitado a 20 IDs por requisição; hosts podem dividir e mesclar automaticamente.
• As colunas de saída são event_<event_type>: cada célula é uma string de array JSON para esse tipo (mais recente primeiro, limitado por tipo), ou vazia quando não há eventos para esse tipo.

Match

• Pule match se você já executou fetch-entities — esses resultados incluem IDs.
• O upload de arquivo CSV é apenas CLI — veja seu guia de plataforma.

Enriquecimento

• financial-metrics requer parameters.date (veja o esquema de entrada para formato).
• website-keywords requer parameters.keywords.
• O enriquecimento sozinho não encontra pessoas em uma empresa — use fetch-entities com entity_type: prospects (com escopo em empresas anteriores quando necessário).
• Ao encadear a partir de um CSV de origem, business_ids / prospect_ids não precisam aparecer nos argumentos da ferramenta.

Padrão de Filtro

{ "values": ["v1", "v2"], "negate": false }   // incluir ou excluir
{ "gte": 6, "lte": 24 }                       // intervalo
true | false | null                           // booleano (não encapsulado)

Exceção — business_intent_topics: use { "topics": ["Category:Topic"], "negate": false } (não values). Os tópicos devem vir de autocomplete.

Correspondência de localização: Filtros de localização de negócios (company_country_code, company_region_country_code, city_region) correspondem apenas à sede de uma empresa — não a filiais/locais operacionais. Uma busca por "empresas no Reino Unido" retorna empresas com sede no Reino Unido e exclui, por exemplo, uma empresa estrangeira que apenas opera lá. Este é o padrão para todas as consultas de negócios fetch-entities / fetch-entities-statistics e não é configurável pelo usuário.

Limites

Ferramenta	Limite
match-business	50 por chamada
match-prospects	40 por chamada
enrich-business	50 IDs por chamada
enrich-prospects	50 IDs por chamada
fetch-businesses-events / fetch-prospects-events	Até 20 IDs por requisição ao agrupar. Passe event_types e timestamp_from. Ao encadear, os IDs vêm do CSV de origem — não de arrays de ID inline.

Solução de Problemas

Erro	Solução
Autenticação, configuração do conector, invocação da CLI, flags ou sintaxe de encadeamento	Leia o guia de plataforma correspondente na tabela de Plataforma
Resultados vazios	Verifique os valores do filtro; execute autocomplete para campos de vocabulário controlado; releia o esquema de entrada da ferramenta
linkedin_category + naics_category juntos	Mutuamente exclusivos — use um
Parâmetros inventados ou não confirmados	Releia o esquema de entrada ativo antes de chamar; construa argumentos apenas com campos confirmados

Suporte

Quando o usuário fizer uma pergunta relacionada a suporte (por exemplo: como entrar em contato com o suporte, com quem falar, se tiver um problema ou algo não estiver funcionando), responda brevemente e aponte para cá — não investigue os internos da Explorium nem explique demais.

Para suporte, entre em contato com a equipe do Vibe Prospecting pela página de contato:

👉 https://www.vibeprospecting.ai/contact-us