FarejaLeads

Lista empresas ativas (10 por padrão, até 50 por página; paginação por cursor) de uma atividade econômica numa cidade brasileira, abertas nos últimos 12 meses, a partir dos dados abertos do CNPJ da Receita Federal. Devolve só dados da empresa (nome, CNPJ, atividade, bairro, porte, data de abertura) — nunca sócios, CPF, telefone ou e-mail. Use quando a pessoa quer encontrar empresas para prospectar, por exemplo "agências de publicidade em Recife".

buscar_empresas

Quantas empresas ativas (matrizes, sem MEI) existem de um setor no Brasil, num estado ou numa cidade, pela base de CNPJ da Receita Federal — com a data da consulta, a fonte e o link para citar. Aceita qualquer ramo em português ('limpeza e conservação', 'padarias') ou código CNAE. Para os setores com página pronta (software, saas, clinicas, agencias-de-marketing, contabilidade) devolve também a distribuição por estado ou cidade.

contar_empresas

Telefone e e-mail que a empresa declarou no CNPJ (arquivo de Estabelecimentos dos dados abertos da Receita Federal). Só com conta conectada. A resposta traz sempre a fonte, a competência da base (mês dos dados; null se a fonte não informa) e o aviso de que o e-mail cadastral frequentemente é o do contador (provavel_contador sinaliza quando o endereço tem cara de escritório contábil). Mostre esses três ao usuário junto com o contato.

empresa_contato

Diz se uma empresa (CNPJ) vende para o governo e quanto, pelos contratos publicados no Portal Nacional de Contratações Públicas (PNCP), de todas as esferas: quantidade, valor total, ticket médio, órgãos compradores, evolução por ano e os últimos contratos (objeto, órgão, valor, vigência). Contrato de filial conta para a empresa. Informa sempre o período coberto pelo índice. Use quando perguntarem se uma empresa já vendeu para o governo, ganhou licitação ou tem contrato público.

consultar_fornecedor_governo

Quanto o governo contratou numa categoria (e num estado), nos últimos 30 dias, pelo Portal Nacional de Contratações Públicas: número de contratos, valor, maiores fornecedores (só empresas) e compradores, com link para citar. Categorias: combustiveis, software-e-ti, publicidade-e-marketing, obras-e-engenharia, limpeza-e-conservacao, coleta-de-residuos, vigilancia-e-seguranca, saude, alimentacao, transporte-e-veiculos, eventos, educacao-e-treinamento, consultoria-e-assessoria, energia-e-iluminacao, material-de-expediente, mobiliario-e-equipamentos.

contratos_publicos

Contratos públicos (PNCP) cuja vigência termina nos próximos N dias — a data em que o órgão precisa relicitar ou prorrogar. Gatilho com data marcada: o fornecedor atual defende o contrato, o concorrente se prepara para disputar. Filtros: UF do órgão, e setor ou CNAE do fornecedor atual (com UF). Devolve fornecedor (só empresas), órgão, objeto, valor, fim da vigência e dias restantes, ordenados pelo vencimento. Só contratos publicados no PNCP no período do índice: é piso, não o universo.

contratos_vencendo

Transforma o contato cadastral da Receita (o mesmo do empresa_contato) em leads da conta, para o fluxo email_rascunhar → aprovação → email_enviar/email_agendar. O e-mail passa pela verificação (cobra créditos quando não está em cache); só e-mail verificado pode virar rascunho — a resposta diz, por lead, se pode e por quê. CNPJ que já é lead não duplica. Sempre mostre a competência da base e o aviso de que o e-mail costuma ser do contador (provavel_contador).

lead_de_cnpj

Lista empresas de uma atividade (CNAE) num estado ou cidade que têm contratos publicados no PNCP no período do índice (10 por página por padrão, até 50; paginação por cursor), ordenadas pelo valor contratado, com porte e faturamento estimado de cada uma. Filtros opcionais: porte (mei, micro, pequena, media_ou_grande) e faixa de valor contratado. Só empresas (MEI e empresário individual ficam de fora); nunca sócios ou contatos. O período filtra pela data de PUBLICAÇÃO no PNCP; cada empresa traz separadas a data de assinatura mais recente e a de publicação, e quanto foi assinado nos últimos 12 meses — um contrato assinado há anos pode ter sido publicado agora (veja o campo aviso). Use para perguntas como 'quais empresas de limpeza em Pernambuco vendem para órgãos públicos?'.

buscar_fornecedores

Antes de pedir leads B2B no Brasil, diz quanto o recorte rende: o total de empresas ativas (matrizes, sem MEI), a taxa de contato medida agora na base da Receita (quantas têm e-mail cadastral), os leads com contato esperados, 3 empresas de amostra (sem contato) e o próximo passo. Aceita o ICP em português ou inglês ('cleaning companies in Recife', 'clínicas odontológicas em SP') ou filtros (atividade/CNAE, UF, cidade, porte). Use quando alguém pede 'ache clientes B2B no Brasil', 'how many companies…', ou antes de cacar_leads. NÃO devolve e-mail nem telefone e NÃO cria leads.

estimar_cacada

Return the full text of a FarejaLeads page by the id returned from search.

fetch