pncp-aec

Package Information

Released: 7/15/2025
Downloads: 0 weeklyĀ /Ā 0 monthly
Latest Version: 0.1.2
Author: tjsasakifln

Documentation

šŸ—ļø n8n-nodes-pncp-aec | Brazilian Public Procurement Automation 2025

PNCP Integration for n8n | Transform tender monitoring into intelligent workflows

n8n compatibility
Node.js version
License: MIT
GitHub

Fully automate your search for Brazilian public tenders with this premium n8n integration. Connect directly to the National Public Procurement Portal (PNCP) and transform opportunities into structured data for your AEC (Architecture, Engineering and Construction) workflows.

šŸš€ Why use this node in 2025?

āœ… AI-Ready: Structured data ready for analysis with ChatGPT, Claude and LLM models
āœ… Zero-Code Automation: Intuitive visual interface, no programming required
āœ… Real-time Monitoring: 24/7 monitoring of new tenders with webhooks
āœ… Multi-integration: Connects with Slack, Teams, WhatsApp, CRM, Google Sheets, Notion
āœ… 2025 Compliance: Updated with the latest Brazilian government APIs

šŸŽÆ Main Operations

šŸ“Š List by Publication Date - Temporal Monitoring

Track tenders by specific period, ideal for:

  • Automated monthly reports
  • New publication alerts
  • Market trend analysis

šŸ”„ List with Open Proposals - Active Opportunities

Find tenders open for proposals with:

  • Geographic filter by state (UF)
  • Calendar integration (deadline alerts)
  • Real-time push notifications

šŸŽ² Get Details by ID - Detailed Analysis

Extract complete information using:

  • Procuring entity CNPJ
  • Year and sequential number
  • Technical data for decision making

šŸ” Search by Keyword - Smart Search

Advanced search algorithm by:

  • Keywords in procurement object
  • Local semantic filters
  • Automatic categorization by sector

⚔ Quick Installation (3 minutes)

Via NPM (Recommended)

# Install globally
npm install -g n8n-nodes-pncp-aec

# Or install locally in your n8n project
npm install n8n-nodes-pncp-aec

Manual Installation for Development

# 1. Clone and configure
git clone https://github.com/tjsasakifln/AEC-Tenders.git
cd n8n-nodes-aec-tenders && npm install && npm run build

# 2. Local link to n8n
npm link && cd ~/.n8n/custom && npm link n8n-nodes-aec-tenders

# 3. Start n8n
n8n start

šŸ’” Advanced Use Cases 2025

šŸ¤– AI-Powered Workflow: Intelligent Analysis + Notion Database

{
  "name": "Smart Tender Analysis 2025",
  "nodes": [
    {
      "parameters": {
        "resource": "tender",
        "operation": "searchByKeyword", 
        "startDate": "2025-01-01",
        "endDate": "2025-12-31",
        "keywords": "artificial intelligence, sustainability, smart cities, renewable energy",
        "returnAll": false,
        "limit": 50
      },
      "type": "n8n-nodes-aec-tenders.aecTenders",
      "name": "šŸ” PNCP Scanner"
    },
    {
      "parameters": {
        "model": "gpt-4-turbo",
        "prompt": "Analyze this tender and classify by: innovation potential (1-10), technical complexity (low/medium/high), and success probability for an engineering company (%). Tender: {{$json.tenderObject}}"
      },
      "type": "n8n-nodes-base.openAi",
      "name": "🧠 AI Analysis"
    },
    {
      "parameters": {
        "database": "Tenders 2025 - Pipeline",
        "properties": {
          "Name": "={{$json.procuringEntityName}}",
          "Object": "={{$json.tenderObject}}", 
          "Value": "={{$json.estimatedTotalValue}}",
          "Opening": "={{$json.proposalOpeningDate}}",
          "AI Score": "={{$json.aiAnalysis}}",
          "URL": "={{$json.portalUrl}}"
        }
      },
      "type": "n8n-nodes-base.notion",
      "name": "šŸ“Š Notion CRM"
    }
  ]
}

šŸ“± Mobile-First Workflow: WhatsApp Business + Alerts

{
  "name": "Mobile Tender Alerts",
  "trigger": {
    "type": "cron",
    "parameters": {
      "rule": "0 9,14 * * 1-5"
    }
  },
  "nodes": [
    {
      "parameters": {
        "resource": "tender",
        "operation": "listWithOpenProposals",
        "stateUf": "SP",
        "limit": 10
      },
      "type": "n8n-nodes-aec-tenders.aecTenders"
    },
    {
      "parameters": {
        "message": "🚨 *NEW TENDERS SP*\n\n{{$json.procuringEntityName}}\nšŸ’° R$ {{$json.estimatedTotalValue}}\nšŸ“… Deadline: {{$json.proposalOpeningDate}}\nšŸ”— {{$json.portalUrl}}"
      },
      "type": "n8n-nodes-base.whatsappBusiness"
    }
  ]
}

šŸ“ˆ Workflow Analytics: Power BI Dashboard Integration

{
  "name": "Tender Market Intelligence",
  "nodes": [
    {
      "parameters": {
        "resource": "tender",
        "operation": "listByPublicationDate",
        "startDate": "2025-01-01", 
        "endDate": "2025-03-31",
        "returnAll": true
      },
      "type": "n8n-nodes-aec-tenders.aecTenders"
    },
    {
      "parameters": {
        "operation": "uploadData",
        "dataset": "tenders-q1-2025",
        "data": "={{$json}}"
      },
      "type": "n8n-nodes-base.microsoftPowerBi"
    }
  ]
}

šŸ“Š Optimized Data Schema (2025)

interface TenderData {
  pncpId: string;              // Unique PNCP identifier
  procuringEntityName: string; // Procuring entity name  
  tenderObject: string;        // Procurement object
  publicationDate: string;     // Publication date (ISO 8601)
  proposalOpeningDate: string; // Proposal opening date
  estimatedTotalValue: number; // Estimated value (BRL)
  portalUrl: string;          // Direct PNCP link
  
  // Automatic metadata
  _extractedAt: string;       // Extraction timestamp
  _category?: string;         // AI-generated category
  _riskScore?: number;        // Risk score (0-100)
}

šŸ” Security & Compliance

  • āœ… LGPD Compliant: No personal data storage
  • āœ… Rate Limiting: Respects PNCP API limits
  • āœ… Error Recovery: Automatic retry with exponential backoff
  • āœ… Audit Trail: Structured logs for compliance
  • āœ… HTTPS Only: End-to-end encrypted communication

🌟 Roadmap

Completed āœ… In Development šŸ”„ Planned šŸ“…
PNCP API Integration Performance improvements Notification system
4 main operations Expanded documentation Advanced filters
Data validation Automated testing Smart caching

šŸ¤ Technical Support

šŸŒ Global Compatibility

Environment Status Minimum Version
n8n Cloud āœ… Supported v1.82.0+
n8n Self-hosted āœ… Supported v1.82.0+
Node.js āœ… LTS v20.15+
Docker āœ… Containers latest
Kubernetes āœ… Helm Charts v1.25+

šŸ“„ License & Credits

MIT License Ā© 2025 Tiago Sasaki

Developed with ā¤ļø for the Brazilian engineering community by Tiago Sasaki - Automation and AI Specialist.


šŸ”„ Accelerate your growth in 2025 - Clone and configure!

git clone https://github.com/tjsasakifln/AEC-Tenders.git
cd n8n-nodes-aec-tenders && npm install && npm run build

Tags: brazilian-tenders pncp-api n8n-automation aec-tools govtech-2025 no-code workflow-automation construction-tech procurement-api smart-cities

Discussion