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.

Niveau: Einsteiger
Dauer: 5 Minuten
Kosten: 0,005 $ pro vollständigem Profil
Werkzeuge: Apify Console oder Claude mit MCP
Actor auf Apify öffnen → Claude-Prompt kopieren

In diesem Tutorial

  1. Das bekommst du
  2. Schritt 1: Apify-Konto anlegen
  3. Schritt 2: Branche und Stadt
  4. Schritt 3: Actor starten
  5. Schritt 4: Daten exportieren
  6. Beispiel: Steuerberater in Hamburg
  7. Beispiel: Autowerkstätten in Frankfurt
  8. Beispiel: Steuerberater in Berlin
  9. Felder
  10. E-Mails und Anreicherung
  11. API und Schedule
  12. Prompt für Claude
  13. Kosten
  14. Anwendungen
  15. FAQ
  16. 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:

Der Standard ist includeDetails: true: Der Actor öffnet dann die Detailseite jedes Eintrags. Ohne Detailseiten bekommst du nur die Felder aus der Trefferliste.

SCHRITT 1

Apify-Konto anlegen

  1. Öffne die Seite des Scrapers für Das Telefonbuch auf Apify.
  2. Klicke auf Try for free und registriere dich mit Google oder E-Mail.
  3. Du landest in der Apify Console im Tab Input des Actors.
SCHRITT 2

Branche und Stadt eintragen

{
  "searchQuery": "Steuerberater",
  "location": "Hamburg",
  "searchType": "business",
  "maxResults": 100,
  "includeDetails": true
}

Weitere Filter gibt es nicht. Du grenzt die Treffer über Suchbegriff und Ort ein.

SCHRITT 3

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.

SCHRITT 4

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
}

Drei Zeilen aus dem Lauf (Firmen, gekürzt auf die wichtigsten Spalten):

nameaddressphonewebsite
Förster & Pump GmbHSchnackenburgallee 13, 22525 Hamburg040 8 51 70 10foerster-pump.de
Schomerus & Partner mbBDeichstr. 1, 20459 Hamburg040 3 76 01-00schomerus.de
NACO KG SteuerberatungsgesellschaftGasstr. 16/ 2, 22761 Hamburg040 85 15 06 11naco-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
}

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
}

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:

FeldInhalt
nameName des Eintrags
categoryKategorie / Branche
address, street, postal_code, city, countryAdresse
phone, fax, mobileTelefon, Fax, Mobilnummer (Mobilnummern nur selten und nur auf Detailseiten)
emailE-Mail, nur auf Detailseiten
websiteWebsite der Firma
opening_hoursÖffnungszeiten
rating, review_countBewertung und Anzahl
external_review_sources, recent_reviewsBewertungen von anderen Portalen und einzelne Rezensionen
descriptionUnternehmensprofil, nur bei Premium-Einträgen und nur auf Detailseiten
search_keywordsSuchbegriffe des Eintrags
company_logo_urlLogo-URL
source_url, source_platform, search_type, scraped_atQuelle, 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-scraper

Dann 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

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

Actor auf Apify öffnen → Alle Tutorials