🏛️ RS Bids Crawler

📋 Descrição

O RS Bids Crawler é um Actor do Apify especializado na coleta automatizada de editais do Portal de Compras do Estado do Rio Grande do Sul. Este crawler extrai dados estruturados de editais públicos com paginação automática.

🎯 Funcionalidades Principais

• ✅ Busca Personalizada: Permite filtrar editais por número, ano ou palavras-chave
• ✅ Paginação Automática: Coleta dados de todas as páginas disponíveis
• ✅ Dados Estruturados: Salva informações em formato JSON padronizado
• ✅ Configuração Flexível: Parâmetros ajustáveis via interface do Apify

🚀 Como Usar

1. Configuração dos Inputs

O crawler aceita três parâmetros de entrada:

📝 issuanceValue (Valor do Número do Edital)

• Tipo: String
• Obrigatório: Sim
• Descrição: Valor para pesquisar no campo "Número do Edital"

Exemplos de uso:

"/2025"           // Todos os editais de 2025
"/2024"           // Todos os editais de 2024  
"001/2025"        // Edital específico número 001/2025
"PREGÃO"          // Editais que contêm "PREGÃO"
"CONCORRÊNCIA"    // Editais que contêm "CONCORRÊNCIA"
"LICITAÇÃO"       // Editais que contêm "LICITAÇÃO"

🔢 maxPages (Máximo de Páginas)

• Tipo: Integer
• Obrigatório: Sim
• Faixa: 1 - 10.000
• Descrição: Número máximo de páginas para processar

Orientações de uso:

1        // Teste rápido (~20 editais)
50       // Amostra pequena (~1.000 editais)
400      // Padrão recomendado (~8.000 editais)
1000     // Coleta completa (~20.000 editais)

🏷️ status (Filtro de Situação)

• Tipo: String
• Obrigatório: Não
• Padrão: "" (todas as situações)
• Descrição: Filtro opcional para situação específica dos editais

Opções disponíveis:

""      // Todas as situações (padrão)
"105"   // Editais agendados
"113"   // Editais em andamento
"111"   // Editais homologados
"103"   // Editais cancelados
"110"   // Editais suspensos
"4"     // Editais com lotes agendados
"2"     // Editais com lotes encerrados
"1"     // Editais com lotes em andamento
"6"     // Editais com lotes suspensos
"7"     // Editais com lotes desertos
"3"     // Editais com lotes cancelados
"5"     // Editais com lotes adjudicados
"8"     // Editais com lotes não adjudicados
"99"    // Editais com lotes homologados

2. Exemplo de Configuração

{
  "issuanceValue": "/2025",
  "maxPages": 400,
  "status": ""
}

📊 Schema dos Dados Coletados

Estrutura do Dataset

Cada edital coletado será salvo no dataset com a seguinte estrutura:

{
  // === DADOS ORIGINAIS DO EDITAL ===
  "id": 337192,
  "biddingType": "COMPETITION_14133",
  "issuanceNumber": "0058/2025",
  "processNumber": "20/0400-0000708-9",
  "tradeOffice": "CELIC - SUBSECRETARIA DA ADMINISTRAÇÃO CENTRAL DE LICITAÇÕES",
  "description": "CONCESSÃO PATROCINADA PARA EXPLORAÇÃO, MANUTENÇÃO E EXPANSÃO DOS AEROPORTOS DE PASSO FUNDO E DE SANTO ÂNGELO",
  "startDate": "2025-08-22T12:01:00.000Z",
  "resultCount": 3367,
  "legalNormType": "LAW_14133_2021",
  "biddingTypeName": "Concorrência Eletrônica (14.133/21)",
  "publishDate": "2025-07-24T03:00:00.000Z",
  "simplifiedIssuanceNumber": "0058_2025",
  
  // === METADADOS ADICIONADOS PELO CRAWLER ===
  "_crawledAt": "2025-08-31T23:45:53.640Z",
  "_sourceUrl": "https://www.compras.rs.gov.br/editais/pesquisar",
  "_searchValue": "/2025",
  "_statusFilter": "",
  "_pageNumber": 1
}

📋 Descrição dos Campos

Dados Originais

Campo	Tipo	Descrição
id	Number	Identificador único do edital no sistema
biddingType	String	Código do tipo de licitação (ex: "COMPETITION_14133")
issuanceNumber	String	Número oficial do edital (ex: "0058/2025")
processNumber	String	Número do processo administrativo
tradeOffice	String	Órgão/entidade responsável pela licitação
description	String	Descrição detalhada do objeto da licitação
startDate	ISO Date	Data de abertura em formato ISO 8601
resultCount	Number	Contador total de resultados da busca
legalNormType	String	Tipo de norma legal aplicável (ex: "LAW_14133_2021")
biddingTypeName	String	Nome descritivo do tipo de licitação
publishDate	ISO Date	Data de publicação em formato ISO 8601
simplifiedIssuanceNumber	String	Número do edital simplificado (underscore no lugar da barra)

Metadados do Crawler

Campo	Tipo	Descrição
_crawledAt	ISO Date	Timestamp de quando o edital foi coletado
_sourceUrl	String	URL da página onde foi feita a pesquisa
_searchValue	String	Valor usado no campo de busca
_statusFilter	String	Filtro de status aplicado na pesquisa
_pageNumber	Number	Número da página onde o edital foi encontrado

📈 Monitoramento e Logs

Durante a execução, o crawler fornece logs detalhados:

✅ Input configurado: { issuanceValue: '/2025', maxPages: 400, status: '113' }
🔍 Campo issuanceNumber encontrado
📝 Campo issuanceNumber preenchido com: /2025
🏷️ Status selecionado: 113
🎯 Botão de pesquisar clicado
📡 === INTERCEPTAÇÃO DA API - PÁGINA 1 ===
💾 === SALVANDO 20 ITENS DA PÁGINA 1 ===
✅ 20 itens da página 1 salvos no dataset!
📄 Processando página 2...
🏁 Fim da paginação alcançado na página 15
🎉 Crawling completo! Total de páginas processadas: 15

📝 Exemplos de Uso

Caso 1: Monitoramento de Editais de 2025

{
  "issuanceValue": "/2025",
  "maxPages": 1000,
  "status": ""
}

Resultado: Coleta todos os editais publicados em 2025 (todas as situações)

Caso 2: Busca por Pregões em Andamento

{
  "issuanceValue": "PREGÃO",
  "maxPages": 200,
  "status": "113"
}

Resultado: Coleta apenas pregões que estão em andamento

Caso 3: Editais Homologados de 2025

{
  "issuanceValue": "/2025",
  "maxPages": 500,
  "status": "111"
}

Resultado: Busca apenas editais de 2025 que já foram homologados

Caso 4: Edital Específico

{
  "issuanceValue": "001/2025",
  "maxPages": 5,
  "status": ""
}

Resultado: Busca pelo edital específico número 001/2025 (qualquer situação)

Caso 5: Lotes com Problemas

{
  "issuanceValue": "/2025",
  "maxPages": 100,
  "status": "7"
}

Resultado: Busca editais de 2025 com lotes desertos

📞 Suporte

Para questões técnicas ou sugestões:

• Consulte a documentação do Apify
• Verifique os exemplos do Crawlee
• Entre em contato através da plataforma Apify
• Abra um issue: https://apify.com/brasil-scrapers/busca-de-editais-compras-eletronicas-rs/issues/open

🎯 Desenvolvido para facilitar o acesso a informações públicas de licitações do Estado do Rio Grande do Sul