Hungarian Construction Contractors (MKIK) Directory Scraper & MCP Tool

A high-performance, token-optimized Apify Actor and Model Context Protocol (MCP) server tool designed to extract verified construction companies, general contractors, licensed trades, and certified technical supervisors (felelős műszaki vezető - FMV) from the official Hungarian Chamber of Commerce and Industry (Magyar Kereskedelmi és Iparkamara – MKIK) public construction registry (kivitelezo.hu).

Built specifically for Autonomous AI Agents (Procurement, Subcontractor Sourcing, Risk & GRC Compliance), automated CRM enrichment, and direct workflow 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 eliminate context pollution and minimize token consumption during LLM ReAct loops.
• Ultra-Lightweight & Fast: Built entirely on CheerioCrawler running on an optimized 128 MB memory profile with sub-second request handling (no heavy headless browser overhead).
• Pay-per-Event (PPE) Economics: Predictable cost structure—pay strictly for successfully extracted company profiles ($0.004 per record) plus a synthetic start fee ($0.00005).
• Graceful Spending Cap Protection: Real-time monitoring of eventChargeLimitReached triggers crawler.autoscaledPool.abort() to preserve captured data without charge overruns.
• Comprehensive Verification: Extracts statutory tax numbers, MKIK registration codes, authorized construction trade scopes, and licensed on-site technical managers (FMV).

---

📥 Input Configuration (Input Schema)

The input schema is streamlined to 3 core parameters to maximize LLM tool discovery and function-calling reliability.

Field	Type	Default	Description
searchQuery	String	"építő"	Company name, tax number fragment, activity keyword, or registration number.
maxItems	Integer	5	Maximum number of contractor profiles to extract and charge (range: 1 to 5000). Default is 5 for fast daily automated platform tests.
startUrls	Array	[]	Optional direct list of pre-filtered MKIK search result URLs.

Input JSON Examples

Keyword or trade search:

{
  "searchQuery": "villanyszerelés",
  "maxItems": 15
}

Tax number or specific company lookup:

{
  "searchQuery": "12345678",
  "maxItems": 1
}

---

📤 Output Dataset Format

Every record pushed to the default dataset (Actor.pushData()) represents a standardized, verified contractor profile:

Field	Type	Description	Sample Value
companyName	string	Official corporate name or sole proprietor designation	"Kovács és Társa Építőipari Kft."
taxNumber	string	Hungarian tax identification number (Adószám)	"12345678-2-42"
mkikRegNumber	string	Official MKIK contractor registration code	"21A12345"
registrationStatus	string	Official registry status	"Nyilvántartásban szerepel"
headquarters	string	Registered corporate seat / address	"1054 Budapest, Alkotmány u. 10."
county	string	Territorial county (vármegye)	"Budapest"
mainActivity	string	Primary TEÁOR activity code and description	"4120 - Lakó- és nem lakó épület építése"
authorizedActivities	string[]	Formally registered construction activities / trades	["4321 - Villanyszerelés", "4322 - Víz-, gáz-, fűtésszerelés"]
technicalSupervisors	string[]	Certified technical supervisors (FMV) with chamber IDs	["Nagy Péter (MMK: 01-12345, MV-É)"]
profileUrl	string	Direct link to the official MKIK profile page	"https://kivitelezo.hu/adatlap/21A12345"
scrapedAt	string	Extraction timestamp (ISO 8601)	"2026-09-12T15:30:00.000Z"

Output JSON Sample

{
  "companyName": "Kovács és Társa Építőipari Kft.",
  "taxNumber": "12345678-2-42",
  "mkikRegNumber": "21A12345",
  "registrationStatus": "Nyilvántartásban szerepel",
  "headquarters": "1054 Budapest, Alkotmány u. 10.",
  "county": "Budapest",
  "mainActivity": "4120 - Lakó- és nem lakó épület építése",
  "authorizedActivities": [
    "4120 - Lakó- és nem lakó épület építése",
    "4321 - Villanyszerelés",
    "4322 - Víz-, fűtés-, légkondicionáló-szerelés"
  ],
  "technicalSupervisors": [
    "Nagy Péter (MMK azonosító: 01-12345, jogosultság: MV-É)"
  ],
  "profileUrl": "https://kivitelezo.hu/adatlap/21A12345",
  "scrapedAt": "2026-09-12T15:30: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 the registry:

{
  "mcpServers": {
    "apify-mkik-contractors": {
      "command": "npx",
      "args": [
        "-y",
        "@apify/mcp-server",
        "--actor-id",
        "hyperion-intelligence/hungarian-contractors-mkik-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-contractors-mkik-scraper").call(
    run_input={"searchQuery": "generálkivitelezés", "maxItems": 10}
)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"{item['companyName']} | Tax ID: {item['taxNumber']} | Status: {item['registrationStatus']}")

Direct REST / cURL

curl -X POST "https://api.apify.com/v2/acts/hyperion-intelligence~hungarian-contractors-mkik-scraper/runs?token=YOUR_APIFY_API_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{"searchQuery": "építő", "maxItems": 20}'

---

💰 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.004 / record
• Estimated Run Cost: Extracting 100 complete contractor records costs approximately $0.40.

---

🔗 Complete Central European Construction & Compliance Stack

Complete your Central European construction intelligence and compliance stack by pairing this Actor with our specialized companion tools:

• Hungarian Chamber of Engineers (MMK) Directory Scraper: Extract certified civil, structural, mechanical, and electrical engineers with official MMK registry IDs, sector classifications, and direct contacts.
• Hungarian Chamber of Architects (MÉK) Directory Scraper: Extract licensed architects, urban planners, interior designers, and architectural studios with verified credentials and decoded direct contacts.
• Hungarian Public Procurement Construction Tenders Scraper: Extract structured public construction tenders, RFP notices, CPV classifications (45000000-7), estimated budget values, and submission deadlines from official Hungarian procurement portals.

---

⚖️ Legal & Compliance Note

This Actor extracts publicly available records maintained by the Hungarian Chamber of Commerce and Industry (Magyar Kereskedelmi és Iparkamara – MKIK) under national transparency mandates for registered construction contractors. Users must ensure compliance with relevant data privacy laws and trade regulations when processing business intelligence.

---

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

Magyar Kereskedelmi és Iparkamara (MKIK) Építőipari Kivitelezői Névjegyzék (kivitelezo.hu) scraper. Regisztrált építőipari kivitelező cégek, egyéni vállalkozók, felelős műszaki vezetők (FMV), szakipari tevékenységek és adószámok gyors exportálása alvállalkozói auditokhoz és beszerzési folyamatokhoz.