Skip to main content
Glama

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

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

Apify Store 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).


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

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 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.server

Add 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-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.

Available Tools

6 tools
check_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

    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

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      MCP 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.
      9
      6
      MIT
    • F
      license
      B
      quality
      D
      maintenance
      MCP server for DACH accounting automation. Connect AI assistants to sevDesk and Lexoffice — create invoices, manage contacts, handle bookings and vouchers for German-speaking businesses.
      15
      59 npm
      -
    • A
      license
      A
      quality
      D
      maintenance
      MCP 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.
      6
      61 npm
      2
      MIT