Skip to main content
Glama
README.md
<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

[![Apify Store](https://img.shields.io/badge/Apify%20Store-Live%20Actors-FF7626?style=for-the-badge&logo=apify&logoColor=white)](https://apify.com/AGrunert)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg?style=for-the-badge)](LICENSE)
[![MCP Protocol](https://img.shields.io/badge/MCP-Ready%20for%20Agents-8A2BE2?style=for-the-badge&logo=anthropic&logoColor=white)](https://modelcontextprotocol.io/)
[![n8n Certified](https://img.shields.io/badge/n8n-Ready%20Workflows-EA4B71?style=for-the-badge&logo=n8n&logoColor=white)](workflows/n8n_dach_b2b_lead_to_kyb_pipeline.json)
[![Make.com Certified](https://img.shields.io/badge/Make.com-Blueprints-6D28D9?style=for-the-badge&logo=make&logoColor=white)](workflows/make_com_dach_b2b_blueprint.json)
[![npm version](https://img.shields.io/npm/v/n8n-nodes-german-b2b.svg?style=for-the-badge&logo=npm)](https://www.npmjs.com/package/n8n-nodes-german-b2b)
[![RapidAPI](https://img.shields.io/badge/RapidAPI-OpenAPI%203.0-0055FF?style=for-the-badge&logo=rapidapi&logoColor=white)](rapidapi/00_unified_german_b2b_suite_openapi.json)
[![Smithery](https://img.shields.io/badge/Smithery-MCP%20Indexed-FF5722?style=for-the-badge)](smithery.yaml)
[![Glama](https://img.shields.io/badge/Glama-MCP%20Directory-00C853?style=for-the-badge)](glama.json)
[![Compliance: EN 16931 & § 5 DDG](https://img.shields.io/badge/Compliance-EN%2016931%20%7C%20§%205%20DDG%20%7C%20XJustiz-009688?style=for-the-badge)](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)

[![Watch German B2B Data Suite Live Video Showcase](https://raw.githubusercontent.com/andregrunert-ctrl/german-b2b-data-suite/main/docs/b2b_showcase_banner.png)](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

A3.5/5.0

Scored across 6 tools

Disambiguation5/5

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.

Naming Consistency5/5

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.

Tool Count5/5

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.

Completeness4/5

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

ActivityMaintained
ResponsivenessNo recent community issues