german-b2b-data-suite
<div align="center">
# 🇩🇪 DACH & German B2B Data, Compliance & PropTech API Suite
### Official Open-Source Integration Hub for Apify Actors, AI Agents (MCP), n8n & Make.com
[](https://apify.com/AGrunert)
[](LICENSE)
[](https://modelcontextprotocol.io/)
[](workflows/n8n_dach_b2b_lead_to_kyb_pipeline.json)
[](workflows/make_com_dach_b2b_blueprint.json)
[](https://www.npmjs.com/package/n8n-nodes-german-b2b)
[](rapidapi/00_unified_german_b2b_suite_openapi.json)
[](smithery.yaml)
[](glama.json)
[](https://apify.com/AGrunert)
<br/>
**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](#overview) • [The 6 Actors](#the-6-specialized-actors) • [Public Tasks](#13-turnkey-public-tasks) • [AI Agent Setup (MCP)](#ai-agent--mcp-setup-claude-cursor-windsurf) • [Workflow Automation](#workflow-automation-n8n--makecom) • [Quickstart Code](#code-quickstarts) • [Deutsche Dokumentation](#-deutsche-dokumentation--b2b-use-cases)
</div>
---
## 🎥 48-Second Live Video Showcase (1080p HD)
[](https://youtu.be/ERydgz1hGk8)
*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:
```mermaid
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**](https://apify.com/AGrunert/german-e-invoice-zugferd-xrechnung-suite) *(🎥 [Watch 45s Live Demo](https://youtu.be/xkDNnPjQxRo))* | 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**](https://apify.com/AGrunert/german-company-kyb-insolvency-scraper) | 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)**](https://apify.com/AGrunert/german-real-estate-foreclosure-zvg-scraper) | 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)**](https://apify.com/AGrunert/german-public-tenders-vergabe-scraper) | 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**](https://apify.com/AGrunert/german-impressum-b2b-lead-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**](https://apify.com/AGrunert/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](https://console.apify.com/actors/tasks/AGrunert~generate-german-e-invoice-sample) |
| **ZUGFeRD** | `validate-extract-e-invoice` | Inspect incoming invoice PDF/XML against official Schematron rules | [Run Task](https://console.apify.com/actors/tasks/AGrunert~validate-extract-e-invoice) |
| **KYB** | `full-kyb-audit` | Complete audit of directors, share capital & insolvency status | [Run Task](https://console.apify.com/actors/tasks/AGrunert~full-kyb-audit) |
| **KYB** | `fast-insolvency-screener` | Rapid screening against official insolvency announcements | [Run Task](https://console.apify.com/actors/tasks/AGrunert~fast-insolvency-screener) |
| **KYB** | `bulk-kyb-batch-check` | Batch verification of multi-company lists in a single run | [Run Task](https://console.apify.com/actors/tasks/AGrunert~bulk-kyb-batch-check) |
| **ZVG** | `german-foreclosures-sample-search` | Search next 20 foreclosure auctions with valuations & court locations | [Run Task](https://console.apify.com/actors/tasks/AGrunert~german-foreclosures-sample-search) |
| **ZVG** | `high-value-commercial-residential-foreclosures` | Target foreclosures with court-assessed value > 250,000 EUR + PDF reports | [Run Task](https://console.apify.com/actors/tasks/AGrunert~high-value-commercial-residential-foreclosures) |
| **Tenders** | `german-it-software-public-tenders` | Search open federal & municipal contracts for IT, Cloud, Software & AI | [Run Task](https://console.apify.com/actors/tasks/AGrunert~german-it-software-public-tenders) |
| **Tenders** | `german-construction-facility-tenders` | Monitor public construction (VOB/A), infrastructure & facility management | [Run Task](https://console.apify.com/actors/tasks/AGrunert~german-construction-facility-tenders) |
| **Impressum** | `german-b2b-impressum-contact-extractor` | Extract CEOs, direct emails, phone & HRB from target domains | [Run Task](https://console.apify.com/actors/tasks/AGrunert~german-b2b-impressum-contact-extractor) |
| **Impressum** | `impressum-to-handelsregister-kyb-enricher` | Enrich corporate websites with register filings and VAT IDs (DE, ATU, CHE) | [Run Task](https://console.apify.com/actors/tasks/AGrunert~impressum-to-handelsregister-kyb-enricher) |
| **Leads** | `german-crafts-trades-lead-finder` | Extract craftsmen, electrical, solar & construction trades with phone | [Run Task](https://console.apify.com/actors/tasks/AGrunert~german-crafts-trades-lead-finder) |
| **Leads** | `german-b2b-domains-for-impressum-enrichment` | Discover German B2B companies with `require_website: true` | [Run Task](https://console.apify.com/actors/tasks/AGrunert~german-b2b-domains-for-impressum-enrichment) |
---
## 🤖 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`](src/german_b2b_mcp/server.py)) built on the official Python `mcp` SDK (`stdio` transport) and containerized via [`Dockerfile`](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 Locally via Python (`pip`)
```bash
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
```
Add this to `%APPDATA%\Claude\claude_desktop_config.json` (Windows), `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS), or `.cursor/mcp.json`:
```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`)
```bash
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:
```json
{
"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:
```bash
# 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](https://github.com/andregrunert-ctrl/n8n-nodes-german-b2b)
👉 **npm Package:** [https://www.npmjs.com/package/n8n-nodes-german-b2b](https://www.npmjs.com/package/n8n-nodes-german-b2b)
---
### 📋 Ready-to-Use Workflow Blueprints
Ready-to-use blueprint files are available in [`workflows/`](workflows/):
- **n8n Pipeline:** [`workflows/n8n_dach_b2b_lead_to_kyb_pipeline.json`](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`](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/`](rapidapi/):
* **Unified Suite (All 6 Tools):** [`rapidapi/00_unified_german_b2b_suite_openapi.json`](rapidapi/00_unified_german_b2b_suite_openapi.json)
* **Dedicated Individual Specs:**
* `01_zugferd_openapi.json`
* `02_kyb_openapi.json`
* `03_zvg_openapi.json`
* `04_tenders_openapi.json`
* `05_impressum_openapi.json`
* `06_b2b_leads_openapi.json`
* **1-Minute Publish Guide:** [`rapidapi/RAPIDAPI_PUBLISH_GUIDE.md`](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`](Dockerfile) (`python:3.12-slim`), and verified registry manifests:
* **Glama.ai & PulseMCP:** [`glama.json`](glama.json) (schema-validated `maintainers` + Python `stdio` entrypoint)
* **Smithery.ai:** [`smithery.yaml`](smithery.yaml) (`runtime: "container"` using root [`Dockerfile`](Dockerfile))
* **Python Package:** [`pyproject.toml`](pyproject.toml) (`german-b2b-mcp`) & [`requirements.txt`](requirements.txt)
---
## 💻 Code Quickstarts
### Python (Sync REST Call)
```bash
pip install httpx
export APIFY_TOKEN="your_token_here"
python examples/run_suite_python.py
```
### Node.js (Modern ESM Fetch)
```bash
export APIFY_TOKEN="your_token_here"
node examples/run_suite_node.mjs
```
### 1-Click cURL
```bash
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.de` enforces anti-hotlinking security. Direct programmatic downloads require `Referer: 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)**](samples/DE_Zwangsversteigerungen_Sample_50.csv) *(RFC 4180 comma-delimited for Pandas, Kaggle & Hugging Face)*
- 📥 [**Download 50-Item SEO Sample (.XLSX)**](samples/DE_Zwangsversteigerungen_Sample_50.xlsx) *(Multi-sheet styled workbook)*
- 📄 [**Download 50-Item JSON Payload**](samples/DE_Zwangsversteigerungen_Sample_50.json)
- 🤗 [**Hugging Face Hub Dataset**](https://huggingface.co/datasets/AGrunert/german-real-estate-foreclosures-zvg-sample) *(50-Item live sample preview)*
- 📊 [**Kaggle Datasets Hub**](https://www.kaggle.com/datasets/andrgrunert/german-real-estate-foreclosures-zvg-sample) *(Data explorer & kernels ready)*
- **Full Nationwide Master Dataset & Live Services:**
- 🛒 **Instant Gumroad Download:** [**Get Full Nationwide Master Dataset (.XLSX & .CSV) on Gumroad**](https://grunertandre.gumroad.com/l/qklpqn)
- 💼 **Productized Fiverr Gigs:**
- 🏢 [**Fiverr Gig 1: German Real Estate Foreclosures (ZVG) in Excel**](https://de.fiverr.com/s/NeWDpEy)
- ⚖️ [**Fiverr Gig 2: German Companies KYB, Handelsregister & Insolvency Audit**](https://de.fiverr.com/s/yeWblEA)
- 📑 [**Fiverr Gig 3: ZUGFeRD 2.2 & XRechnung 3.0 E-Invoicing Conversion & Validation**](https://de.fiverr.com/s/1EKL0Z5)
- 🚀 **Apify Cloud Scraping Actor:** [**Apify ZVG Scraper Actor**](https://apify.com/AGrunert/german-real-estate-foreclosure-zvg-scraper) ($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.1 `SI` XML & `UT` filings) cross-checked against `insolvenzbekanntmachungen.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 `.xlsx` workbook 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)**](samples/DE_Handelsregister_KYB_Sample_50.csv) *(RFC 4180 comma-delimited for Pandas, Kaggle & Hugging Face)*
- 📥 [**Download 50-Company Showcase Table (`02_handelsregister_kyb_sample.csv`)**](samples/02_handelsregister_kyb_sample.csv) *(50-row drop-in showcase CSV)*
- 📥 [**Download 50-Company KYB Workbook (.XLSX)**](samples/DE_Handelsregister_KYB_Sample_50.xlsx) *(Multi-sheet styled Excel workbook)*
- 📄 [**Download 50-Company JSON Payload (.JSON)**](samples/DE_Handelsregister_KYB_Sample_50.json)
- 🤗 [**Hugging Face Hub Dataset**](https://huggingface.co/datasets/AGrunert/german-company-handelsregister-kyb-sample) *(Public 50-company live KYB sample)*
- 📊 [**Kaggle Datasets Hub**](https://www.kaggle.com/datasets/andrgrunert/german-company-handelsregister-kyb-sample) *(Data explorer & kernels ready)*
- **Automated Live KYB Checks & Custom Bulk Audits:**
- 🚀 **Apify Cloud KYB Actor:** [**German Company KYB & Insolvency Scraper**](https://apify.com/AGrunert/german-company-kyb-insolvency-scraper) ($0.015 / audit)
- 💼 **Custom Bulk Audit & Excel Delivery on Fiverr:** [**Order Bespoke German Handelsregister & KYB Audit**](https://www.fiverr.com/s/yeWblEA)
---
## 📊 Live Sample Datasets
Explore real sample outputs in [`samples/`](samples/) formatted as JSON, CSV, and Excel:
- 📄 [`samples/01_zugferd_xrechnung_sample.json`](samples/01_zugferd_xrechnung_sample.json) (EN 16931 PDF/A-3 & Schematron validation)
- 🏢 [`samples/02_handelsregister_kyb_sample.json`](samples/02_handelsregister_kyb_sample.json), [`.csv`](samples/02_handelsregister_kyb_sample.csv) & [**50-Company Styled `.xlsx`**](samples/DE_Handelsregister_KYB_Sample_50.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`](samples/03_zvg_foreclosures_sample.json) & [`.csv`](samples/03_zvg_foreclosures_sample.csv) (Foreclosures with EUR market values & PDF URLs)
- 🏛️ [`samples/04_public_tenders_sample.json`](samples/04_public_tenders_sample.json) & [`.csv`](samples/04_public_tenders_sample.csv) (Bund.de public procurement tenders & CPV codes)
- 🔍 [`samples/05_impressum_leads_sample.json`](samples/05_impressum_leads_sample.json) & [`.csv`](samples/05_impressum_leads_sample.csv) (§ 5 DDG CEOs, emails, phones, HRB & VAT IDs)
- 🔨 [`samples/06_b2b_crafts_directory_sample.json`](samples/06_b2b_crafts_directory_sample.json) & [`.csv`](samples/06_b2b_crafts_directory_sample.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`](src/german_b2b_mcp/server.py)), [`Dockerfile`](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](https://apify.com) (invoked via `APIFY_TOKEN` using `Authorization: Bearer` headers).
- 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](LICENSE).
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.