Wie Sie Leads mit Claude Code finden und anreichern

Die Firecrawl Alexandria People API ermöglicht es deinem Coding-Agenten, Personen über einen einzigen Firecrawl-Schlüssel zu finden und anzureichern. Tools entdeckst du kostenlos mit v2/search, Kandidaten listest du mit Apollo people/search für 0 Credits auf, eine Person deckst du mit Apollo people/match für 30 Credits auf, oder du reicherst eine bekannte E-Mail mit People Data Labs person/enrich für 60 Credits an. Jeder Aufruf läuft über POST /v2/scrape.

Jeder der folgenden Schritte kommt zweimal vor: als Prompt für Claude Code (oder Codex) und als rohes curl, damit du es auch ohne Agenten skripten kannst.

Was die Firecrawl Alexandria People API ist

Alexandria ist Firecrawls Bibliothek von Drittanbieter-Datenanbietern, erreichbar mit dem API-Schlüssel, den du bereits zum Scrapen verwendest. Laut den Alexandria-Docs entdeckst du ein Tool, prüfst seine Eingaben und seinen Preis und führst es dann mit scrape aus. Die Entdeckung ist kostenlos; die Ausführung kostet die Credits, die beim Tool angegeben sind.

Die Kategorie People umfasst 12 Anbieter. Zwei davon decken den Großteil der Prospecting-Arbeit ab:

Die Preise sind diejenigen, die am 4. November 2026 neben der Schaltfläche Run auf der Apollo-Seite und der People-Data-Labs-Seite angezeigt wurden. Auf Apollos Seite heißt es außerdem, dass ein Fehlschlag bei people/match „keine Person zurückgibt und nicht berechnet wird“.

Was eine Personenabfrage in Dollar kostet

Der Wert eines Credits hängt von deinem Tarif ab. Laut der Firecrawl-Preisseite kostet Hobby 19 $ pro Monat für 5.000 Credits und Standard 99 $ pro Monat für 100.000 Credits, beide monatlich abgerechnet.

Die Rechnung: $19 / 5.000 = $0.0038 pro Credit und $99 / 100.000 = $0.00099. 100 Vorschauen zu durchsuchen und die besten 20 aufzudecken kostet 600 Credits, was in die 1.000 Credits pro Monat des Free-Tarifs passt. People Data Labs begrenzt dich außerdem auf 50.000 API-Aufrufe pro Jahr und Organisation, geteilt über Personen- und Unternehmens-Endpunkte, Wiederholungsversuche eingeschlossen.

Schritt 1: Claude Code mit Firecrawl verbinden

Der schnellste Weg ist Firecrawls Agent-Installer. Er fügt jedem erkannten Coding-Agenten die Firecrawl-Skills hinzu und meldet dich über den Browser an:

npx -y firecrawl-cli@latest init --all --browser

Starte deinen Agenten danach neu. Manuell geht es mit npm install -g firecrawl-cli und firecrawl login. Unser Firecrawl-CLI-Leitfaden behandelt beides, und die Firecrawl-MCP-Anleitung behandelt den MCP-Server, der dieselbe Schleife als firecrawl_search, firecrawl_find_tools und firecrawl_scrape bereitstellt.

Für die folgenden curl-Beispiele exportierst du deinen Schlüssel einmal:

export FIRECRAWL_API_KEY="fc-..."   # never commit this

Schritt 2: Die People-Tools kostenlos entdecken

Frag zuerst deinen Agenten, denn die Entdeckung kostet nichts:

Use Firecrawl Alexandria to find tools that search people by job title and
company, and tools that enrich a person from an email. Inspect Apollo and
People Data Labs with find-tools and show me each capability's inputs and
credit price before you run anything.

Unter der Haube ist das eine Suche mit sources ausschließlich auf ["alexandria"]. "web" wegzulassen hält sie kostenlos, denn Web-Ergebnisse werden berechnet:

curl https://api.firecrawl.dev/v2/search \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "find people by job title and company", "sources": ["alexandria"], "limit": 5}'

Die Antwort listet sortierte tools auf, jeweils mit Anbieter, Funktion und Beschreibung. Um Eingaben und Preise zu lesen, führt der Agent find-tools aus:

firecrawl find-tools --options '{"providers":["apollo","people-data-labs"],"level":"tools","expand":["options","response"]}' --include-costs

Schritt 3: Mit Apollo nach Kandidaten für 0 Credits suchen

Apollos Seite weist Agenten an, immer hier zu beginnen: Es ist kostenlos und zeigt, wer existiert, bevor du etwas ausgibst.

Run Apollo people/search through Firecrawl Alexandria for "VP of Sales" and
"Head of Revenue" at stripe.com and linear.app, 25 per page. Show name,
title, company and has_email. Don't reveal anyone yet.

Der rohe Aufruf:

curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "alexandria": {
      "provider": "apollo",
      "capability": "people/search",
      "options": {
        "person_titles": ["VP of Sales", "Head of Revenue"],
        "q_organization_domains_list": ["stripe.com", "linear.app"],
        "page": 1,
        "per_page": 25
      }
    }
  }'

Jede Vorschau enthält einen maskierten Nachnamen und eine Apollo-id, die zuverlässigste Eingabe für den nächsten Schritt.

Schritt 4: Eine Person mit people/match aufdecken

Jetzt zahlst du nur für die Personen, die es wert sind, kontaktiert zu werden – 30 Credits pro Match:

For the 3 previews with has_email true, run Apollo people/match with their
id. Don't set reveal_personal_emails or reveal_phone_number.

curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"alexandria": {"provider": "apollo", "capability": "people/match", "options": {"id": "<apollo_id>"}}}'

Lass die beiden Reveal-Flags weg, wenn du sie nicht brauchst. Auf der Apollo-Seite heißt es, eine private E-Mail werde „zusätzlich berechnet“ und eine Telefonnummer sei „deutlich teurer als der Basis-Match“.

Schritt 5: Eine bekannte E-Mail mit People Data Labs anreichern

Wenn du bereits eine E-Mail hast, etwa aus einer eingehenden Registrierung, liefert person/enrich ein vollständigeres Profil: geschäftliche E-Mail, Titel, Unternehmen, LinkedIn-URL, Erfahrung und Skills.

Enrich jane@example.com with People Data Labs person/enrich through
Firecrawl Alexandria. Set min_likelihood to 6 so a weak match comes back
as a 404 instead of a wrong record.

curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"alexandria": {"provider": "people-data-labs", "capability": "person/enrich", "options": {"email": "jane@example.com", "min_likelihood": 6}}}'

min_likelihood reicht von 1 bis 10, der Standardwert ist 2. Die Anbieterseite beschreibt den Kompromiss deutlich: Ein 404 „ist hier kostenlos, ein falscher Datensatz nicht.“ Setze den Wert höher, bevor du über eine Liste iterierst.

THIRD_PARTY_DATA_TERMS_REQUIRED behandeln

Dein erster bezahlter Aufruf bei einem Anbieter kann mit THIRD_PARTY_DATA_TERMS_REQUIRED fehlschlagen. Laut den Docs enthält der Fehler eine requiresAction.url, und ein Org-Admin muss sie öffnen und die Bedingungen dieses Anbieters akzeptieren, bevor ein Aufruf durchgeht.

Lass den Agenten nicht einfach durchklicken. Die Docs sagen, dass Agenten eine ausdrückliche Nutzerautorisierung brauchen, bevor sie Bedingungen akzeptieren, die regeln, wie du personenbezogene Daten verwenden darfst. Füge eine Zeile zu deiner CLAUDE.md hinzu: „Wenn ein Aufruf THIRD_PARTY_DATA_TERMS_REQUIRED zurückgibt, stoppe und zeige mir requiresAction.url.“

Die alexandria[].data-Payload lesen

Ergebnisse kommen in einem alexandria-Array zurück, ein Eintrag pro Tool-Aufruf, mit der Payload des Anbieters unter data. Rohes HTTP verpackt das gesamte SDK-Ergebnis in ein data auf oberster Ebene, in einer curl-Antwort sitzt der Apollo-Match also unter data.alexandria[0].data.person:

curl -s https://api.firecrawl.dev/v2/scrape ... | jq '.data.alexandria[0].data.person | {name, title, email, linkedin_url}'

Zwei Prüfungen halten schlechte Zeilen aus deinem CRM:

1. Prüfe jedes Ergebnis auf Fehler, bevor du data liest. Die Docs sagen das ausdrücklich; ein einzelner Aufruf kann fehlschlagen, während die HTTP-Anfrage erfolgreich ist.
2. Behandle Platzhalter-E-Mails als fehlend. Apollo merkt an, dass eine nicht aufgedeckte E-Mail als wörtliches email_not_unlocked@domain.com zurückkommen kann, selbst wenn email_status „verified“ sagt.

Bei People Data Labs sitzt die Person innerhalb des Ergebnisses unter data, neben status und likelihood des Envelopes.

Feedback senden und einen Credit zurückbekommen

Alexandria zahlt dir für Feedback. Jede Einsendung erstattet 1 Credit, unabhängig von der Bewertung, begrenzt pro UTC-Tag auf 10 Credits pro Website und 100 pro Team. Du hast 20 Minuten ab dem letzten Alexandria-Aufruf deines Teams; danach bekommst du FEEDBACK_WINDOW_EXPIRED.

Führe in der CLI firecrawl alexandria feedback aus (die Optionen findest du mit --help). Über MCP ruft der Agent firecrawl_feedback mit endpoint: "alexandria" auf. Eine Prompt-Zeile funktioniert gut: „Wenn ein Ergebnis falsch oder leer aussieht, sende Alexandria-Feedback, das es beschreibt.“

Lass Claude Code diese Aufrufe mit der Apidog CLI absichern

Sobald ein Skript darauf angewiesen ist, dass people/search eine id zurückgibt, die people/match akzeptiert, bricht ein umbenanntes Feld es stillschweigend. Dein Agent kann die Aufrufe aus diesem Leitfaden in ein Regression-Szenario in der Apidog CLI verwandeln und es nach Zeitplan ausführen. Du schreibst einen Prompt.

Richte die CLI und ihren Agent-Skill einmal ein:

npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_APIDOG_TOKEN>
npx -y skills add https://apidog.com   # pick Claude Code or Codex when prompted

Dann gib Claude Code diesen Prompt:

Write an OpenAPI 3 file for three Firecrawl calls from this guide:
POST /v2/search with sources ["alexandria"], POST /v2/scrape for apollo
people/search (per_page 1), and POST /v2/scrape for apollo people/match.
All send Authorization: Bearer {{FIRECRAWL_API_KEY}}. Import it into Apidog
project <projectId> and create a "Firecrawl" environment for
https://api.firecrawl.dev. Build a test scenario that runs the three in
order, saves data.alexandria[0].data.people[0].id as personId and passes it
to people/match, and asserts status 200, no result error, and a person
object on the match. Run it and summarize failures.

Der Agent liest jedes Payload-Schema, validiert es und führt dann Befehle wie diese aus:

apidog import --project <projectId> --format openapi --file ./firecrawl-people.json
apidog environment create Firecrawl --project <projectId> --base-url https://api.firecrawl.dev
apidog test-scenario create --project <projectId> --name "Alexandria people" --folder-id <folderId> --priority <priority>
apidog cli-schema get test-scenario-update
apidog cli-schema validate test-scenario-update --file ./people-scenario.json
apidog test-scenario update <scenarioId> --project <projectId> --file ./people-scenario.json
apidog run -t <scenarioId> --project <projectId> -e <envId> \
  --env-var "FIRECRAWL_API_KEY=$FIRECRAWL_API_KEY" -r cli,junit

Ein vollständiger Lauf kostet 30 Credits für den Match, plane ihn also täglich statt bei jedem Commit ein. Die apidog-run-Referenz listet die Flags für Berichte und Iterationen auf, und Apidog CLI in Claude Code zeigt das Setup ausführlicher. Der Free-Tarif von Apidog deckt bis zu 4 Nutzer ab.

FAQ

Ist die Firecrawl Alexandria People API kostenlos? Die Entdeckung ist kostenlos, und Apollo people/search zeigte am 4. November 2026 0 Credits an. Das Aufdecken einer Person kostet Credits: 30 für Apollo people/match und 60 für People Data Labs person/enrich. Der Free-Tarif enthält 1.000 Credits pro Monat ohne Kreditkarte.

Brauche ich separate Konten bei Apollo oder People Data Labs? Nein. Alexandria betreibt beide über deinen Firecrawl-API-Schlüssel und rechnet in Firecrawl-Credits ab. Ein Org-Admin muss allerdings einmal die Bedingungen jedes Anbieters akzeptieren, und genau dazu fordert THIRD_PARTY_DATA_TERMS_REQUIRED auf.

Warum zeigt meine people/match-Antwort email_not_unlocked@domain.com? Das ist Apollos Platzhalter für eine E-Mail, die nicht aufgedeckt wurde. Behandle sie als nicht verfügbar, selbst wenn email_status „verified“ sagt.

Können Codex oder Cursor das statt Claude Code ausführen? Ja. npx -y firecrawl-cli@latest init --all richtet jeden erkannten Agenten ein, und die MCP-Tools funktionieren in jedem MCP-Client. Die curl-Aufrufe funktionieren auch ganz ohne Agenten.

Wie vermeide ich es, für falsche Matches zu zahlen? Suche, bevor du matchst, matche über die Apollo-id statt über den Namen und setze min_likelihood bei People Data Labs auf 6 oder höher. Apollo berechnet einen Fehlschlag nicht, und ein PDL-404 ist kostenlos.