Telefonbuch Scraper: Firmendaten aus Das Telefonbuch als CSV oder Excel exportieren
Du brauchst Firmenadressen einer Branche in einer Stadt, mit Telefon, E-Mail und Website, als Tabelle? Der Scraper für Das Telefonbuch auf Apify holt sie von telefonbuch.de, ohne Code. Hier sind die Eingaben, der Export und ein echter Testlauf mit 15 Steuerberatern in Hamburg.
In diesem Tutorial
- Das bekommst du
- Schritt 1: Apify-Konto anlegen
- Schritt 2: Branche und Stadt
- Schritt 3: Actor starten
- Schritt 4: Daten exportieren
- Beispiel: Steuerberater in Hamburg
- Beispiel: Autowerkstätten in Frankfurt
- Beispiel: Steuerberater in Berlin
- Felder
- E-Mails und Anreicherung
- API und Schedule
- Prompt für Claude
- Kosten
- Anwendungen
- FAQ
- Datenschutz und Recht
Das bekommst du
Das Telefonbuch ist ein deutsches Verzeichnis für Firmen und Privatpersonen. Der Actor sucht dort nach Suchbegriff und Ort und legt jeden Treffer als Zeile in einer Tabelle ab. Pro Eintrag bekommst du:
- Name, Kategorie, Adresse mit Straße, PLZ und Stadt.
- Telefon, Fax und Website, soweit der Eintrag sie zeigt.
- E-Mail, wenn der Eintrag eine hat. Sie steht nur auf der Detailseite.
- Öffnungszeiten, Bewertungen und Suchbegriffe, wenn vorhanden.
Der Standard ist includeDetails: true: Der Actor öffnet dann die Detailseite jedes Eintrags. Ohne Detailseiten bekommst du nur die Felder aus der Trefferliste.
Apify-Konto anlegen
- Öffne die Seite des Scrapers für Das Telefonbuch auf Apify.
- Klicke auf Try for free und registriere dich mit Google oder E-Mail.
- Du landest in der Apify Console im Tab Input des Actors.
Branche und Stadt eintragen
{
"searchQuery": "Steuerberater",
"location": "Hamburg",
"searchType": "business",
"maxResults": 100,
"includeDetails": true
}searchQuery: Branche, Leistung oder Firmenname, zum Beispiel „Steuerberater“, „Zahnarzt“ oder „Restaurant“.location: deutsche Stadt oder Region, zum Beispiel „Hamburg“ oder „München“.searchType:businessfür Firmen (Branchensuche) oderpersonfür das private Telefonbuch. Für B2B nimmst dubusiness.maxResults: wie viele Einträge höchstens (Standard 100, erlaubt 1 bis 5000).includeDetails: Detailseiten öffnen für E-Mail, Öffnungszeiten und Bewertungen. Langsamer, dafür reicher.
Weitere Filter gibt es nicht. Du grenzt die Treffer über Suchbegriff und Ort ein.
Actor starten
Klicke auf Start. Der Actor liest die Trefferseiten und öffnet bei includeDetails zusätzlich jede Detailseite. Ein Lauf mit vielen Einträgen dauert deshalb länger als einer mit wenigen. Das Ergebnis erscheint live im Tab Output.
Daten exportieren
Im Tab Output klickst du auf Export und wählst CSV, Excel oder JSON. Die CSV-Datei öffnest du direkt in Excel oder Google Sheets.
Beispiel: Steuerberater in Hamburg
Zum Test haben wir den Actor einmal lokal auf unserem Rechner laufen lassen (kein Apify-Cloud-Lauf, direkte Verbindung, 21.10.2026) mit dieser Eingabe:
{
"searchQuery": "Steuerberater",
"location": "Hamburg",
"searchType": "business",
"maxResults": 15,
"includeDetails": true
}- 15 Einträge, so viele wie
maxResultserlaubt. Das sind nicht alle Steuerberater in Hamburg. - Alle 15 mit Telefonnummer, 14 mit E-Mail, 13 mit Website, 11 mit Öffnungszeiten.
- Das ist eine einzelne kleine Stichprobe. Die Quote kann bei anderen Branchen und Städten anders ausfallen.
- Einige Einträge sind Einzelpersonen als Berufsträger (zum Beispiel „Name Steuerberater“). Prüfe solche Zeilen vor einer Ansprache, siehe Datenschutz und Recht.
Drei Zeilen aus dem Lauf (Firmen, gekürzt auf die wichtigsten Spalten):
| name | address | phone | website |
|---|---|---|---|
| Förster & Pump GmbH | Schnackenburgallee 13, 22525 Hamburg | 040 8 51 70 10 | foerster-pump.de |
| Schomerus & Partner mbB | Deichstr. 1, 20459 Hamburg | 040 3 76 01-00 | schomerus.de |
| NACO KG Steuerberatungsgesellschaft | Gasstr. 16/ 2, 22761 Hamburg | 040 85 15 06 11 | naco-hamburg.de |
Auf Apify läuft der Actor über Apifys Proxy; lokal gab es keinen. Die Zahlen oben stammen aus dem lokalen Lauf.
Beispiel: Autowerkstätten in Frankfurt am Main
Dieses Beispiel steckt hinter unserem Short zu Frankfurter Autowerkstätten. Lokaler Lauf am 21.10.2026 mit dieser Eingabe:
{
"searchQuery": "Autowerkstatt",
"location": "Frankfurt am Main",
"searchType": "business",
"maxResults": 500,
"includeDetails": true
}- 116 Einträge, alles, was Das Telefonbuch für diese Suche lieferte (das Limit von 500 wurde nicht erreicht).
- 112 davon liegen in Frankfurt am Main selbst.
- 106 mit Telefonnummer, 50 mit Website, 51 mit Bewertung.
- Koordinaten (
latitude,longitude) liest der Actor von den Detailseiten, also nur mitincludeDetails.
Oder mit Claude:
Nutze den Apify MCP Server. Starte den Actor santamaria-automations/telefonbuch-de-scraper mit
searchQuery "Autowerkstatt", location "Frankfurt am Main", searchType "business", maxResults 500, includeDetails true.
Sag mir vor dem Start, was der Lauf kostet, und warte auf mein OK.
Behalte danach nur Einträge in Frankfurt am Main und gib mir eine Tabelle mit Name, Adresse, Telefon, Website und Bewertung.Kosten auf Apify, geschätzt: 0,001 $ + 116 x 0,005 $ = 0,581 $, also etwa 0,58 $ im Free-Plan. Den lokalen Lauf haben wir nicht auf Apify abgerechnet.
Beispiel: Steuerberater in Berlin
Dieses Beispiel steckt hinter unserem Short zu Berliner Steuerberatern. Lokaler Lauf am 23.10.2026 mit dieser Eingabe:
{
"searchQuery": "Steuerberater",
"location": "Berlin",
"searchType": "business",
"maxResults": 500,
"includeDetails": true
}- 477 Einträge, ohne doppelte Einträge. Das Limit von 500 wurde nicht erreicht.
- Wir haben nur Einträge in Berlin behalten, deren erste Kategorie Steuerberatung ist: 463 Einträge.
- 451 davon mit Telefonnummer, 305 mit Website, 434 mit Koordinaten.
- Etwa die Hälfte der Einträge trägt den Namen einer Person, also einzelne Berater statt einer Kanzlei. Prüfe solche Zeilen vor einer Ansprache, siehe Datenschutz und Recht.
Oder mit Claude:
Nutze den Apify MCP Server. Starte den Actor santamaria-automations/telefonbuch-de-scraper mit
searchQuery "Steuerberater", location "Berlin", searchType "business", maxResults 500, includeDetails true.
Sag mir vor dem Start, was der Lauf kostet, und warte auf mein OK.
Behalte danach nur Einträge in Berlin, deren erste Kategorie Steuerberatung ist, und gib mir eine Tabelle mit Name, Adresse, Telefon und Website.Kosten auf Apify im Free-Plan: höchstens 0,001 $ + 477 x 0,005 $ = 2,386 $, also bis zu etwa 2,39 $. Einträge, deren Detailseite nicht gelesen werden konnte, kosten nur 0,002 $. Den lokalen Lauf haben wir nicht auf Apify abgerechnet.
Felder im Ergebnis
Die wichtigsten Felder laut Output-Schema des Actors:
| Feld | Inhalt |
|---|---|
name | Name des Eintrags |
category | Kategorie / Branche |
address, street, postal_code, city, country | Adresse |
phone, fax, mobile | Telefon, Fax, Mobilnummer (Mobilnummern nur selten und nur auf Detailseiten) |
email | E-Mail, nur auf Detailseiten |
website | Website der Firma |
opening_hours | Öffnungszeiten |
rating, review_count | Bewertung und Anzahl |
external_review_sources, recent_reviews | Bewertungen von anderen Portalen und einzelne Rezensionen |
description | Unternehmensprofil, nur bei Premium-Einträgen und nur auf Detailseiten |
search_keywords | Suchbegriffe des Eintrags |
company_logo_url | Logo-URL |
source_url, source_platform, search_type, scraped_at | Quelle, Suchart und Zeitstempel |
E-Mails und Anreicherung
Die E-Mail aus dem Telefonbuch-Eintrag ist oft eine allgemeine Adresse. Für weitere Adressen gibst du die Spalte website in den Website Email Scraper. Für Ansprechpartner und weitere Kontaktdaten von der Firmen-Website gibt es den Website Contact Extractor.
API und Schedule
Jeden Lauf kannst du auch per Apify API starten und die Ergebnisse als JSON, CSV oder Excel abrufen. Die API-Beispiele zeigt dir Apify im Tab API des Actors. Mit einem Schedule in der Apify Console startest du denselben Lauf täglich oder wöchentlich, zum Beispiel um neue Einträge einer Branche zu erfassen.
Prompt für Claude zum Kopieren
Füge in Claude den Apify MCP Server als eigenen Konnektor mit dieser URL hinzu (siehe Apifys MCP-Dokumentation). Die URL beschränkt Claude auf diesen einen Actor:
https://mcp.apify.com?tools=santamaria-automations/telefonbuch-de-scraperDann fügst du diesen Prompt ein und ersetzt Branche und Stadt durch deine:
Nutze den Apify MCP Server. Starte den Actor santamaria-automations/telefonbuch-de-scraper mit dem Suchbegriff "Steuerberater",
Ort "Hamburg", searchType "business" und höchstens 100 Ergebnissen.
Sag mir vor dem Start, was der Lauf kostet, und warte auf mein OK.
Wenn er fertig ist, gib mir eine Tabelle mit Name, Adresse, Telefon, E-Mail und Website.Getestet haben wir den Actor und die Eingaben, nicht die Prompts über MCP; Claude formuliert die Kostenangabe eventuell anders.
Was das kostet
Der Actor rechnet pro Eintrag ab. Laut Actor-Seite kostet ein vollständiges Profil 0,005 $, also 5 $ pro 1.000. Beispiele: 10 Profile etwa 0,05 $, 100 Profile etwa 0,50 $. Der Testlauf oben lief lokal und hat nichts gekostet, die Zahlen gelten also für den Lauf auf Apify. Den aktuellen Gratis-Betrag des Free-Plans findest du auf Apifys Preisseite. Ohne Detailseiten (includeDetails aus) kostet ein Eintrag 0,002 $, dafür fehlen E-Mail, Öffnungszeiten und Bewertungen. Dazu kommt pro Lauf ein Start von 0,001 $. Mehr auf der Actor-Seite.
Anwendungen
- Lokale Firmenlisten: alle Einträge einer Branche in einer Stadt als Tabelle für Vertrieb oder Marktanalyse.
- Adressabgleich: bestehende Kundenlisten mit aktuellen Telefon- und Webdaten vergleichen.
- Wettbewerbsübersicht: Anbieter, Standorte und Bewertungen einer Region nebeneinander sehen.
- Weitere Verarbeitung: Website-Spalte an den Email Scraper geben und die Liste im CRM weiterverwenden.
Häufige Fragen
Bekomme ich E-Mail-Adressen?
Ja, wenn der Eintrag eine hat. E-Mails stehen nur auf den Detailseiten, also nur mit includeDetails. Im Testlauf (15 Steuerberater in Hamburg) hatten 14 eine E-Mail. Für fehlende Adressen gibst du die Website-Spalte in den Website Email Scraper.
Kann ich ganz Deutschland auf einmal durchsuchen?
Der Actor sucht pro Lauf nach einem Suchbegriff in einem Ort. Für mehrere Städte startest du mehrere Läufe oder planst sie als Schedule. maxResults darf bis 5000 gehen.
Was ist der Unterschied zwischen business und person?
Mit searchType business suchst du Firmeneinträge (Branchensuche). Mit person durchsucht der Actor das private Telefonbuch. Für B2B-Adressen nimmst du business.
Was kostet der Telefonbuch Scraper?
0,005 $ pro vollständigem Profil (5 $ pro 1.000) oder 0,002 $ pro Eintrag ohne Detailseite, dazu 0,001 $ pro Lauf. 100 Profile kosten damit etwa 0,50 $.
Brauche ich Claude?
Nein. Die Schritte 1 bis 4 funktionieren komplett in der Apify Console. Der MCP-Link ist nur eine Option.
Darf ich die Adressen für Kaltakquise nutzen?
Das hängt vom Einzelfall ab. Lies dazu den Abschnitt zu Datenschutz und Recht. Er ersetzt keine Rechtsberatung.
Hinweis zu Datenschutz und Recht
Der Actor sammelt Einträge, die auf telefonbuch.de öffentlich angezeigt werden. Für personenbezogene Daten (zum Beispiel den Namen eines Einzelunternehmers oder eine private Nummer) bist du verantwortlich. Du musst die DSGVO, in Deutschland das UWG (zum Beispiel § 7 zu Werbeanrufen und Werbe-E-Mails ohne Einwilligung) und die Nutzungsbedingungen von Das Telefonbuch einhalten. Prüfe vor Kaltakquise die Regeln. Das ist keine Rechtsberatung; frag im Zweifel eine Anwältin oder einen Anwalt.
Weiterführende Links
- Das Telefonbuch Scraper, Actor-Seite: alle Felder und Preise.
- Herold Scraper Tutorial: Firmendaten aus Österreichs Gelben Seiten.
- Google Maps Scraper Tutorial: Firmendaten aus Google Maps.
- Website Email Scraper: E-Mails auf den gefundenen Webseiten finden.
- Website Contact Extractor: Kontaktdaten von Firmen-Websites.