--- type: "firecrawl-provider" description: "PNCP (pncp.gov.br), Brazil's national public procurement portal (Lei 14.133/2021) for federal, state and municipal buyers: keyword search over tender notices (editais), price-registration minutes (atas) and contracts with state, government level, modality and status filters, and one procurement with its buyer, values, deadlines, line items and published files. From PNCP's public search and consultation APIs; no key." use_when: "PNCP (pncp.gov.br), Brazil's national public procurement portal (Lei 14.133/2021) for federal, state and municipal buyers: keyword search over tender notices (editais), price-registration minutes (atas) and contracts with state, government level, modality and status filters, and one procurement with its buyer, values, deadlines, line items and published files. From PNCP's public search and consultation APIs; no key." categories: "Public records" capabilities: 2 credits_per_call: 5 --- # PNCP (Portal Nacional de Contratações Públicas) on Firecrawl Alexandria PNCP (pncp.gov.br), Brazil's national public procurement portal (Lei 14.133/2021) for federal, state and municipal buyers: keyword search over tender notices (editais), price-registration minutes (atas) and contracts with state, government level, modality and status filters, and one procurement with its buyer, values, deadlines, line items and published files. From PNCP's public search and consultation APIs; no key. - Categories: Public records - Category index: [Public records category](https://alexandria.firecrawl.dev/agents/categories/public-records) - Provider key: `pncp-gov-br` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://www.firecrawl.dev/app/alexandria/pncp-gov-br) - [OpenAPI spec](https://alexandria.firecrawl.dev/agents/providers/pncp-gov-br/openapi.json) ## Capabilities - [Procurement detail](https://alexandria.firecrawl.dev/agents/providers/pncp-gov-br/procurement/procurement_detail): One PNCP procurement (compra) identified by its control number (e.g. 46395000000139-1-000001/2024), by a pasted notice page URL (https://pncp.gov.br/app/editais/{cnpj}/{year}/{sequence}) or by buyer CNPJ + year + sequence: object, buyer and unit, modality, legal basis, status, estimated and awarded values, proposal window, origin-system link, the line items (description, quantity, unit, estimated unit and total value, status; up to 500) and the published files (notice and annex download URLs). An unknown procurement is not_found. If the items or files endpoint fails, the procurement is still returned with null items/files and a warning. - [Procurement search](https://alexandria.firecrawl.dev/agents/providers/pncp-gov-br/procurement/procurement_search): Search public procurement on PNCP (pncp.gov.br), Brazil's national procurement portal covering federal, state and municipal buyers: tender notices (edital), price-registration minutes (ata) or contracts (contrato) matching a keyword, optionally filtered by state (UF), government level, modality and proposal status. Returns one page of summary records with the PNCP control number needed by procurement_detail. ## 1. Choose this provider when PNCP (pncp.gov.br), Brazil's national public procurement portal (Lei 14.133/2021) for federal, state and municipal buyers: keyword search over tender notices (editais), price-registration minutes (atas) and contracts with state, government level, modality and status filters, and one procurement with its buyer, values, deadlines, line items and published files. From PNCP's public search and consultation APIs; no key. ## 2. Minimal request Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls. ```json { "provider": "pncp-gov-br", "capability": "procurement/procurement_detail", "options": { "pncp_control_number": "46395000000139-1-000001/2024" } } ``` ## 3. Add provider options Use only the options needed for the task: - `cnpj` (string): Buyer CNPJ (14 digits, punctuation optional). Use together with year and sequence. Example: `` - `include_files` (boolean): Fetch the published document list (notice, annexes). Example: `false` - `include_items` (boolean): Fetch up to 500 line items. Example: `false` - `pncp_control_number` (string): Kind-1 compra number, e.g. 93235968000188-1-000183/2026 (procurement_control_number from procurement_search). Pattern: ^[0-9]{14}-1-[0-9]{6}/[0-9]{4}$. Example: `` - `sequence` (number): sequence Example: `10` - `url` (string): Alternatively a PNCP notice page URL, e.g. https://pncp.gov.br/app/editais/46395000000139/2024/1. Pattern: ^https?://(www\.)?pncp\.gov\.br/app/editais/. Example: `` - `year` (number): year Example: `2021` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "pncp-gov-br", capability: "procurement/procurement_detail", options: { pncp_control_number: "46395000000139-1-000001/2024", }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "pncp-gov-br", "capability": "procurement/procurement_detail", "options": { "pncp_control_number": "46395000000139-1-000001/2024" } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "pncp-gov-br", "capability": "procurement/procurement_detail", "options": { "pncp_control_number": "46395000000139-1-000001/2024" } } }' ``` ### CLI ```sh firecrawl scrape 'pncp-gov-br/procurement/procurement_detail' \ --options '{"pncp_control_number":"46395000000139-1-000001/2024"}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "pncp-gov-br", "capability": "procurement/procurement_detail", "options": { "pncp_control_number": "46395000000139-1-000001/2024" } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "pncp-gov-br", "capability": "procurement/procurement_detail", "options": { "pncp_control_number": "46395000000139-1-000001/2024" } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "buyer_cnpj": "46395000000139", "observed_at_ms": 1794077195149, "procurement": { "additional_information": "Lei 14.133 Art. 75. É dispensável a licitação: II - para contratação que envolva valores inferiores a R$ 50.000,00.", "api_url": "https://pncp.gov.br/api/consulta/v1/orgaos/46395000000139/compras/2024/1", "awarded_total_value_brl": 73, "budget_confidentiality": "Compra sem sigilo", "buyer": { "branch_code": "E", "cnpj": "46395000000139", "government_level_code": "M", "name": "MUNICIPIO DE SAO PAULO" }, "buyer_cnpj": "46395000000139", "dispute_mode": "Dispensa Com Disputa", "electronic_process_url": null, "estimated_total_value_brl": 160, "file_count": 1, "files": [ { "active": true, "document_type": "Aviso de Contratação Direta", "document_type_code": 1, "download_url": "https://pncp.gov.br/pncp-api/v1/orgaos/46395000000139/compras/2024/1/arquivos/1", "published_at": "2024-01-18T16:10:24", "sequence": 1, "title": "EDITAL_ CERTIFICADO DIGITAL" } ], "has_result": true, "instrument_type": "Aviso de Contratação Direta", "item_count": 1, "items": [ { "benefit_type": "Participação exclusiva para ME/EPP", "category": "Não se aplica", "confidential_budget": false, "description": "Emissão de certificado digital a1 para pessoa jurídica", "estimated_total_value_brl": 160, "estimated_unit_value_brl": 160, "has_result": true, "judgment_criterion": "Menor preço", "kind": "Serviço", "ncm_nbs_code": null, "number": 1, "quantity": 1, "status": "Homologado", "unit": "UNIDADE", "updated_at": "2025-03-17T04:30:57" } ], "legal_basis": { "code": 19, "description": "Dispensa de Licitação: para contratação que envolva valores inferiores a R$ 50.000,00 (cinquenta mil reais), no caso de outros serviços e compras", "name": "Lei 14.133/2021, Art. 75, II" }, "modality": "Dispensa", "modality_code": 8, "number": "90001", "object": "Aquisição de certificado digital e-CNPJ - tipo A1 pelo período de 12 meses. Qualquer divergência entre as especificações contidas no Edital de dispensa eletrônica e as constantes no CATMAT/CATSER do COMPRASNET prevalecerá para todos os efeitos as do Aviso de dispensa eletrônica.", "origin_system_url": null, "pncp_control_number": "46395000000139-1-000001/2024", "price_registration_system": false, "process": "6011.2024/0000006", "proposals_close_at": "2024-01-23T07:59:59", "proposals_open_at": "2024-01-18T16:10:22", "published_at": "2024-01-18T16:10:24", "sequence": 1, "source_url": "https://pncp.gov.br/app/editais/46395000000139/2024/1", "status": "Divulgada no PNCP", "status_code": 1, "unit": { "city": "São Paulo", "city_ibge_code": "3550308", "code": "925056", "name": "PMSP - SECRETARIA DO GOVERNO MUNICIPAL", "state": "SP", "state_name": "São Paulo" }, "updated_at": "2025-03-17T04:30:57", "warnings": [], "year": 2024 }, "sequence": 1, "source_url": "https://pncp.gov.br/app/editais/46395000000139/2024/1", "year": 2024 } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Procurement detail - Capability: `procurement/procurement_detail` - Description: One PNCP procurement (compra) identified by its control number (e.g. 46395000000139-1-000001/2024), by a pasted notice page URL (https://pncp.gov.br/app/editais/{cnpj}/{year}/{sequence}) or by buyer CNPJ + year + sequence: object, buyer and unit, modality, legal basis, status, estimated and awarded values, proposal window, origin-system link, the line items (description, quantity, unit, estimated unit and total value, status; up to 500) and the published files (notice and annex download URLs). An unknown procurement is not_found. If the items or files endpoint fails, the procurement is still returned with null items/files and a warning. - Instructions: To read a Brazilian procurement in full, e.g. rank its items by estimated total, check the proposal deadline and status, or get the notice PDF, starting from a control number found with procurement_search or a pncp.gov.br/app/editais URL. - Cost: 5 credits per call - Capability file: [Procurement detail](https://alexandria.firecrawl.dev/agents/providers/pncp-gov-br/procurement/procurement_detail) Accepted options: - `cnpj` (string): Buyer CNPJ (14 digits, punctuation optional). Use together with year and sequence. Example: `` - `include_files` (boolean): Fetch the published document list (notice, annexes). Example: `false` - `include_items` (boolean): Fetch up to 500 line items. Example: `false` - `pncp_control_number` (string): Kind-1 compra number, e.g. 93235968000188-1-000183/2026 (procurement_control_number from procurement_search). Pattern: ^[0-9]{14}-1-[0-9]{6}/[0-9]{4}$. Example: `` - `sequence` (number): sequence Example: `10` - `url` (string): Alternatively a PNCP notice page URL, e.g. https://pncp.gov.br/app/editais/46395000000139/2024/1. Pattern: ^https?://(www\.)?pncp\.gov\.br/app/editais/. Example: `` - `year` (number): year Example: `2021` Response schema example: ```json { "buyer_cnpj": "46395000000139", "observed_at_ms": 1794077195149, "procurement": { "additional_information": "Lei 14.133 Art. 75. É dispensável a licitação: II - para contratação que envolva valores inferiores a R$ 50.000,00.", "api_url": "https://pncp.gov.br/api/consulta/v1/orgaos/46395000000139/compras/2024/1", "awarded_total_value_brl": 73, "budget_confidentiality": "Compra sem sigilo", "buyer": { "branch_code": "E", "cnpj": "46395000000139", "government_level_code": "M", "name": "MUNICIPIO DE SAO PAULO" }, "buyer_cnpj": "46395000000139", "dispute_mode": "Dispensa Com Disputa", "electronic_process_url": null, "estimated_total_value_brl": 160, "file_count": 1, "files": [ { "active": true, "document_type": "Aviso de Contratação Direta", "document_type_code": 1, "download_url": "https://pncp.gov.br/pncp-api/v1/orgaos/46395000000139/compras/2024/1/arquivos/1", "published_at": "2024-01-18T16:10:24", "sequence": 1, "title": "EDITAL_ CERTIFICADO DIGITAL" } ], "has_result": true, "instrument_type": "Aviso de Contratação Direta", "item_count": 1, "items": [ { "benefit_type": "Participação exclusiva para ME/EPP", "category": "Não se aplica", "confidential_budget": false, "description": "Emissão de certificado digital a1 para pessoa jurídica", "estimated_total_value_brl": 160, "estimated_unit_value_brl": 160, "has_result": true, "judgment_criterion": "Menor preço", "kind": "Serviço", "ncm_nbs_code": null, "number": 1, "quantity": 1, "status": "Homologado", "unit": "UNIDADE", "updated_at": "2025-03-17T04:30:57" } ], "legal_basis": { "code": 19, "description": "Dispensa de Licitação: para contratação que envolva valores inferiores a R$ 50.000,00 (cinquenta mil reais), no caso de outros serviços e compras", "name": "Lei 14.133/2021, Art. 75, II" }, "modality": "Dispensa", "modality_code": 8, "number": "90001", "object": "Aquisição de certificado digital e-CNPJ - tipo A1 pelo período de 12 meses. Qualquer divergência entre as especificações contidas no Edital de dispensa eletrônica e as constantes no CATMAT/CATSER do COMPRASNET prevalecerá para todos os efeitos as do Aviso de dispensa eletrônica.", "origin_system_url": null, "pncp_control_number": "46395000000139-1-000001/2024", "price_registration_system": false, "process": "6011.2024/0000006", "proposals_close_at": "2024-01-23T07:59:59", "proposals_open_at": "2024-01-18T16:10:22", "published_at": "2024-01-18T16:10:24", "sequence": 1, "source_url": "https://pncp.gov.br/app/editais/46395000000139/2024/1", "status": "Divulgada no PNCP", "status_code": 1, "unit": { "city": "São Paulo", "city_ibge_code": "3550308", "code": "925056", "name": "PMSP - SECRETARIA DO GOVERNO MUNICIPAL", "state": "SP", "state_name": "São Paulo" }, "updated_at": "2025-03-17T04:30:57", "warnings": [], "year": 2024 }, "sequence": 1, "source_url": "https://pncp.gov.br/app/editais/46395000000139/2024/1", "year": 2024 } ``` ### Procurement search - Capability: `procurement/procurement_search` - Description: Search public procurement on PNCP (pncp.gov.br), Brazil's national procurement portal covering federal, state and municipal buyers: tender notices (edital), price-registration minutes (ata) or contracts (contrato) matching a keyword, optionally filtered by state (UF), government level, modality and proposal status. Returns one page of summary records with the PNCP control number needed by procurement_detail. - Instructions: To find Brazilian public tenders, price-registration minutes or contracts on a topic (e.g. school meals, notebooks, AI solutions), optionally in one state or government level or only those still receiving proposals, and get the control number to read one in full. - Cost: 5 credits per call - Capability file: [Procurement search](https://alexandria.firecrawl.dev/agents/providers/pncp-gov-br/procurement/procurement_search) Accepted options: - `document_type` (string): edital = tender notice, ata = price-registration minutes, contrato = signed contract. Example: `edital` - `government_level` (string): government_level Example: `federal` - `modality` (number): PNCP modality code: 1 Leilão eletrônico, 2 Diálogo competitivo, 3 Concurso, 4 Concorrência eletrônica, 5 Concorrência presencial, 6 Pregão eletrônico, 7 Pregão presencial, 8 Dispensa, 9 Inexigibilidade, 10 Manifestação de interesse, 11 Pré-qualificação, 12 Credenciamento, 13 Leilão presencial, 14 Inaplicabilidade. Example: `10` - `page` (number): page Example: `1` - `page_size` (number): page_size Example: `20` - `query` (string, required): Keywords matched against the notice object and description, e.g. 'merenda escolar' or 'notebook'. Example: `` - `sort` (string): sort Example: `newest` - `state` (string): Two-letter UF code of the buyer, e.g. SP, RJ, MG. Pattern: ^[A-Za-z]{2}$. Example: `` - `status` (string): Notice phase filter (editais only). Example: `all` Response schema example: ```json { "count": 5, "next_page": 2, "observed_at_ms": 1794077195149, "page": 1, "page_size": 5, "query": { "document_type": "edital", "government_level": null, "modality": null, "query": "notebook", "sort": "newest", "state": null, "status": "all" }, "records": [ { "branch": "Executivo", "buyer_cnpj": "00884245000129", "buyer_name": "INSTITUTO DE PREVIDENCIA DOS SERVIDORES PUBLICOS MUNICIPAIS DE CAXIAS", "cancelled": false, "city": "Caxias", "description": "Formação de Registro de Preços para futura contratação de empresa especializada em fornecimento de equipamentos e materiais de informática destinados à manutenção das atividades administrativas e operacionais do Instituto de Previdência dos Servidores Públicos Municipais de Caxias – MA – CAXIASPREV.", "document_type": "edital", "document_type_label": "Edital", "government_level": "Municipal", "government_level_code": "M", "has_result": false, "id": "5fbba156d0c1dab5cdfab68367fba293", "modality": "Pregão - Eletrônico", "modality_code": 6, "number": "001/2026.", "pncp_control_number": "00884245000129-1-000009/2026", "procurement_control_number": "00884245000129-1-000009/2026", "proposals_close_at": "2026-10-06T09:00", "proposals_open_at": "2026-09-22T14:00", "published_at": "2026-09-22T09:10:07.665924", "sequence": 9, "signed_at": null, "source_url": "https://pncp.gov.br/app/editais/00884245000129/2026/9", "state": "MA", "status": "Anulada", "status_code": "3", "title": "Edital nº 001/2026./2026", "total_value_brl": null, "unit_code": "48129", "unit_name": "INSTITUTO DE PREVIDÊNCIA DOS SERVIDORES PÚBLICOS MUNICIPAIS DE CAXIAS", "updated_at": "2026-11-07T12:32:34.851461230", "year": 2026 }, { "branch": "Não se aplica", "buyer_cnpj": "10380608000142", "buyer_name": "MUNICIPIO DE PARAIPABA", "cancelled": false, "city": "Paraipaba", "description": "Aquisição de Equipamentos e Mobílias destinados a atender as necessidades da Secretaria da Cultura do Município de Paraipaba/CE", "document_type": "edital", "document_type_label": "Edital", "government_level": "Municipal", "government_level_code": "M", "has_result": false, "id": "538419692244174b1119556ad0c443ef", "modality": "Pregão - Eletrônico", "modality_code": 6, "number": "PE009.2026", "pncp_control_number": "10380608000142-1-000026/2026", "procurement_control_number": "10380608000142-1-000026/2026", "proposals_close_at": "2026-08-19T08:00", "proposals_open_at": "2026-08-07T08:00", "published_at": "2026-08-06T09:37:38.986158", "sequence": 26, "signed_at": null, "source_url": "https://pncp.gov.br/app/editais/10380608000142/2026/26", "state": "CE", "status": "Revogada", "status_code": "2", "title": "Edital nº PE009.2026/2026", "total_value_brl": null, "unit_code": "907", "unit_name": "Paraipaba", "updated_at": "2026-11-07T12:32:00.708043415", "year": 2026 }, { "branch": "Não se aplica", "buyer_cnpj": "00360305000104", "buyer_name": "CAIXA ECONOMICA FEDERAL", "cancelled": false, "city": "Brasília", "description": "1.1\tAQUISIÇÃO DE BENS DESTINADOS AO ATENDIMENTO DAS NECESSIDADES DA PROCURADORIA-GERAL DA FAZENDA NACIONAL, CONFORME AS ESPECIFICAÇÕES TÉCNICAS PREVISTAS NO TERMO DE REFERÊNCIA, POR MEIO DE COMPRA DIRETA. OS ITENS CONSISTEM EM 150 (CENTO E CINQUENTA) CANETAS METÁLICAS, 150 (CENTO E CINQUENTA) COPOS TÉRMICOS EM INOX, 150 (CENTO E CINQUENTA) CADERNETAS MOLESKINE, 150 (CENTO E CINQUENTA) CALENDÁRIOS DE MESA, 150 (CENTO E CINQUENTA) CORDÕES PARA CRACHÁ E 150 (CENTO E CINQUENTA) MOCHILAS EXECUTIVAS PARA NOTEBOOK, DESTINADOS À DISTRIBUIÇÃO AOS PARTICIPANTES DO ENCONTRO REGIONAL DA PRFN2.", "document_type": "edital", "document_type_label": "Ato que autoriza a Contratação Direta", "government_level": "Não se aplica", "government_level_code": "N", "has_result": false, "id": "e24f15e57cba30a530496ddf11f5e78e", "modality": "Dispensa", "modality_code": 8, "number": "1053", "pncp_control_number": "00360305000104-1-000883/2026", "procurement_control_number": "00360305000104-1-000883/2026", "proposals_close_at": null, "proposals_open_at": null, "published_at": "2026-11-07T02:02:04.061968812", "sequence": 883, "signed_at": null, "source_url": "https://pncp.gov.br/app/editais/00360305000104/2026/883", "state": "DF", "status": "Divulgada no PNCP", "status_code": "1", "title": "Ato que autoriza a Contratação Direta nº 1053/2026", "total_value_brl": null, "unit_code": "5307", "unit_name": "GECOT", "updated_at": "2026-11-07T02:02:04.061968812", "year": 2026 }, { "branch": "Não se aplica", "buyer_cnpj": "01612568000126", "buyer_name": "MUNICIPIO DE BOA HORA", "cancelled": false, "city": "Boa Hora", "description": "Registro de preço para Contratação de empresa para o fornecimento de materiais, equipamentos, periféricos e acessórios de informática, visando atender às necessidades operacionais e administrativas das diversas Secretarias e órgãos integrantes da Administração Pública Municipal de Boa Hora – PI", "document_type": "edital", "document_type_label": "Edital", "government_level": "Municipal", "government_level_code": "M", "has_result": false, "id": "e8c76c823bfe0a9189babae31138313d", "modality": "Pregão - Eletrônico", "modality_code": 6, "number": "PE 010/2026", "pncp_control_number": "01612568000126-1-000049/2026", "procurement_control_number": "01612568000126-1-000049/2026", "proposals_close_at": "2026-11-18T09:00", "proposals_open_at": "2026-11-06T23:59", "published_at": "2026-11-06T23:58:52.624727936", "sequence": 49, "signed_at": null, "source_url": "https://pncp.gov.br/app/editais/01612568000126/2026/49", "state": "PI", "status": "Divulgada no PNCP", "status_code": "1", "title": "Edital nº PE 010/2026/2026", "total_value_brl": null, "unit_code": "2657", "unit_name": "MUNICIPIO DE BOA HORA/ PI ", "updated_at": "2026-11-06T23:58:52.624727936", "year": 2026 }, { "branch": "Executivo", "buyer_cnpj": "11772847000100", "buyer_name": "SECRETARIA DE ESTADO DO DESENVOLVIMENTO RURAL", "cancelled": false, "city": "Macapá", "description": "Aquisição de equipamentos de informática, especificamente computadores do tipo desktop e notebooks, destinados ao aparelhamento, à modernização e ao suporte da infraestrutura tecnológica e administrativa da Secretaria de Estado do Desenvolvimento Rural - SDR/AP, cujos recursos são oriundos da Emenda Parlamentar Individual Impositiva nº 10836/2026.", "document_type": "edital", "document_type_label": "Edital", "government_level": "Estadual", "government_level_code": "E", "has_result": false, "id": "66ef90436a64c8580405aacc01e2c3a3", "modality": "Pregão - Eletrônico", "modality_code": 6, "number": "005", "pncp_control_number": "11772847000100-1-000013/2026", "procurement_control_number": "11772847000100-1-000013/2026", "proposals_close_at": "2026-11-23T09:00", "proposals_open_at": "2026-11-10T08:00", "published_at": "2026-11-06T23:29:26.395600481", "sequence": 13, "signed_at": null, "source_url": "https://pncp.gov.br/app/editais/11772847000100/2026/13", "state": "AP", "status": "Divulgada no PNCP", "status_code": "1", "title": "Edital nº 005/2026", "total_value_brl": null, "unit_code": "71", "unit_name": "SECRETARIA DE ESTADO DO DESENVOLVIMENTO RURAL ", "updated_at": "2026-11-06T23:29:26.395600481", "year": 2026 } ], "source_url": "https://pncp.gov.br/api/search/?q=notebook&tipos_documento=edital&ordenacao=-data&pagina=1&tam_pagina=5", "total": 36143 } ```