german-b2b-data-suite
Allows LangChain agents to call the MCP server's German B2B data tools for lead discovery, impressum enrichment, company KYB checks, tender search, foreclosure search, and e-invoice operations.
Provides Make.com blueprints for building DACH B2B automation workflows, enabling lead-to-KYB and related data pipelines.
Provides n8n integration through certified workflows and an n8n node package for automating DACH B2B lead generation, KYB and insolvency checks, foreclosure monitoring, public tender search, and e-invoicing pipelines.
🇩🇪 DACH & German B2B Data, Compliance & PropTech API Suite
Official Open-Source Integration Hub for Apify Actors, AI Agents (MCP), n8n & Make.com
The comprehensive, enterprise-grade data automation suite for Germany, Austria, and Switzerland (DACH).
Turnkey integration into Claude Desktop, Cursor AI, Windsurf, LangChain, n8n, Make.com, and Python/Node.js microservices.
Overview • The 6 Actors • Public Tasks • AI Agent Setup (MCP) • Workflow Automation • Quickstart Code • Deutsche Dokumentation
🎥 48-Second Live Video Showcase (1080p HD)

Automate German B2B leads, GDPR-compliant impressum contact enrichment, real-time Handelsregister & insolvency KYB audits, ZVG foreclosures, and public tenders via Apify, n8n, Make.com, or AI Agents (MCP).
Related MCP server: eu-company-mcp-server
🏛️ Architecture & End-to-End B2B Data Flow
Our 6 cloud actors seamlessly chain together to build complete, compliant outbound lead generation, credit risk evaluation, and billing pipelines:
flowchart LR
A["1. B2B Directory Scraper<br/>(11880 & Gelbe Seiten)"] -->|"Clean Domains & Phone"| B["2. Impressum Enricher<br/>(§ 5 DDG / Contact Page)"]
B -->|"Legal Entity & HRB Number"| C["3. German KYB Scraper<br/>(Handelsregister & Insolvency)"]
C -->|"Audit Clear / Verified CEO"| D["4. E-Invoice Suite<br/>(ZUGFeRD 2.2 / XRechnung)"]
E["5. Foreclosure Scraper<br/>(zvg-portal.de)"] -->|"Auction Case & Court"| C
F["6. Public Tenders Scraper<br/>(service.bund.de)"] -->|"Contracting Authority"| C
style A fill:#eff6ff,stroke:#2563eb,stroke-width:2px;
style B fill:#eff6ff,stroke:#2563eb,stroke-width:2px;
style C fill:#f0fdf4,stroke:#16a34a,stroke-width:2px;
style D fill:#fdf4ff,stroke:#c026d3,stroke-width:2px;
style E fill:#fffbeb,stroke:#d97706,stroke-width:2px;
style F fill:#f8fafc,stroke:#475569,stroke-width:2px;🚀 The 6 Specialized Actors
# | Actor Name & Apify Store Link | Primary Capabilities | Standards & Data Sources | Pricing |
1 | Generate DIN 5008 PDF/A-3, embed XML into PDF, or validate incoming invoices | ZUGFeRD 2.2, Factur-X, XRechnung 3.0, EN 16931, KoSIT | Pay-Per-Event ($0.01 / invoice) | |
2 | Extract managing directors (Geschäftsführer), registered share capital, HRB & insolvency status | Official Handelsregister (XJustiz 3.5.1), Insolvenzbekanntmachungen | Pay-Per-Event ($0.015 / audit) | |
3 | Bulk scrape real estate auctions across all 16 states, market values in EUR, and appraisal PDFs | zvg-portal.de, Amtsgerichte | Pay-Per-Event ($0.01 / listing) | |
4 | Monitor public procurement & IT/construction tenders with CPV codes & bidding document URLs | service.bund.de, Bund & Länder | Pay-Per-Event ($0.005 / tender) | |
5 | Extract C-level executives, de-obfuscated emails, direct phone, HRB court & VAT ID (§ 5 DDG) | § 5 DDG (formerly TMG), § 25 MedienG, DSGVO | Pay-Per-Event ($0.005 / domain) | |
6 | Extract local businesses, crafts (Handwerker), and companies with clean domains & E.164 phones | Gelbe Seiten, 11880, Google-indexed directories | Pay-Per-Event ($0.008 / lead) |
🎯 13 Turnkey Public Tasks
Every actor comes with preconfigured, 1-click executable public tasks ready to be scheduled or integrated into automations:
Actor | Public Task Name | Purpose & Preconfigured Scope | Console 1-Click Link |
ZUGFeRD |
| Generate compliant DIN 5008 / EN 16931 PDF/A-3 invoice | |
ZUGFeRD |
| Inspect incoming invoice PDF/XML against official Schematron rules | |
KYB |
| Complete audit of directors, share capital & insolvency status | |
KYB |
| Rapid screening against official insolvency announcements | |
KYB |
| Batch verification of multi-company lists in a single run | |
ZVG |
| Search next 20 foreclosure auctions with valuations & court locations | |
ZVG |
| Target foreclosures with court-assessed value > 250,000 EUR + PDF reports | |
Tenders |
| Search open federal & municipal contracts for IT, Cloud, Software & AI | |
Tenders |
| Monitor public construction (VOB/A), infrastructure & facility management | |
Impressum |
| Extract CEOs, direct emails, phone & HRB from target domains | |
Impressum |
| Enrich corporate websites with register filings and VAT IDs (DE, ATU, CHE) | |
Leads |
| Extract craftsmen, electrical, solar & construction trades with phone | |
Leads |
| Discover German B2B companies with |
🤖 AI Agent & MCP Setup (Claude, Cursor, Windsurf)
This repository includes a standalone, open-source Python Model Context Protocol (MCP) server (src/german_b2b_mcp/server.py) built on the official Python mcp SDK (stdio transport) and containerized via Dockerfile.
It exposes 6 typed MCP tools backed by our Apify Cloud microservices—giving AI agents deterministic access to German/DACH data without exposing any proprietary scraper code:
MCP Tool Name | Backed Apify Cloud Actor | Purpose |
|
| Gelbe Seiten & 11880 B2B/craft leads + E.164 phone + domains |
|
| § 5 DDG CEOs, emails, phones, HRB court & VAT IDs |
|
| Handelsregister (XJustiz) & Insolvenzbekanntmachungen audit |
|
|
|
|
|
|
|
| ZUGFeRD 2.2 / Factur-X / XRechnung 3.0 generation & validation |
1. Run Locally via Python (pip)
git clone https://github.com/andregrunert-ctrl/german-b2b-data-suite.git
cd german-b2b-data-suite
pip install .
export APIFY_TOKEN="YOUR_APIFY_TOKEN"
python -m german_b2b_mcp.serverAdd this to %APPDATA%\Claude\claude_desktop_config.json (Windows), ~/Library/Application Support/Claude/claude_desktop_config.json (macOS), or .cursor/mcp.json:
{
"mcpServers": {
"german-b2b-data-suite": {
"command": "python",
"args": ["-m", "german_b2b_mcp.server"],
"env": {
"APIFY_TOKEN": "YOUR_APIFY_TOKEN"
}
}
}
}2. Run via Docker (stdio)
docker build -t german-b2b-mcp .
docker run -i --rm -e APIFY_TOKEN="YOUR_APIFY_TOKEN" german-b2b-mcpOr configure Claude Desktop / Cursor to launch the container directly:
{
"mcpServers": {
"german-b2b-data-suite": {
"command": "docker",
"args": ["run", "-i", "--rm", "-e", "APIFY_TOKEN", "german-b2b-mcp"],
"env": {
"APIFY_TOKEN": "YOUR_APIFY_TOKEN"
}
}
}
}3. Optional: Hosted SSE Endpoint (Zero Local Install)
In Cursor (Settings -> Features -> MCP -> Add New MCP Server) or remote MCP clients, you can alternatively use Apify's hosted SSE endpoint:
https://mcp.apify.com?actors=AGrunert/german-e-invoice-zugferd-xrechnung-suite,AGrunert/german-company-kyb-insolvency-scraper,AGrunert/german-real-estate-foreclosure-zvg-scraper,AGrunert/german-public-tenders-vergabe-scraper,AGrunert/german-impressum-b2b-lead-enricher,AGrunert/german-b2b-leads-directory-scraper&token=YOUR_APIFY_TOKENSample Agent Prompts
"Check if BioNTech SE in Mainz has any active insolvency proceedings and retrieve its registered share capital and legal directors."
"Extract all electrical contractors in Munich with websites, then parse their Impressum for CEO names and verify their HRB numbers."
"Search service.bund.de for all open AI and Cloud architecture tenders with deadlines in the next 3 weeks."
"Generate a tax-compliant DIN 5008 / EN 16931 ZUGFeRD 2.2 Comfort PDF/A-3 invoice for Acme Corp with 10 hours consulting."
⚡ Workflow Automation (n8n & Make.com)
📦 Official n8n Community Node Package (npm)
For an integrated, native node UI inside your n8n workflow canvas, install our official npm community package:
# In your n8n root directory:
npm install n8n-nodes-german-b2bOr in n8n Settings > Community Nodes, install n8n-nodes-german-b2b.
Supports all 6 tools as native Resource & Operation selections with turnkey credential management!
👉 GitHub: https://github.com/andregrunert-ctrl/n8n-nodes-german-b2b
👉 npm Package: https://www.npmjs.com/package/n8n-nodes-german-b2b
📋 Ready-to-Use Workflow Blueprints
Ready-to-use blueprint files are available in workflows/:
n8n Pipeline:
workflows/n8n_dach_b2b_lead_to_kyb_pipeline.json
Automates B2B Lead Scraping ➡️ Impressum CEO Enrichment ➡️ KYB Handelsregister & Insolvency Verification in one flow.Make.com Blueprint:
workflows/make_com_dach_b2b_blueprint.json
Modular webhook-triggered scenario chaining lead generation and legal entity verification.
🌐 RapidAPI Studio & Marketplace Specs (rapidapi/)
Want to integrate via RapidAPI or offer the 6 APIs on RapidAPI Hub?
We provide fully validated, turnkey OpenAPI 3.0.3 definitions with real sample payloads in rapidapi/:
Unified Suite (All 6 Tools):
rapidapi/00_unified_german_b2b_suite_openapi.jsonDedicated Individual Specs:
01_zugferd_openapi.json02_kyb_openapi.json03_zvg_openapi.json04_tenders_openapi.json05_impressum_openapi.json06_b2b_leads_openapi.json
1-Minute Publish Guide:
rapidapi/RAPIDAPI_PUBLISH_GUIDE.md
Simply import 00_unified_german_b2b_suite_openapi.json in RapidAPI Studio -> Add New API -> OpenAPI, configure the Secret Header Authorization: Bearer <APIFY_TOKEN>, and publish!
🤖 AI Agent MCP Registries (Smithery & Glama)
This repository includes a self-contained Python MCP server (python -m german_b2b_mcp.server), a production Dockerfile (python:3.12-slim), and verified registry manifests:
Glama.ai & PulseMCP:
glama.json(schema-validatedmaintainers+ Pythonstdioentrypoint)Smithery.ai:
smithery.yaml(runtime: "container"using rootDockerfile)Python Package:
pyproject.toml(german-b2b-mcp) &requirements.txt
💻 Code Quickstarts
Python (Sync REST Call)
pip install httpx
export APIFY_TOKEN="your_token_here"
python examples/run_suite_python.pyNode.js (Modern ESM Fetch)
export APIFY_TOKEN="your_token_here"
node examples/run_suite_node.mjs1-Click cURL
export APIFY_TOKEN="your_token_here"
bash examples/run_suite_curl.sh📊 Bulk Germany Datasets (Excel / CSV Download)
Looking for turnkey, ready-to-use German B2B and PropTech datasets without writing code or orchestrating APIs? We offer pre-compiled, enriched master datasets formatted specifically for German Microsoft Excel, PowerBI, and data science workflows:
🏠 German Real Estate Foreclosures Master Dataset (ZVG-Portal)
Coverage: Complete, nationwide inventory across all 16 German federal states (Bayern, NRW, Baden-Württemberg, Berlin, Hessen, Sachsen, etc.).
Enriched Attributes: Court (Amtsgericht), Case Number (Aktenzeichen), Property Type (Eigentumswohnung, Einfamilienhaus, Mehrfamilienhaus, Gewerbe), Full Street Address, Postal Code & City, Official Judicial Market Valuation in EUR (market_value_eur as float), Auction Date & Location, Cadaster (Grundbuchblatt), and Direct One-Click Links to Official Valuation PDF Appraisals (Gutachten & Bekanntmachungen).
Excel Formatting: Formatted .xlsx with frozen header, auto-filters, currency formatting (#.000,00 €), hyperlinked PDF documents, and an automated aggregation sheet (Marktübersicht nach Bundesland & Objektart).
💡 PDF Appraisal Download Note:
zvg-portal.deenforces anti-hotlinking security. Direct programmatic downloads requireReferer: item["detail_url"]. The Gumroad/Fiverr download package includes our turnkey 1-click Python batch downloader (download_gutachten_pdfs.py) to download all appraisal PDFs locally!Free 50-Item Curated Sample:
📥 Download 50-Item SEO Sample (.CSV) (RFC 4180 comma-delimited for Pandas, Kaggle & Hugging Face)
📥 Download 50-Item SEO Sample (.XLSX) (Multi-sheet styled workbook)
🤗 Hugging Face Hub Dataset (50-Item live sample preview)
📊 Kaggle Datasets Hub (Data explorer & kernels ready)
Full Nationwide Master Dataset & Live Services:
🛒 Instant Gumroad Download: Get Full Nationwide Master Dataset (.XLSX & .CSV) on Gumroad
💼 Productized Fiverr Gigs:
🚀 Apify Cloud Scraping Actor: Apify ZVG Scraper Actor ($0.01 / listing).
💼 Access custom recurring bulk extracts and productized DaaS delivery on demand.
🏢 German Handelsregister & KYB Master Sample (50 Verified Companies)
Official Sources: Live-extracted from
handelsregister.de(structured XJustiz 3.5.1SIXML &UTfilings) cross-checked againstinsolvenzbekanntmachungen.de.Enriched Attributes: Legal Name, KYB Risk Status (
CLEAR/WARNING_INSOLVENCY_FOUND), Federal State, Register Court (Amtsgericht), Register ID (HRB), Legal Form, Seat & Street Address, Registered Share Capital in EUR, Managing Directors / Board Members / Prokuristen, Business Purpose, and Official Insolvency Proceedings.Excel Formatting: Styled 2-sheet
.xlsxworkbook with frozen header, auto-filters, EUR share capital formatting, conditional KYB risk color badges, and federal-state & legal-form distribution tables.Free 50-Company Curated Sample:
📥 Download 50-Company KYB Sample (.CSV) (RFC 4180 comma-delimited for Pandas, Kaggle & Hugging Face)
📥 Download 50-Company Showcase Table (
02_handelsregister_kyb_sample.csv) (50-row drop-in showcase CSV)📥 Download 50-Company KYB Workbook (.XLSX) (Multi-sheet styled Excel workbook)
🤗 Hugging Face Hub Dataset (Public 50-company live KYB sample)
📊 Kaggle Datasets Hub (Data explorer & kernels ready)
Automated Live KYB Checks & Custom Bulk Audits:
🚀 Apify Cloud KYB Actor: German Company KYB & Insolvency Scraper ($0.015 / audit)
💼 Custom Bulk Audit & Excel Delivery on Fiverr: Order Bespoke German Handelsregister & KYB Audit
📊 Live Sample Datasets
Explore real sample outputs in samples/ formatted as JSON, CSV, and Excel:
📄
samples/01_zugferd_xrechnung_sample.json(EN 16931 PDF/A-3 & Schematron validation)🏢
samples/02_handelsregister_kyb_sample.json,.csv& 50-Company Styled.xlsx(50 verified German corporations incl. BioNTech SE, SAP SE, Siemens AG, Deutsche Börse AG, Celonis SE & insolvency audits)🏠
samples/03_zvg_foreclosures_sample.json&.csv(Foreclosures with EUR market values & PDF URLs)🏛️
samples/04_public_tenders_sample.json&.csv(Bund.de public procurement tenders & CPV codes)🔍
samples/05_impressum_leads_sample.json&.csv(§ 5 DDG CEOs, emails, phones, HRB & VAT IDs)🔨
samples/06_b2b_crafts_directory_sample.json&.csv(Crafts, trades & local business leads)
🇩🇪 Deutsche Dokumentation & B2B Use Cases
Die German B2B Data Suite löst zentrale Automatisierungsaufgaben im DACH-Raum:
1. Handelsregister API & Insolvenzprüfung (KYB)
Ermöglicht automatisierte Know-Your-Business-Prüfungen (KYB) für Banken, Fintechs und B2B-Plattformen:
Abfrage des amtlichen Handelsregisters nach Amtsgericht, HRB-Nummer, Stammkapital, Rechtsform und Geschäftsführern/Vorständen.
Live-Gegenprüfung mit den amtlichen Insolvenzbekanntmachungen, um Ausfallrisiken bei Neukunden im Onboarding sofort zu identifizieren.
2. Impressum Scraper (§ 5 DDG / ehemals TMG)
Automatisierte B2B-Lead-Anreicherung von Unternehmens-Domains:
Erkennt Impressum- und Kontaktseiten deutscher, österreichischer und Schweizer Firmenwebsites.
Extrahiert verifizierte Vertretungsberechtigte (Geschäftsführer, Inhaber), E-Mail-Adressen, Telefonnummern im E.164-Format, USt-IdNr. (DE/ATU/CHE) und Handelsregister-Aktenzeichen.
3. ZVG Zwangsversteigerungen API (zvg-portal.de)
Entwickelt für PropTechs, Family Offices und Immobilien-Investoren:
Flächendeckendes Scraping aller 16 Bundesländer für anstehende Versteigerungstermine.
Strukturierte Extraktion von Verkehrswert in Euro (Fließkommazahl), Objekttyp, Aktenzeichen, Gericht und direkten Download-Links zu den amtlichen Gutachten-PDFs.
4. Öffentliche Ausschreibungen API (service.bund.de)
Automatisches Vergabemonitoring für Vertriebsteams und Berater:
Überwacht öffentliche Ausschreibungen nach CPV-Codes, Schlagwörtern (Cloud, Software, KI, Bau) und Bundesländern.
Liefert Fristen, Vergabestellen und direkte Links zu den Vergabeplattformen (eVergabe, Deutsche eVergabe).
5. ZUGFeRD & XRechnung API (E-Rechnung 2025/2026)
Vollständige Konformität mit der gesetzlichen E-Rechnungspflicht ab 2025:
Erzeugung rechtskonformer ZUGFeRD 2.2 / Factur-X / XRechnung 3.0 PDF/A-3 Rechnungen aus JSON.
Validierung eingehender XML-Rechnungen gegen offizielle KoSIT Schematron- und EN 16931-Validierungsregeln.
🔒 Security & Privacy Notice
This open-source repository contains our standalone Python MCP server (
src/german_b2b_mcp/server.py),Dockerfile, integration blueprints, and curated samples—with NO private API keys or proprietary scraper internals.All underlying scraping, Handelsregister XJustiz XML parsing, and ZUGFeRD/XRechnung PDF/A-3 generation backends run securely as isolated cloud microservices on Apify Cloud (invoked via
APIFY_TOKENusingAuthorization: Bearerheaders).Always adhere to local data protection laws (GDPR / DSGVO) when storing and processing business contact information.
📄 License
This open-source suite and integration blueprints are distributed under the MIT License.
Available Tools
6 toolscheck_german_company_kybC
Run a German KYB audit against official Handelsregister (XJustiz) and Insolvenzbekanntmachungen.
Inputs: city, companies, company_name, register_type, +4 more. Returns: object
enrich_german_impressumA
Extract § 5 DDG / Impressum legal data, CEOs, de-obfuscated emails, phones, HRB & VAT IDs from DACH domains.
Inputs: url, domains, max_concurrency, extract_contact_page. Returns: object
find_german_b2b_leadsC
Search German B2B companies, crafts (Handwerker), and local businesses via 11880 & Gelbe Seiten.
Inputs: query, location, locations, max_items, +4 more. Returns: object
process_german_einvoiceB
Generate PDF/A-3 invoices, embed ZUGFeRD/Factur-X XML, or validate/extract XRechnung 3.0 & EN 16931 e-invoices.
Inputs: profile, xml_url, file_url, operation, +3 more. Returns: object
search_german_public_tendersC
Search official German public procurement tenders (Ausschreibungen) on service.bund.de.
Inputs: city, states, keywords, max_items, +2 more. Returns: object
search_german_zvg_foreclosuresC
Search German real estate foreclosure auctions (Zwangsversteigerungen) on zvg-portal.de.
Inputs: city, states, max_items, postal_code, +6 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool targets a clearly distinct resource and action: lead discovery, Impressum enrichment, KYB audit, public tenders, foreclosure auctions, and e-invoicing. The three company-related tools (find, enrich, check) are separated by description into search vs. extraction vs. registry verification, which is enough to prevent misselection. The only mild multi-purpose tool is process_german_einvoice, but its domain is unmistakable.
All six names follow a strict verb_noun pattern in snake_case (find_, enrich_, check_, search_, search_, process_) with a consistent german_ scope qualifier. The two search_ tools are parallel and predictable. No mixed conventions or camelCase leakage.
Six tools is well within the ideal 3-15 range and each one maps to a distinct data source or deliverable, so none feels redundant. The surface is compact for a multi-source German B2B suite. The only slight density issue is that process_german_einvoice compresses three operations into one tool.
The surface covers discovery, enrichment, compliance verification, procurement, foreclosure, and invoicing end-to-end with no obvious dead end in the core lead-to-invoice workflow. Minor gaps exist: no standalone company-detail/registry lookup, no bulk or async job-result retrieval for audits, and process_german_einvoice conflates generate, embed, and validate rather than offering separate operations.
Maintenance
Related MCP Connectors
KVK Handelsregister AI Connect: hosted MCP server for the Dutch business register.
German/EU e-invoices, IBAN/VAT/BaFin checks, tenders, hiring signals and more via Apify
MCP server for real-estate agents: listings, CRM, German market data and AI media tools.
TED MCP Server: Real-time EU public tenders access. https://www.lexsocket.ai/
Related MCP Servers
- AlicenseAqualityCmaintenanceMCP server for German public procurement data (OCDS). Semantic search, tender matching, and company profiles — all from your local LLM105MIT
- AlicenseAqualityDmaintenanceMCP server for EU company and business data. 9 tools: company search (GLEIF, 2M+ entities), LEI lookup, corporate structures (parent/subsidiaries), trade register search, EU VAT validation (VIES), GDP, unemployment, inflation, and business demography (Eurostat). All APIs free, no keys required.96MIT
- FlicenseBqualityDmaintenanceMCP server for DACH accounting automation. Connect AI assistants to sevDesk and Lexoffice — create invoices, manage contacts, handle bookings and vouchers for German-speaking businesses.1559 npm-
- AlicenseAqualityDmaintenanceMCP server for DACH e-invoicing. Create XRechnung (UBL) and ZUGFeRD 2.3 (Factur-X CII) invoices, validate against EN 16931 rules, extract data from XML, and convert between UBL, CII and JSON formats.661 npm2MIT