Contact Scraper BR 🇧🇷 — Email, WhatsApp + Receita Federal (CNPJ)

Para brasileiros: Extraia emails, WhatsApp e valide CNPJ com a Receita Federal. Obtenha razão social, CNAE, porte, situação cadastral, município/UF + lead score. Exporte CSV pronto para Google Sheets, Pipedrive, HubSpot ou RD Station.

For English speakers: See English documentation below.

---

🇧🇷 Documentação em Português

O que este Actor faz?

1. Recebe uma lista de URLs de sites de empresas brasileiras
2. Extrai emails, telefones, WhatsApp, páginas de contato, formulários e redes sociais
3. Detecta o CNPJ no site (comum no rodapé de empresas BR)
4. Valida os dígitos verificadores (módulo 11) — elimina falsos positivos
5. Enriquece com dados da Receita Federal via BrasilAPI (grátis):
   • Razão social + nome fantasia
   • CNAE principal + descrição
   • Porte (ME/EPP/Médio/Grande/Demais)
   • Situação cadastral (ATIVA/BAIXADA/SUSPENSA)
   • Município/UF + capital social
6. Calcula um lead score de 0-100 combinando:
   • Contato (0-75 pontos): email(30) + telefone(25) + WhatsApp(15) + página de contato(3) + formulário(2)
   • Empresa (0-25 pontos): situação ATIVA(+10) + porte(+3-10) + capital≥100k(+5) + razão+CNAE(+5)
7. Exporta contacts.csv — 37 colunas, 1 linha por empresa, UTF-8 BOM, pronto para importar no Google Sheets, Pipedrive, HubSpot ou RD Station
8. Gera SUMMARY.md — resumo executivo com top 5 leads e métricas
9. [Opcional] Envia direto pro Google Sheets — sem baixar CSV, dados aparecem na planilha automaticamente
10. [Opcional] Webhook de notificação — receba top leads no Slack/Discord/n8n/Make quando o run terminar

Por que é diferente de outros scrapers?

	vdrmota (líder)	lukaskrivka	Contact Scraper BR
Email/telefone/redes sociais	✅	✅	✅
Detecção de WhatsApp	❌	❌	✅
Exporta CSV pronto para CRM	❌	❌	✅
CNPJ + Receita Federal	❌	❌	✅
Lead score 0-100	❌	❌	✅

Nenhum outro contact scraper no mundo faz enriquecimento com Receita Federal.

Para quem é?

• Agências de vendas B2B no Brasil
• Times de SDR e prospecção outbound
• Agências de marketing local e SEO
• Consultorias que fazem enriquecimento de CRM
• Founders de SaaS vendendo para PMEs
• Automação com Make, n8n, Zapier

Exemplo de entrada

{
  "startUrls": [
    { "url": "https://www.rdstation.com" },
    { "url": "https://portaldascorridas.com.br" }
  ],
  "maxItems": 10,
  "useBrowser": false,
  "enrichCnpj": true
}

Exemplo com Google Sheets (opcional)

{
  "startUrls": [
    { "url": "https://www.rdstation.com" }
  ],
  "enrichCnpj": true,
  "googleSheets": {
    "spreadsheetId": "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms",
    "sheetName": "Leads Julho",
    "serviceAccountJson": "{\"type\":\"service_account\",\"project_id\":\"...\",\"private_key\":\"...\",\"client_email\":\"...\"}",
    "mode": "append"
  }
}

Como configurar Google Sheets:

1. Crie uma planilha no Google Sheets
2. Copie o spreadsheetId da URL (entre /d/ e /edit)
3. No Google Cloud Console, crie uma service account com a Sheets API habilitada e baixe a chave JSON
4. Compartilhe a planilha com o client_email da service account (permissão "Editor")
5. Cole o JSON completo da chave em serviceAccountJson (como texto)

⚠️ API key não funciona para escrita — o Google só permite escrever em planilhas via OAuth/service account. Se configurar apiKey, o Actor avisa no log e pula a exportação (o run continua normalmente e o CSV continua disponível no Key-Value Store).

Exemplo com Webhook (opcional)

{
  "startUrls": [
    { "url": "https://www.rdstation.com" }
  ],
  "webhookUrl": "https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX",
  "webhookSecret": "seu-token-secreto"
}

O webhook recebe:

{
  "event": "run.completed",
  "runId": "abc123",
  "timestamp": "2026-07-22T21:10:25.622Z",
  "summary": {
    "processed": 3,
    "usefulProfiles": 3,
    "emailsFound": 2,
    "whatsAppLinksFound": 2,
    "cnpjsFound": 1
  },
  "topLeads": [
    {
      "website": "https://www.legalle.com.br",
      "company": "Legalle Concursos",
      "leadScore": 70,
      "email": "contato@legalleconcursos.com.br",
      "whatsapp": "558008180001",
      "cnpj": null
    }
  ]
}

Ferramentas que aceitam webhook: Slack, Discord, Microsoft Teams, Make, n8n, Zapier, Pipedream, ou qualquer endpoint HTTP customizado.

Exemplo de saída (dataset)

{
  "url": "https://portaldascorridas.com.br",
  "emails": ["contato@portaldascorridas.com.br"],
  "whatsAppLinks": [
    {
      "number": "5535987127477",
      "source": "wa.me",
      "url": "https://wa.me/5535987127477",
      "confidence": "HIGH"
    }
  ],
  "cnpjs": ["39467292000102"],
  "primaryCnpj": "39467292000102",
  "company": {
    "razaoSocial": "SECRETARIA DE GESTAO E GOVERNO DIGITAL",
    "porte": "DEMAIS",
    "situacaoCadastral": "ATIVA",
    "municipio": "SAO PAULO",
    "uf": "SP"
  },
  "leadScore": 68,
  "contactScore": 50
}

Saídas disponíveis

Arquivo	Formato	Descrição
contacts.csv	CSV (UTF-8 BOM)	37 colunas, 1 linha por empresa. Importe direto no Sheets/Pipedrive/HubSpot/RD Station
SUMMARY.md	Markdown	Resumo executivo com top 5 leads e métricas
Dataset	JSON	Dados estruturados completos para integrações
OUTPUT	JSON	Métricas do run (processados, sucesso, erros)

Colunas do CSV

website, company_name, email_primary, phone_primary, whatsapp_primary,
whatsapp_link, instagram_url, linkedin_url, contact_score, contact_completeness,
cnpj, cnpj_formatted, razao_social, nome_fantasia, porte, situacao_receita,
cnae_principal, municipio, uf, capital_social, lead_score, ...

Como usar (passo a passo)

1. Prepare sua lista de sites (uma URL por linha ou JSON)
2. Configure o input no Apify Console
3. Execute o Actor (HTTP mode é mais barato; browser mode para sites complexos)
4. Baixe o contacts.csv do Key-Value Store
5. Importe no Google Sheets (Arquivo → Importar → Upload)
6. Ordene por lead_score e ligue para os 5 primeiros
7. Use whatsapp_link para clicar e conversar direto

Custo

• HTTP mode: ~$0.0001 por site (sem proxy)
• Browser mode: ~$0.001 por site (para SPAs complexos)
• CNPJ enrichment: Grátis (BrasilAPI, sem auth)

Limitações

• Sites com CAPTCHA ou login podem falhar (use proxy residencial se necessário)
• CNPJ só é detectado se estiver visível no HTML (rodapé, página de contato, "sobre")
• Empresas sem CNPJ no site não terão dados da Receita Federal

Suporte

• Documentação: README no GitHub
• Issues: GitHub Issues

---

🇬🇧 English Documentation

What does this Actor do?

1. Accepts a list of Brazilian company website URLs
2. Extracts emails, phones, WhatsApp links, contact pages, forms, and social profiles
3. Detects CNPJ on the website (common in Brazilian company footers)
4. Validates check digits (módulo 11) — eliminates false positives
5. Enriches with Receita Federal data via BrasilAPI (free):
   • Legal company name + trade name
   • Main CNAE code + description
   • Company size (ME/EPP/Medium/Large/Others)
   • Registration status (ACTIVE/INACTIVE/SUSPENDED)
   • City/State + social capital
6. Computes a 0-100 lead score combining:
   • Contact (0-75 points): email(30) + phone(25) + WhatsApp(15) + contact page(3) + form(2)
   • Company (0-25 points): ACTIVE status(+10) + size(+3-10) + capital≥100k(+5) + name+CNAE(+5)
7. Exports contacts.csv — 37 columns, 1 row per company, UTF-8 BOM, ready for Google Sheets, Pipedrive, HubSpot, or RD Station
8. Generates SUMMARY.md — executive summary with top 5 leads and metrics
9. [Optional] Direct Google Sheets export — no CSV download, data appears in your spreadsheet automatically
10. [Optional] Webhook notification — receive top leads in Slack/Discord/n8n/Make when the run finishes

Why is it different from other scrapers?

	vdrmota (leader)	lukaskrivka	Contact Scraper BR
Email/phone/socials	✅	✅	✅
WhatsApp detection	❌	❌	✅
CRM-ready CSV export	❌	❌	✅
CNPJ + Receita Federal	❌	❌	✅
0-100 lead score	❌	❌	✅

No other contact scraper in the world does Receita Federal enrichment.

Best for

• Brazilian B2B sales agencies
• SDR and outbound prospecting teams
• Local marketing and SEO agencies
• CRM enrichment builders
• SaaS founders selling to SMBs
• Automation builders using Make, n8n, Zapier

Input example

{
  "startUrls": [
    { "url": "https://www.rdstation.com" },
    { "url": "https://portaldascorridas.com.br" }
  ],
  "maxItems": 10,
  "useBrowser": false,
  "enrichCnpj": true
}

Output example (dataset)

{
  "url": "https://portaldascorridas.com.br",
  "emails": ["contato@portaldascorridas.com.br"],
  "whatsAppLinks": [
    {
      "number": "5535987127477",
      "source": "wa.me",
      "url": "https://wa.me/5535987127477",
      "confidence": "HIGH"
    }
  ],
  "cnpjs": ["39467292000102"],
  "primaryCnpj": "39467292000102",
  "company": {
    "razaoSocial": "SECRETARIA DE GESTAO E GOVERNO DIGITAL",
    "porte": "DEMAIS",
    "situacaoCadastral": "ATIVA",
    "municipio": "SAO PAULO",
    "uf": "SP"
  },
  "leadScore": 68,
  "contactScore": 50
}

Available outputs

File	Format	Description
contacts.csv	CSV (UTF-8 BOM)	37 columns, 1 row per company. Import directly into Sheets/Pipedrive/HubSpot/RD Station
SUMMARY.md	Markdown	Executive summary with top 5 leads and metrics
Dataset	JSON	Full structured data for integrations
OUTPUT	JSON	Run metrics (processed, success, errors)

CSV columns

website, company_name, email_primary, phone_primary, whatsapp_primary,
whatsapp_link, instagram_url, linkedin_url, contact_score, contact_completeness,
cnpj, cnpj_formatted, razao_social, nome_fantasia, porte, situacao_receita,
cnae_principal, municipio, uf, capital_social, lead_score, ...

How to use (step by step)

1. Prepare your website list (one URL per line or JSON)
2. Configure the input in Apify Console
3. Run the Actor (HTTP mode is cheaper; browser mode for complex sites)
4. Option A: Download contacts.csv from the Key-Value Store and import into Google Sheets
5. Option B: Enable googleSheets in input — data appears in your spreadsheet automatically
6. Option C: Enable webhookUrl — receive top leads in Slack/Discord/n8n/Make
7. Sort by lead_score and call the top 5
8. Use whatsapp_link to click and chat directly

Google Sheets setup

1. Create a Google Sheets spreadsheet
2. Copy the spreadsheetId from the URL (between /d/ and /edit)
3. In Google Cloud Console, create a service account with the Sheets API enabled and download the JSON key
4. Share the spreadsheet with the service account's client_email (Editor permission)
5. Paste the full JSON key into serviceAccountJson (as text)

⚠️ API keys cannot write to Google Sheets — Google only allows writes via OAuth/service account. If you set apiKey, the Actor logs a warning and skips the export (the run continues and the CSV is still available in the Key-Value Store).

Webhook setup

The webhook receives a JSON payload with run summary and top 5 leads:

{
  "event": "run.completed",
  "runId": "abc123",
  "summary": { "processed": 3, "usefulProfiles": 3, "emailsFound": 2 },
  "topLeads": [
    { "website": "...", "company": "...", "leadScore": 70, "email": "...", "whatsapp": "..." }
  ]
}

Compatible tools: Slack, Discord, Microsoft Teams, Make, n8n, Zapier, Pipedream, or any custom HTTP endpoint.

Pricing

• HTTP mode: ~$0.0001 per website (no proxy)
• Browser mode: ~$0.001 per website (for complex SPAs)
• CNPJ enrichment: Free (BrasilAPI, no auth)

Limitations

• Sites with CAPTCHA or login may fail (use residential proxy if needed)
• CNPJ is only detected if visible in the HTML (footer, contact page, "about")
• Companies without CNPJ on the site won't have Receita Federal data

Support

• Documentation: README on GitHub
• Issues: GitHub Issues

---

Built with ❤️ for Brazilian B2B sales teams.

🇧🇷 Suite de Dados Públicos BR / BR Public Data Suite

Este Actor faz parte de uma suite brasileira de dados públicos e jurídicos. Combine-os em pipelines:

• LicitacoesBR — radar de licitações PNCP (editais e vencedores): https://apify.com/joaosbp/licitacoes-pncp-br
• CNPJ Lookup BR — consulta CNPJ em lote com dados da Receita Federal: https://apify.com/joaosbp/cnpj-enrichment-lookup-br
• CnpjDeltaBR — monitor de mudanças cadastrais de CNPJs: https://apify.com/joaosbp/cnpj-delta-monitor-br
• ComplianceBR — screening de sanções CEIS/CNEP/CEPIM: https://apify.com/joaosbp/cnpj-sanctions-screening-br
• Contact Scraper BR — emails, WhatsApp + enriquecimento CNPJ: https://apify.com/joaosbp/website-contact-finder-br
• PrazoBR — extrator de prazos e obrigações jurídicas: https://apify.com/joaosbp/legal-deadlines-extractor-br
• AutosTimeline BR — cronologia de autos e pendências: https://apify.com/joaosbp/case-timeline-builder-br
• PublicaBR — monitor de publicações processuais (DataJud/CNJ): https://apify.com/joaosbp/publicacoes-processuais-br
• EditalBR — extrator de editais de concurso em PDF: https://apify.com/joaosbp/edital-extractor-br
• Pricing Monitor BR — monitor de páginas de preço SaaS: https://apify.com/joaosbp/competitor-pricing-page-monitor

Pipeline sugerido: LicitacoesBR encontra editais → CNPJ Lookup enriquece o vencedor → ComplianceBR verifica sanções → CnpjDeltaBR monitora mudanças cadastrais.