De 1h pra 1min: como meu agente acha CNPJs/leads (sem planilha manual) · VictorTavernari

Por que fiz isso

Eu queria que um agente de IA (tipo Claude/Qwen) me ajudasse a encontrar empresas com um perfil específico (ex.: “padarias no Tatuapé – SP”) sem eu ter que entrar em vários sites, filtrar manualmente e copiar/colar para planilhas. A ideia foi: o agente faz a busca, eu decido o que manter, e quando fizer sentido ele exporta tudo para um CSV.

O que tem aqui

Um servidor MCP chamado “Buscador de CNPJ” que conecta seu agente a uma API de empresas.
Dois jeitos de buscar:
- Por termo (linguagem natural): “padarias em SP Tatuapé”.
- Por filtros (mais preciso): UF, município, CNAE, situação cadastral, faixa de capital etc.
Dá para pedir os dados completos de um CNPJ e exportar resultados para CSV.

Como eu uso no dia a dia

Ideia aberta (topo de funil)
- Prompt: “Procure padarias no bairro Tatuapé (SP), em páginas de 100, e me mostre um resumo.”
- O agente usa term_search (texto livre), bom quando não sei exatamente os filtros que quero.
- Eu olho os resultados, tiro o que não faz sentido e peço a próxima página.
Quando quero mais controle (filtros)
- Prompt: “Busque empresas ativas (situação 2), em São Paulo (capital), com CNAE de padaria, limite 100.”
- O agente usa cnpj_advanced_search e eu consigo ser mais específico.
- Ajuda a reduzir ruído e ganhar tempo.
Quando preciso conferir detalhes
- Prompt: “Traga os dados completos desse CNPJ.”
- O agente usa cnpj_detailed_lookup e eu confiro endereço, CNAE e outras infos.
Para mandar pra planilha/BI
- Prompt: “Exporte as páginas 1 a 3 dessa busca para um CSV.”
- O agente usa search_csv e eu abro direto no Excel/Sheets.

O que mais funcionou para mim

Começar com term_search (mais solto, tipo “converse comigo”) e depois ir afunilando com filtros do cnpj_advanced_search.
Usar UF/município/bairro quando sei a região — a busca fica mais rápida e os resultados, melhores.
Pedir CSV só quando já refinei os resultados (evita planilhas intermináveis).

Como ligar no seu agente (sem drama)

Instale pelo PyPI:
- uvx buscador-de-cnpj --no-cache
Configure a API key (vai em header x-api-key).
Registre o servidor MCP no seu agente. Exemplo (Claude Desktop JSON):

{
  "mcpServers": {
    "cnpj-search": {
      "command": "uvx",
      "args": ["buscador-de-cnpj"],
      "env": {
        "CNPJ_API_KEY": "sua_api_key_aqui"
      }
    }
  }
}

Pronto. Seu agente passa a ter as tools:
- term_search: linguagem natural
- cnpj_advanced_search: filtros
- cnpj_detailed_lookup: detalhes por CNPJ
- search_csv: exportação

Exemplo de prompt simples (para leads)

“Encontre padarias no Tatuapé (SP), me traga 100 por página e depois exporte a primeira página para CSV.”

Perguntas que já me fizeram (respostas rápidas)

“Preciso saber o CNAE de cabeça?”
Não. Comece com term_search. Se ficar muito aberto, aí sim refine com cnpj_advanced_search.
“É seguro?”
A chave vai por header (x-api-key). Não é colocada em query string.
“Funciona com Claude/Qwen?”
Sim. É MCP, então os agentes “enxergam” as ferramentas de forma nativa.

Quando isso é útil

Prospecção: levantar uma base inicial de empresas por bairro/UF/segmento.
Validação: conferir dados completos de CNPJs antes de contatar.
Operação: gerar CSVs prontos para o time (e evitar o copia/cola infinito).

Links rápidos

PyPI: buscador-de-cnpj (versão recomendada: 0.2.7)
Dica: use uvx buscador-de-cnpj --no-cache para não pegar versão antiga
Guia no repositório: QWEN.md (tem dicas de deploy e validação)
https://github.com/buscadordecnpj/buscador-de-cnpj