Skip to main content

🇩🇪 DACH & German B2B Data, Compliance & PropTech API Suite

Official Open-Source Integration Hub for Apify Actors, AI Agents (MCP), n8n & Make.com

Apify Store PyPI version License: MIT MCP Protocol n8n Certified Make.com Certified npm version RapidAPI Smithery Glama Compliance: EN 16931 & § 5 DDG


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)

Watch German B2B Data Suite Live Video Showcase

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
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/:


🌐 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/:

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:


💻 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)

🏢 German Handelsregister & KYB Master Sample (50 Verified Companies)


📊 Live Sample Datasets

Explore real sample outputs in samples/ formatted as JSON, CSV, and Excel:


🇩🇪 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_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.

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)

Source distribution for german-b2b-mcp 0.1.0
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)

Table of built distributions (wheels) for german-b2b-mcp 0.1.0
File Interpreter ABI Platform Actions
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.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page