🏗️🏢 German B2B Leads, Crafts & Business Directory Scraper

The ultimate top-of-funnel B2B lead generator for Germany. Scrapes local businesses, craftsmen, corporate service providers, and trades across any industry or German city/postal code in seconds.

Extracts structured company records including verified company name, trade category, full postal address, standardized telephone, direct email, customer ratings, and the cleaned target company website domain (website / domain) — directly compatible as the primary feed for our German Impressum Enricher (Actor #5) and German KYB Handelsregister Scraper (Actor #2)!

---

🎥 48-Second Live Video Showcase (1080p HD)

Part of the official German B2B Data Suite: Automate B2B lead generation, GDPR-compliant impressum enrichment (§ 5 DDG), real-time Handelsregister (XJustiz) & insolvency KYB audits, ZVG foreclosures, and public tenders via Apify, n8n, Make.com, or AI Agents (MCP).

---

⚡ Key Highlights & Architecture

• High-Speed Multi-Source Engine: Queries Germany's leading commercial directories (Gelbe Seiten & 11880) concurrently via high-speed httpx async HTTP clients and lxml DOM parsers — Zero-Playwright / Zero-Puppeteer for lightning-fast runs and minimal compute overhead.
• Instant Website & Domain Decoding: Extracts real corporate websites directly from directory payloads without following ad-trackers, redirects, or consent walls. Directory and aggregator domains are automatically blacklisted.
• Smart German PLZ-to-State Mapping: Maps 5-digit German postal codes (PLZ) deterministically to their federal state (Bundesland, e.g. Bayern, Sachsen, Nordrhein-Westfalen).
• Strict Pay-Per-Event Pricing ($0.008 / lead): You only pay for valid, successfully extracted leads that match your criteria. If an input query returns no results or fails validation, $0.00 is charged.
• Downstream Integration Filters:
  • require_website: true: Filters strictly for companies with an owned website domain — perfect for feeding directly into Impressum enrichment pipelines.
  • require_phone: true: Filters strictly for leads with telephone numbers for immediate tele-sales.
  • include_details: true: Deep-crawls directory detail pages to uncover direct business emails and extended service descriptions.
• Summary Key-Value Store Export: Produces LEADS_SUMMARY.json containing a ready-to-copy domains array formatted specifically for Actor #5.

---

🎯 Ideal Use Cases

1. B2B Cold Outreach & Account-Based Marketing (ABM): Build targeted lists of German SMBs, craftsmen, solar installers, IT agencies, or tax advisors.
2. Local Sales & Agency Lead Generation: Find service businesses in specific cities (München, Berlin, Hamburg, Leipzig) or 5-digit postal code clusters.
3. Automated Impressum & KYB Pipeline: Automatically feed discovered domains into our German Impressum Enricher to extract CEOs, HRB numbers, and VAT IDs, followed by insolvency audits in our KYB Actor.
4. Market & Industry Research: Analyze local business density, trade specialties, and review ratings across Germany.

---

📥 Input Parameters

Parameter	Type	Default	Description
search_terms	array	["Elektroinstallation", "Solaranlagen"]	List of trades, professions, products, or industry keywords (e.g. ["Steuerberater", "Dachdecker"]).
locations	array	["München", "Leipzig"]	German cities, regions, or 5-digit postal codes (e.g. ["Berlin", "80331"]).
query	string	null	Single search term alternative for simple integrations.
location	string	null	Single location alternative.
require_website	boolean	false	If true, only leads with a verified company domain are returned and charged.
require_phone	boolean	false	If true, only leads with a verified telephone number are returned and charged.
include_details	boolean	true	Visits directory detail pages to extract additional direct corporate emails, descriptions, and extended contact channels.
max_items	integer	50	Maximum total leads to extract and charge (strict budget limit, 1 to 5,000).
proxyConfiguration	object	null	Optional Apify proxy configuration for enterprise-scale runs.

Example Input (input.json)

{
  "search_terms": [
    "Elektroinstallation",
    "Solaranlagen"
  ],
  "locations": [
    "München"
  ],
  "require_website": true,
  "require_phone": true,
  "include_details": true,
  "max_items": 25
}

---

📤 Output Dataset Schema

Each lead is pushed directly to the default dataset:

{
  "lead_id": "5c8c87af38ac8840",
  "company_name": "Bleumortier Elektro GmbH",
  "category": "Elektroinstallation",
  "industries": [
    "Elektroinstallation"
  ],
  "website": "https://www.elektro-bleumortier.de/",
  "domain": "elektro-bleumortier.de",
  "phone": "089 22 31 11",
  "street": "Ledererstr. 17",
  "postal_code": "80331",
  "city": "München",
  "state": "Bayern",
  "country": "DE",
  "rating_value": 5,
  "review_count": 1,
  "description": "Ihr zuverlässiger Elektriker Meisterbetrieb für München. Elektro Bleumortier GmbH ist seit 1933 ihr kompetenter und zuverlässiger Meisterbetrieb...",
  "search_term": "Elektroinstallation",
  "search_location": "München",
  "source": "gelbeseiten",
  "source_url": "https://www.gelbeseiten.de/gsbiz/97e88b26-8d5c-4230-b4e8-6eeb190f88ef",
  "scraped_at": "2026-10-29T07:23:42.361965+00:00"
}

Realistic Field Coverage & Enrichment Pipeline

Field	Typical Coverage	Source & Availability
company_name	100%	Directory listing title with legal form protection
street, postal_code, city	~98%	German address with verified 5-digit PLZ
state	~99%	Deterministic German Bundesland mapping from PLZ
phone	~90%	Standardized German telephone number (auto-decoded Base64 data-prg)
website & domain	~85%	De-obfuscated clean company website (excluding directory tracking links)
rating_value & review_count	~20%	Genuine customer feedback scores from directory
email	~5-15%	Direct business email when published on 11880 JSON-LD. (Note: Gelbe Seiten does not publicly expose raw email addresses to prevent spam. For 100% email & management contact coverage, pipe the extracted domain into our German Impressum Enricher Actor #5!)

---

🔒 Strict Pay-Per-Event (PPE) Guarantee ($0.008 / Lead)

• Charged strictly at $0.008 USD per valid extracted lead (event_name: "lead-scraped").
• If require_website: true or require_phone: true is enabled, records missing those fields are never charged ($0.00).
• Budget Cap: Scraping stops immediately once max_items is reached.
• Empty or invalid inputs trigger an immediate zero-cost error exit.

---

🤖 AI Agents (MCP), n8n & Make.com Integrations

1. Model Context Protocol (MCP) for Claude Desktop & Cursor AI

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "apify-german-b2b-leads": {
      "command": "npx",
      "args": [
        "-y",
        "@apify/actors-mcp-server",
        "--actors",
        "AGrunert/german-b2b-leads-directory-scraper"
      ],
      "env": {
        "APIFY_TOKEN": "YOUR_APIFY_TOKEN"
      }
    }
  }
}

2. 1-Click Synchronous API (cURL, n8n, Make.com)

curl -X POST "https://api.apify.com/v2/acts/AGrunert~german-b2b-leads-directory-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"search_terms":["Elektroinstallation"],"locations":["München"],"require_website":true,"max_items":10}'

3. Pre-Built Workflow Templates in Repository (integrations/)

• integrations/n8n_workflow.json: Automated 3-step pipeline chaining Actor #6 (Lead Finder) $\rightarrow$ Actor #5 (Impressum Enricher) $\rightarrow$ Actor #2 (KYB Handelsregister).
• integrations/make_com_blueprint.json: Official Make.com blueprint to scrape leads and pipe domains into your CRM or Google Sheets.
• integrations/mcp_claude_cursor_config.json: Manifest for Claude Desktop and Cursor AI.

---

🔗 Complete German B2B, Compliance & PropTech Suite by AGrunert

Combine our specialized German business actors to build end-to-end automated pipelines for B2B lead generation, corporate due diligence, public procurement, real estate intelligence, and tax-compliant e-invoicing:

Actor	Category & Pricing	Key Capabilities	Preconfigured Public Tasks
German B2B Leads, Crafts & Business Directory Scraper (Current Actor)	Lead Generation $0.008 / lead ($8.00 / 1k)	Multi-query round-robin extraction across German business directories (11880, Gelbe Seiten), verified E.164 phone numbers (97.5% coverage), and domain verification (require_website: true).	• German Crafts, Solar & Construction Lead Finder • German B2B Company & Domain Finder
German & DACH B2B Impressum, Contact & Legal Enricher (§ 5 DDG)	Data Enrichment $0.005 / domain ($5.00 / 1k)	Automatic legal notice discovery (§ 5 DDG / § 25 MedienG), de-obfuscation of executive emails, management board/CEOs, court & registration number (HRB), VAT ID (DE...), and social profiles.	• German B2B Impressum, CEO & Contact Extractor • DACH Website to Handelsregister & VAT ID Enricher
German Company KYB, Handelsregister & Insolvency Scraper	Risk & Compliance $0.025 / check ($25.00 / 1k)	Official XJustiz 3.5.1 extraction (directors, share capital, business purpose, court) + live insolvency check (insolvenzbekanntmachungen.de) with bulk company list support.	• Complete German KYB Audit • Fast German Insolvency Screener • Bulk German Company KYB Batch Check
German Public Tenders & Procurement Scraper (service.bund.de)	B2B Tenders & Contracts $0.010 / tender ($10.00 / 1k)	Daily procurement monitoring across Bund, Länder & Kommunen; zero false positives (filters AI Bietercockpit boilerplates); direct /unterlagen/ download URLs and submission deadlines (date + time).	• German IT, Software & AI Public Tenders Monitor • German Construction & Facility Management Tenders
German Real Estate Foreclosure & ZVG-Portal Scraper	PropTech & Real Estate $0.010 / property ($10.00 / 1k)	Bulk extraction of foreclosure auctions (zvg-portal.de) across all 16 states, multi-parcel market value parser (float), and direct PDF appraisal links (Verkehrswertgutachten).	• German Foreclosure Real Estate Finder • High-Value German Foreclosures (> 250k EUR)
German E-Invoice (ZUGFeRD / Factur-X / XRechnung 3.0) Suite	Finance & Invoicing $0.035 / invoice ($35.00 / 1k)	Generate DIN-5008 compliant PDF/A-3 invoices from JSON, embed CII XML, and validate with official KoSIT Schematron & EN 16931 rules.	Standalone API & Batch Suite

💡 Multi-Actor Chain Workflows & Synergy Pipelines

• Pipeline 1 (Top-of-Funnel Lead-to-Audit Engine):
  Discover companies & crafts via German B2B Directory Scraper $\rightarrow$ Enrich managing directors, direct emails, and HRB numbers via German Impressum Enricher $\rightarrow$ Verify solvency, officers, and share capital via German KYB Scraper.
• Pipeline 2 (Public Tender Win to Compliant Billing):
  Monitor federal procurement opportunities via German Public Tenders Scraper $\rightarrow$ Win bid $\rightarrow$ Bill public authorities with compliant EN 16931 XRechnung 3.0 via German E-Invoice Suite.
• Pipeline 3 (Real Estate Foreclosure Due Diligence):
  Scrape upcoming foreclosures via German Real Estate Foreclosure Scraper $\rightarrow$ Check creditor/owner companies via German KYB Scraper.

---

💡 Multi-Actor Synergy: Top-of-Funnel Lead Gen to Insolvency Audit

flowchart LR
    A["Actor #6: B2B Leads Scraper<br>Query 'Elektroinstallation München'<br>(require_website: true)"] --> B["Actor #5: German Impressum Enricher<br>Feed extracted domains<br>Extract CEO, HRB & Amtsgericht"]
    B --> C["Actor #2: German KYB Scraper<br>Verify official register &<br>live insolvency status"]
    C --> D["Qualified B2B Leads in CRM:<br>CEO, Direct Email, Phone,<br>Verified Capital & Active Solvency"]