This Kompass scraper tutorial shows how to turn approved Kompass Germany detail-page URLs into a reviewable CSV with the Kompass Leads Scraper for Germany template for UScraper. You will prepare inputs, import the workflow, set the export path, validate lead fields, and decide when an official data/API route is a better fit.
Prerequisites
Before you scrape Kompass Germany leads
You need UScraper installed as a local desktop app, the maintained template from the UScraper template library, a folder for CSV exports, and a short list of Kompass Germany company detail-page URLs. This workflow is not a broad search crawler. It is built for a controlled list of detail pages such as https://de.kompass.com/c/.../.../.
Open several target pages manually first. Check whether the company name, address, telephone, fax, website, membership badge, and description are visible in your browser session. The official Kompass Germany business directory is useful for discovery, while Kompass also offers business data and CRM/API solutions for teams that need a licensed data feed instead of page-level extraction.
Treat compliance as part of the runbook. Do not bypass access controls, do not automate private or login-only information without permission, keep batches modest, and document why your team is allowed to collect and use each field.
Workflow
How the Kompass Germany leads scraper works
The JSON export is the authoritative workflow definition. The graph uses a multi-URL detail-page loop: set the browser window size, navigate to each URL, wait for load, pause briefly, run a small interaction script, export structured fields, then continue to the next input URL.
Set Window Size -> Navigate -> Wait for Page Load -> Sleep
-> Inject JavaScript -> Sleep -> Structured Export -> Loop Continue
The interaction step looks for German and English contact words such as telefon, fax, kontakt, anzeigen, and nummer, then clicks matching buttons or links when they do not point to an external URL. This is a convenience step for visible contact panels, not a permission bypass. If Kompass shows a DataDome, CAPTCHA, consent, or blocked-access page, stop and resolve access through an approved browser session before trusting the export.
What the CSV export contains
No CSV sample ships with this bundle, so the export block and your first validation run are the practical source of truth. The Structured Export block writes one row per visited detail page, includes headers, and uses append mode so multiple URLs land in the same spreadsheet.
kompass-leads-scraper.csvColumn
Name_des_Unternehmens
Company name from schema, company-name selectors, or the page heading.
Column
Adresse
Street, postal code, locality, and region when published on the detail page.
Column
Land
Country from structured data or visible country text.
Column
Fax
Visible fax link or fax-like text pattern.
Column
Offizielle_Website
Official website link excluding Kompass, CAPTCHA, search, and social domains.
Column
Kompass_ID
Kompass identifier parsed from the URL or page text.
Column
Kompass_Mitglied_seit
Visible membership duration text when present.
Column
Name_der_Mitgliedschaft
Membership label such as Booster, Premium, Basic, or similar visible text.
Column
URL_der_Mitgliedschaft
Membership-related URL when found.
Column
Telefon
Visible telephone link or phone-like text pattern.
Column
Produkt_image_1
First Kompass-hosted product image URL.
Column
Firmenkurzbeschreibung
Company description from structured data, description fields, or activity text.
Column
Input_url
The exact detail-page URL visited by the run.
The relevant export settings look like this:
{
"rowSelector": "body",
"fileName": "kompass-leads-scraper.csv",
"includeHeaders": true,
"fileMode": "append",
"columns": [
"Name_des_Unternehmens",
"Adresse",
"Land",
"Fax",
"Offizielle_Website",
"Kompass_ID",
"Telefon",
"Firmenkurzbeschreibung",
"Input_url"
]
}
Runbook
How to scrape Kompass leads to CSV
Prepare approved detail URLs
Build a short list of Kompass Germany company pages that your team is allowed to review. Open each URL manually and remove redirects, blocked pages, or irrelevant countries before automation.
Import the template
Open the Kompass Leads Scraper for Germany template, download the JSON workflow, and import it into UScraper.
Replace the Navigate list
In the Navigate block, replace the bundled sample URLs with your approved detail-page URLs. Keep the wait and sleep blocks unchanged for the first validation run.
Set the export path
In Structured Export, change the save folder to your project location. Keep headers on, keep append mode for a combined CSV, and use a dated folder when separating tests from production runs.
Run a small batch
Run three to ten URLs first. Open the CSV, compare every populated field with the source page, and note whether blanks are expected or caused by access, timing, or selector drift.
Scale only after validation
Increase the URL list only after company identity, address, telephone, website, and input URL match the browser view. Keep a copy of the original URL list for auditability.
Append mode is useful for one combined lead file, but it can also mix test rows with production rows. Before a client or sales run, either clear the previous CSV or write to a fresh folder such as kompass-germany-leads-2026-06-25.
Kompass API vs scraper: which should you use?
Use this tutorial when you need a supervised research file from selected company pages and want to inspect the workflow yourself. Use Kompass data products, a CRM/API agreement, or a managed provider when you need contractual data rights, support, service-level expectations, or a repeatable integration your sales systems depend on.
| Option | Better fit | Tradeoff |
|---|---|---|
| UScraper template | Local CSV exports from a controlled list of detail URLs | Requires validation and maintenance if the site layout changes. |
| Kompass API or licensed data | Contracted enrichment, CRM sync, and governed data usage | Usually requires vendor terms, pricing, and integration work. |
| Octoparse or Apify | Hosted templates, cloud runs, API-triggered actors, or team scheduling | Data custody, pricing model, and maintenance model differ from local export. |
| Managed data service | Outsourced list building or one-off datasets | Less transparent workflow and more vendor dependency. |
If you are comparing an Octoparse Kompass alternative or an Apify Kompass actor, focus on where the run happens, how the data is stored, how failures are debugged, and whether your team needs an API endpoint or just a local CSV for review.
Troubleshooting
Common Kompass scraper issues
Blank cells often mean the profile does not publish the value, contact details are behind an interaction, the reveal click did not fire, or the browser session loaded a consent or blocked-access page. Compare the CSV with the live browser before changing selectors.
FAQ
Is it legal to scrape Kompass Germany leads?
Kompass pages can include public business information, but automated collection may still be restricted by site terms, robots guidance, database rights, privacy law, and outreach rules. Review the current rules, collect only what you need, avoid access-control bypass, and get legal advice before commercial reuse.
Do I need the Kompass API instead of a scraper?
Use an official API, licensed data product, or vendor agreement when you need a contracted data source, documented reuse rights, support, and integration guarantees. Use a scraper for supervised page-level research where a reviewable CSV is enough.
What does the Kompass Germany leads scraper export?
The workflow exports company name, address, country, fax, official website, Kompass ID, membership fields, telephone, product image URLs, short company description, and the input URL to kompass-leads-scraper.csv.
Why are some Kompass lead fields blank?
Blank fields are normal when a company does not publish a value, the field loads late, a consent or challenge screen appears, or Kompass changes its page structure. Validate a small batch and adjust the workflow only after comparing against the browser.
Is UScraper an Octoparse or Apify alternative for Kompass?
UScraper is a practical option when you want an inspectable local desktop app workflow and a CSV saved locally. Octoparse, Apify, Thunderbit, Spider, Scrapebit, and managed services can fit better when you want hosted scheduling, API runs, or vendor-managed data delivery.