🇩🇪 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).
🏛️ 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 | German E-Invoice Suite (🎥 Watch 45s Live Demo) | 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 | German Company KYB & Insolvency | 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 | German Foreclosures (ZVG-Portal) | 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 | German Public Tenders (Bund.de) | 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 | German Impressum & Contact Enricher | 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 | German B2B Leads & Directory Scraper | 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-german-e-invoice-sample |
Generate compliant DIN 5008 / EN 16931 PDF/A-3 invoice | Run Task |
| ZUGFeRD | validate-extract-e-invoice |
Inspect incoming invoice PDF/XML against official Schematron rules | Run Task |
| KYB | full-kyb-audit |
Complete audit of directors, share capital & insolvency status | Run Task |
| KYB | fast-insolvency-screener |
Rapid screening against official insolvency announcements | Run Task |
| KYB | bulk-kyb-batch-check |
Batch verification of multi-company lists in a single run | Run Task |
| ZVG | german-foreclosures-sample-search |
Search next 20 foreclosure auctions with valuations & court locations | Run Task |
| ZVG | high-value-commercial-residential-foreclosures |
Target foreclosures with court-assessed value > 250,000 EUR + PDF reports | Run Task |
| Tenders | german-it-software-public-tenders |
Search open federal & municipal contracts for IT, Cloud, Software & AI | Run Task |
| Tenders | german-construction-facility-tenders |
Monitor public construction (VOB/A), infrastructure & facility management | Run Task |
| Impressum | german-b2b-impressum-contact-extractor |
Extract CEOs, direct emails, phone & HRB from target domains | Run Task |
| Impressum | impressum-to-handelsregister-kyb-enricher |
Enrich corporate websites with register filings and VAT IDs (DE, ATU, CHE) | Run Task |
| Leads | german-crafts-trades-lead-finder |
Extract craftsmen, electrical, solar & construction trades with phone | Run Task |
| Leads | german-b2b-domains-for-impressum-enrichment |
Discover German B2B companies with require_website: true |
Run Task |
🤖 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 |
|---|---|---|
find_german_b2b_leads |
AGrunert/german-b2b-leads-directory-scraper |
Gelbe Seiten & 11880 B2B/craft leads + E.164 phone + domains |
enrich_german_impressum |
AGrunert/german-impressum-b2b-lead-enricher |
§ 5 DDG CEOs, emails, phones, HRB court & VAT IDs |
check_german_company_kyb |
AGrunert/german-company-kyb-insolvency-scraper |
Handelsregister (XJustiz) & Insolvenzbekanntmachungen audit |
search_german_public_tenders |
AGrunert/german-public-tenders-vergabe-scraper |
service.bund.de tenders, CPV codes & deadlines |
search_german_zvg_foreclosures |
AGrunert/german-real-estate-foreclosure-zvg-scraper |
zvg-portal.de foreclosure auctions & Gutachten PDF URLs |
process_german_einvoice |
AGrunert/german-e-invoice-zugferd-xrechnung-suite |
ZUGFeRD 2.2 / Factur-X / XRechnung 3.0 generation & validation |
1. Run via PyPI (pip / uvx) — Recommended for Claude, Cursor, Glama & Smithery
pip install german-b2b-mcp
export APIFY_TOKEN="YOUR_APIFY_TOKEN" # Free token ($5/mo credits): https://console.apify.com/account/integrations
german-b2b-mcp
Or run zero-install via uvx in %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": "uvx",
"args": ["german-b2b-mcp"],
"env": {
"APIFY_TOKEN": "YOUR_APIFY_TOKEN"
}
}
}
}
Or run from source after cloning:
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.server
2. Run via Docker (stdio)
docker build -t german-b2b-mcp .
docker run -i --rm -e APIFY_TOKEN="YOUR_APIFY_TOKEN" german-b2b-mcp
Or 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_TOKEN
Sample 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-b2b
Or 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.json - Dedicated 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.py
Node.js (Modern ESM Fetch)
export APIFY_TOKEN="your_token_here"
node examples/run_suite_node.mjs
1-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 with live Gumroad & Apify links)
- 📄 Download 50-Item JSON Payload (Includes
_meta_full_dataset_downloadpointer) - 📝 Full 2,965+ Records Guide (
00_GET_FULL_2965_RECORDS.txt) - 🤗 Hugging Face Hub Dataset (50-Item live sample preview)
- 📊 Kaggle Datasets Hub (Data explorer & kernels ready)
- Full Nationwide Master Dataset (2,965+ Active Auctions) & Live Services:
- 🛒 Instant Gumroad Download: Get Full Nationwide Master Dataset (2,965+ Active Auctions, .XLSX, .CSV, .JSON, HTML Explorer & PDF Downloader) 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)
- 📄 Download 50-Company JSON Payload (.JSON)
- 🤗 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.
Metadata
Release files for german-b2b-mcp 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| german_b2b_mcp-0.1.0.tar.gz | 31.5 kB | Without provenance | Details for german_b2b_mcp-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| german_b2b_mcp-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for german_b2b_mcp-0.1.0-py3-none-any.whl |
Total release size: 49.0 kB
Release files / german_b2b_mcp-0.1.0.tar.gz
| Download URL | german_b2b_mcp-0.1.0.tar.gz |
|---|---|
| Size | 31.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
69b4b962dcf7986eef580a74f021efab75d7fcbc6bad81411a4bb47982de278b
|
|
BLAKE2b-256 checksum How to use checksums |
981ed701f52e04dcc9eca72c87bd050d8222f6026f517079843b31faf1ecb127
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.6
|
Release files / german_b2b_mcp-0.1.0-py3-none-any.whl
| Download URL | german_b2b_mcp-0.1.0-py3-none-any.whl |
|---|---|
| Size | 17.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
780d3b9c1e58fdf8fb0d333a62008fce4f6ac8df694168cd12af9561a54c89c6
|
|
BLAKE2b-256 checksum How to use checksums |
94d95e1c3e8a3bd6e22cc67f7f9c6ea6f6d6ca1804c9ec65c588bb62682d02aa
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.14.6
|
Security for german-b2b-mcp 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.