Hungarian Public Construction Tenders (EKR) Scraper & MCP Tool

A high-performance, token-optimized Apify Actor and Model Context Protocol (MCP) server tool designed to extract structured public construction tenders, RFP notices, CPV classifications, estimated budget values, and submission deadlines from official Hungarian public procurement portals (kozbeszerzes.hu).

Engineered specifically for Autonomous AI Agents (RFP Analysis, Bid Preparation, Subcontractor Sourcing, and Market Intelligence), enterprise procurement pipelines, and direct integration into Claude Desktop, Cursor, LangChain, Make, and n8n.

---

⚡ Key Highlights & Architecture

• AI & Agent Native (MCP Tool): Outputs flattened, strictly typed JSON records engineered to prevent token bloat and context window pollution during multi-step LLM ReAct loops.
• Ultra-Lightweight & Fast: Runs on CheerioCrawler configured with a 128 MB memory limit, executing direct HTTP requests and parsing server-side HTML without headless browser overhead.
• Pay-per-Event (PPE) Pricing: Transparent pay-as-you-go billing—pay strictly for verified tender notices extracted ($0.010 per record) plus a synthetic start fee ($0.00005).
• Graceful Budget Cap Abort: Continuously tracks eventChargeLimitReached and invokes crawler.autoscaledPool.abort() to terminate immediately without dropping previously saved data.
• Construction-Specific Filtering: Optimized for CPV code family 45000000-7 (Construction work) and related architectural and engineering procurement categories.

---

📥 Input Configuration (Input Schema)

The input schema is optimized for automated agent invocation and precision filtering:

Field	Type	Default	Description
searchQuery	String	"óvoda felújítás"	Keyword or phrase matching the procurement title, description, or buyer name.
maxItems	Integer	5	Maximum number of tender records to extract and charge (range: 1 to 2000). Default is 5 for fast daily automated platform tests.
onlyActive	Boolean	true	When enabled, filters exclusively for tenders with open submission deadlines.
startUrls	Array	[]	Optional direct list of pre-filtered search query URLs from the procurement portal.

Input JSON Examples

Keyword search for active school/kindergarten renovations:

{
  "searchQuery": "óvoda felújítás",
  "maxItems": 10,
  "onlyActive": true
}

Broad infrastructure tender search:

{
  "searchQuery": "útépítés",
  "maxItems": 25,
  "onlyActive": true
}

---

📤 Output Dataset Format

Every record saved to the default dataset (Actor.pushData()) is a clean, structured JSON object:

Field	Type	Description	Sample Value
tenderTitle	string	Official subject and title of the tender	"Óvoda épület energetikai korszerűsítése és bővítése"
procurementId	string	Official notice or EKR reference ID	"EKR001234562026"
buyerName	string	Name of the contracting authority / organization	"Budapest Főváros X. Kerületi Önkormányzat"
buyerCity	string	City / seat of the contracting authority	"Budapest"
estimatedValue	string | null	Estimated value or contract amount (if public)	"185 000 000 HUF"
cpvCodes	string[]	Registered CPV classification codes	["45214100-1", "45321000-3"]
deadline	string	Final bid submission deadline (ISO or date string)	"2026-10-15T10:00:00.000Z"
noticeType	string	Stage / type of public notice	"Ajánlati felhívás"
winnerName	string | null	Awarded contractor name (for award notices)	null
tenderUrl	string	Direct URL to the official public notice	"https://kozbeszerzes.hu/adatbazis/megtekint/hirdetmeny/portal_12345_2026/"
scrapedAt	string	Extraction timestamp (ISO 8601)	"2026-09-12T16:00:00.000Z"

Output JSON Sample

{
  "tenderTitle": "Óvoda épület energetikai korszerűsítése és bővítése",
  "procurementId": "EKR001234562026",
  "buyerName": "Budapest Főváros X. Kerületi Önkormányzat",
  "buyerCity": "Budapest",
  "estimatedValue": "185 000 000 HUF",
  "cpvCodes": [
    "45214100-1 - Óvoda építése",
    "45321000-3 - Hőszigetelési munka"
  ],
  "deadline": "2026-10-15T10:00:00.000Z",
  "noticeType": "Ajánlati felhívás",
  "winnerName": null,
  "tenderUrl": "https://kozbeszerzes.hu/adatbazis/megtekint/hirdetmeny/portal_12345_2026/",
  "scrapedAt": "2026-09-12T16:00:00.000Z"
}

---

🤖 Agent & Pipeline Integrations

Model Context Protocol (MCP) Integration

Add this tool directly to your Claude Desktop or Cursor configuration (claude_desktop_config.json) to allow autonomous AI agents to query Hungarian public tenders:

{
  "mcpServers": {
    "apify-construction-tenders": {
      "command": "npx",
      "args": [
        "-y",
        "@apify/mcp-server",
        "--actor-id",
        "hyperion-intelligence/hungarian-procurement-tenders-scraper",
        "--token",
        "YOUR_APIFY_API_TOKEN"
      ]
    }
  }
}

Python Client Example

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_API_TOKEN")

run = client.actor("hyperion-intelligence/hungarian-procurement-tenders-scraper").call(
    run_input={"searchQuery": "mélyépítés", "maxItems": 10, "onlyActive": True}
)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"Tender: {item['tenderTitle']} | Deadline: {item['deadline']} | Buyer: {item['buyerName']}")

Direct REST / cURL

curl -X POST "https://api.apify.com/v2/acts/hyperion-intelligence~hungarian-procurement-tenders-scraper/runs?token=YOUR_APIFY_API_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"searchQuery": "óvoda", "maxItems": 10, "onlyActive": true}'

---

💰 Cost & Resource Consumption

• Compute Allocation: 128 MB RAM.
• Billing Model: Pay-per-Event (PPE).
  • Synthetic Actor Start Fee (apify-actor-start): $0.00005
  • Dataset Record Fee (apify-default-dataset-item): $0.010 / record
• Typical Cost: Extracting 50 full tender specifications costs approximately $0.50.

---

🔗 Complete Central European Construction & Compliance Stack

Connect our complementary, MCP-native intelligence tools to cross-reference tender projects with certified contractors, design engineers, and architects:

• Hungarian Construction Contractors (MKIK) Register Scraper: Match awarded tenders with certified general contractors, technical supervisors (FMV), and trade scopes.
• Hungarian Chamber of Engineers (MMK) Directory Scraper: Verify licensed structural, civil, MEP, and HVAC design engineers required for tender submissions.
• Hungarian Chamber of Architects (MÉK) Directory Scraper: Source licensed architectural planners, heritage experts, and design studios with decoded direct contact details.

End-to-End Workflow: AI agents can discover active tenders with this Actor, match required technical skills using the MMK/MÉK tools, and verify potential bidding partners via the MKIK contractor registry in a single automated loop.

---

⚖️ Legal & Compliance Note

This Actor accesses public procurement announcements and tender documents published by the Hungarian Public Procurement Authority (Közbeszerzési Hatóság) pursuant to statutory transparency mandates under EU and national procurement legislation. Users are responsible for adhering to applicable data handling regulations.

---

🇭🇺 Magyar nyelvű összefoglaló és keresési kulcsszavak

Magyar közbeszerzési építési beruházások és tenderek (EKR / Közbeszerzési Hatóság) strukturált adatgyűjtője. Ajánlati felhívások, építési tenderek (CPV 45), becsült értékek, beadási határidők és nyertes ajánlattevők automatizált kinyerése ajánlatkészítő és piacfigyelő AI rendszerekhez.