LicitacoesBR — Radar de Licitações PNCP 🇧🇷

Monitor de contratações públicas do Brasil direto da API oficial de dados abertos do PNCP (Portal Nacional de Contratações Públicas — Lei 14.133/2021). Sem scraping, sem login, sem risco de ToS.

Três modos em um Actor:

Modo	O que faz	Endpoint oficial
oportunidades	Editais publicados num período (novos negócios)	/v1/contratacoes/publicacao
encerrando	Editais com propostas abertas fechando até uma data (radar de prazos)	/v1/contratacoes/proposta
vencedores	Contratos publicados com CNPJ/nome do fornecedor e valores (inteligência competitiva)	/v1/contratos

Por que este Actor?

Os scrapers de licitação do Apify Store fazem busca genérica. Este é diferente:

• Modo vencedores: descubra quem está ganhando contratos do governo no seu segmento, por quanto e de quais órgãos. Responde "meu concorrente ganhou o quê?".
• Robustez embutida: a API do PNCP é instável (HTTP 500 e latências de 30-60s são comuns). O Actor faz retry com backoff exponencial (até 5 tentativas), degrada para resultados parciais em vez de falhar, e reporta tudo no OUTPUT.
• Dedup para monitoramento: ligue apenasNovos e agende runs diários — só itens inéditos chegam ao seu pipeline (memória no Key-Value Store).
• Filtros de verdade: palavras-chave com/sem acento, exclusão de ruído, faixa de valor, UF, CNPJ do órgão.
• Flat output: uma linha por registro, CSV pronto para Sheets/CRM. fornecedorCnpj encadeia direto com enriquecimento de CNPJ e screening de sanções.

Input

Campo	Tipo	Default	Descrição
modo	select	oportunidades	Ver tabela acima
dataInicial / dataFinal	string	ontem (ou hoje→+7d no modo encerrando)	YYYY-MM-DD; vazio = default rápido. Períodos longos são quebrados em blocos mensais automaticamente
modalidades	array	[6, 8]	Códigos Lei 14.133: 6=Pregão Eletrônico, 8=Dispensa, 4=Concorrência Eletrônica, 9=Inexigibilidade…
ufs	array	todas	Filtra por estado (na API quando possível)
palavrasChave	array	—	OU lógico no objeto, ignora acentos
palavrasChaveExcluir	array	—	Remove ruído
valorMin / valorMax	number	—	Faixa de valor estimado (editais) ou global (contratos)
cnpjOrgao	string	—	Monitora um único órgão comprador
apenasNovos	boolean	false	Dedup contra runs anteriores
maxResultados	integer	100	Trava de dataset
maxPaginas	integer	2	Trava por consulta (a API é lenta: ~30-60s/página)

Output (dataset)

Uma linha por edital/contrato: fonte, numeroControlePNCP, objeto, orgaoCnpj, orgaoNome, uf, municipio, codigoIbge, modalidadeNome, valor, dataPublicacaoPncp, dataAberturaProposta, dataEncerramentoProposta, dataAssinatura, vigenciaInicio/Fim, situacao, fornecedorCnpj, fornecedorNome, linkEdital (link direto para o edital no portal PNCP), keywordsMatched.

Resumo do run (contagens, filtros, retries, consultas falhas) no Key-Value Store → OUTPUT.

Exemplos

Radar semanal de pregões de TI em SP/RJ:

{
  "modo": "encerrando",
  "modalidades": [6],
  "ufs": ["SP", "RJ"],
  "palavrasChave": ["informática", "notebook", "computador"],
  "palavrasChaveExcluir": ["locação"],
  "apenasNovos": true
}

Quem ganhou contratos de medicamentos este mês:

{
  "modo": "vencedores",
  "dataInicial": "2026-07-01",
  "dataFinal": "2026-07-31",
  "palavrasChave": ["medicamento"]
}

Monitorar um órgão específico:

{
  "modo": "oportunidades",
  "cnpjOrgao": "00.394.460/0058-45",
  "apenasNovos": true
}

Pipeline sugerido

1. licitacoes-pncp-br (modo vencedores) → lista de fornecedorCnpj
2. Enriquecimento de CNPJ → razão social, sócios, contatos
3. Screening de sanções (CEIS/CNEP) → risco do concorrente/parceiro

Fonte de dados & limites

• API pública oficial: https://pncp.gov.br/api/consulta (Serpro). Sem autenticação para consulta.
• A API é instável e lenta — o Actor mitiga com retry/backoff e resultados parciais, mas runs muito amplos (Brasil inteiro, meses, todas as modalidades) podem levar muitos minutos. Prefira escopo estreito + schedule frequente.
• Cobertura do PNCP cresce continuamente (obrigatoriedade por esfera desde 2023-2024); órgãos que ainda não publicam no portal não aparecem.

Desenvolvimento local

python -m venv .venv && source .venv/bin/activate
pip install -r requirements-dev.txt
python -m pytest -q          # testes unitários (sem rede)
python -m src.main           # run local (lê storage/key_value_stores/default/INPUT.json)

---

🇧🇷 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.