PNCP Licitações Brasil 🇧🇷 — radar de licitações abertas com itens e alertas de novidades

Desenvolvido e mantido por Guilherme Kodama · GitHub: github.com/guilhermeKodama

📬 Não quer rodar o actor? O Radar Vending Público usa este mesmo dado do PNCP e manda todo dia, no seu e-mail, só as licitações de máquinas de café, snack e água (órgão, valor, prazo, link). Ver amostra e planos · Assinar o plano Fundador — R$ 29/mês

Coleta licitações do Portal Nacional de Contratações Públicas (PNCP), a base oficial e obrigatória de compras públicas do Brasil (Lei 14.133/2021). Pregões, dispensas, concorrências, credenciamentos — de prefeituras, estados e União — em JSON, CSV ou Excel.

Direto da API oficial de dados abertos do PNCP. Sem login, sem chave, sem raspar HTML.

Pra quem é

• Empresas que vendem para o governo: receba todo dia as licitações abertas do seu ramo, na sua região, com tempo de preparar proposta.
• Consultorias e assessorias de licitação: monitore vários clientes (um stateKey por cliente).
• Jornalismo, pesquisa e controle social: baixe tudo que foi publicado num período.

O que tem de diferente

• Itens da licitação (opcional): descrição, quantidade, unidade e valor unitário estimado de cada item — dá pra precificar sem abrir o edital.
• Só novidades: com onlyNew, o actor lembra o que já entregou e retorna apenas licitações novas. Agende diariamente + webhook/e-mail = alerta automático.
• Prazo mínimo: minDaysToDeadline descarta licitações que fecham antes de você conseguir montar a proposta. Campo diasParaEncerrar em cada resultado.
• Palavra inteira, sem acento: cafe acha "CAFÉ", mas não "Cafelândia".
• Link direto para a página do edital no PNCP.
• Sem dados pessoais: só órgãos públicos (CNPJ). CPF, e-mail e telefone em texto livre são mascarados.

Entrada (principais campos)

Campo	Descrição
mode	abertas (propostas abertas até dateTo) ou publicadas (publicadas entre dateFrom e dateTo)
modalidades	Códigos PNCP. Padrão [6, 8] = pregão eletrônico + dispensa. 4 = concorrência eletrônica, 9 = inexigibilidade, 12 = credenciamento
ufs	["SP","MG"]; vazio = Brasil inteiro
codigoMunicipioIbge, cnpjOrgao	Filtro por município ou órgão
keywords, excludeKeywords	Qualquer uma das palavras / descartar
minValue, maxValue	Faixa de valor estimado (R$)
esferas	Federal, Estadual, Municipal, Distrital
minDaysToDeadline	Prazo mínimo até o fim das propostas
includeItems	Traz os itens (1 requisição extra por licitação)
onlyNew, stateKey	Monitoramento sem repetição
maxItems	Limite de resultados (padrão 500)

Exemplo — TI em SP, só novidades, com 5 dias de prazo:

{"mode":"abertas","ufs":["SP"],"modalidades":[6,4],"keywords":["software","licenca","sistema de gestao"],
 "minDaysToDeadline":5,"includeItems":true,"onlyNew":true,"stateKey":"ti-sp"}

Saída (um registro por licitação)

numeroControlePNCP, urlPncp, objeto, informacaoComplementar, modalidade, modoDisputa, situacao, srp, valorTotalEstimado, valorTotalHomologado, dataPublicacaoPncp, dataAberturaProposta, dataEncerramentoProposta, diasParaEncerrar, orgaoCnpj, orgaoRazaoSocial, orgaoEsfera, orgaoPoder, unidadeNome, uf, municipio, codigoIbge, amparoLegal, linkSistemaOrigem, plataforma, itens[] (se includeItems). Resumo da execução na chave RESUMO do key-value store.

Fonte e uso responsável

Dados públicos do PNCP (https://pncp.gov.br), via https://pncp.gov.br/api/consulta. O actor faz pausa entre requisições (padrão 1 s), reduz a velocidade sozinho ao receber HTTP 429 e tenta de novo em erros 5xx. Não é um produto oficial do Governo Federal.

---

English (short)

Brazil public tenders (PNCP) scraper. Pulls open and published Brazilian government tenders from the official PNCP open-data API — no login, no key. Filters: state, city (IBGE), agency CNPJ, procurement mode, keywords (accent-insensitive, whole word), value range, sphere, minimum days to deadline. Optional line items with unit prices, and onlyNew mode for daily alerting without duplicates. Output: JSON/CSV/Excel, one row per tender with a direct link to the PNCP notice. Public-agency data only; CPF/e-mail/phone patterns in free text are masked.

---

Rodar localmente

Requisitos: Python 3.11+.

cd primeiro-actor
python3 -m venv .venv && .venv/bin/pip install -r requirements.txt
mkdir -p storage/key_value_stores/default
echo '{"mode":"abertas","ufs":["SP"],"maxItems":50}' > storage/key_value_stores/default/INPUT.json
.venv/bin/python -m src
# resultados: storage/datasets/default/*.json   resumo: storage/key_value_stores/default/RESUMO

Com Apify CLI (opcional, não exige conta para rodar local): npm i -g apify-cli && apify run --input='{"mode":"abertas","ufs":["SP"]}'. Publicar: apify login → apify push (precisa de conta).