🏛️ 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: json "/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: json 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: json "" // 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 json { "issuanceValue": "/2025", "maxPages": 400, "status": "" } ## 📊 Schema dos Dados Coletados ### Estrutura do Dataset Cada edital coletado será salvo no dataset com a seguinte estrutura: json { // === 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 json { "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 json { "issuanceValue": "PREGÃO", "maxPages": 200, "status": "113" } Resultado: Coleta apenas pregões que estão em andamento ### Caso 3: Editais Homologados de 2025 json { "issuanceValue": "/2025", "maxPages": 500, "status": "111" } Resultado: Busca apenas editais de 2025 que já foram homologados ### Caso 4: Edital Específico json { "issuanceValue": "001/2025", "maxPages": 5, "status": "" } Resultado: Busca pelo edital específico número 001/2025 (qualquer situação) ### Caso 5: Lotes com Problemas json { "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 - Empresa responsável: Criscon - 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