DEV Community

Cover image for Claude Codeでリードを発見・エンリッチする方法
Akira
Akira

Posted on Originally published at apidog.com

Claude Codeでリードを発見・エンリッチする方法

Claude Codeでリードを発見・エンリッチする方法

Firecrawl Alexandria の people API を使うと、コーディングエージェントは 1 つの Firecrawl キーで人物を見つけてエンリッチできます。v2/search でツールを無料で見つけ、Apollo people/search で 0 クレジットで候補者を一覧表示し、Apollo people/match で 30 クレジットで 1 人を開示し、People Data Labs person/enrich で 60 クレジットで既知のメールをエンリッチします。すべての呼び出しは POST /v2/scrape を経由します。

今すぐ Apidog を試す

以下の各ステップは 2 通りあります。Claude Code（または Codex）向けのプロンプトと、生の curl です。そのため、エージェントなしでスクリプト化できます。

Firecrawl Alexandria people API とは

Alexandria は Firecrawl のサードパーティデータプロバイダーのライブラリで、スクレイピングですでに使用している API キーでアクセスできます。Alexandria のドキュメント によると、ツールを見つけ、その入力と価格を確認し、scrape で実行します。ディスカバリは無料で、実行にはツールに記載されたクレジットがかかります。

People カテゴリには 12 のプロバイダーがあります。そのうち 2 つがほとんどのプロスペクティング作業をカバーします:

プロバイダー 機能 呼び出しあたりのクレジット 送信内容 取得内容
Apollo people/search 0 person_titles、q_keywords、q_organization_domains_list、per_page（最大 100） プレビュー: 名、マスクされた姓、役職、会社、has_email、Apollo id
Apollo people/match 30 検索結果の id、または linkedin_url、email、もしくは name と domain 役職、経歴、連絡先を含む 1 人の解決済み人物
People Data Labs person/enrich 60 email、profile、pdl_id など。名前だけでは 400 を返します 完全な人物レコードと likelihood（1〜10）

価格は 2026年11月4日時点で Apollo ページ と People Data Labs ページ の Run ボタンの横に表示されているものです。Apollo のページには、people/match がミスした場合は「人物を返さず、課金されない」とも書かれています。

人物検索にかかるドルコスト

1 クレジットの価値はプランによって異なります。Firecrawl の料金ページ によると、Hobby は月額 19 ドルで 5,000 クレジット、Standard は月額 99 ドルで 100,000 クレジットで、どちらも月次請求です。

呼び出し クレジット Hobby（$0.0038/クレジット） Standard（$0.00099/クレジット）
ディスカバリ検索または find-tools 0 $0 $0
Apollo people/search 0 $0 $0
Apollo people/match 30 $0.114 $0.0297
PDL person/enrich 60 $0.228 $0.0594

計算は次のとおりです。$19 / 5,000 = 1 クレジットあたり $0.0038、$99 / 100,000 = $0.00099。100 件のプレビューを検索し、最良の 20 人を開示すると 600 クレジットかかり、これは Free プランの月間 1,000 クレジットに収まります。People Data Labs では、組織あたり年間 50,000 API 呼び出しという上限もあり、person と company のエンドポイントで共有され、リトライも含まれます。

Flow of a people lookup on Firecrawl Alexandria: free discovery search, Apollo people/search at 0 credits, Apollo people/match at 30 credits, People Data Labs person/enrich at 60 credits, and feedback refunding 1 credit

ステップ 1: Claude Code を Firecrawl に接続する

最速の方法は Firecrawl のエージェントインストーラーです。検出したすべてのコーディングエージェントに Firecrawl スキルを追加し、ブラウザ経由でサインインします:

npx -y firecrawl-cli@latest init --all --browser
Enter fullscreen mode Exit fullscreen mode

その後、エージェントを再起動します。手動の場合は npm install -g firecrawl-cli と firecrawl login です。当社の Firecrawl CLI ガイド では両方を、Firecrawl MCP ウォークスルー では MCP サーバーを扱っています。MCP サーバーは firecrawl_search、firecrawl_find_tools、firecrawl_scrape として同じループを公開します。

以下の curl の例では、キーを一度エクスポートします:

export FIRECRAWL_API_KEY="fc-..."   # never commit this
Enter fullscreen mode Exit fullscreen mode

ステップ 2: people ツールを無料で見つける

ディスカバリにはコストがかからないので、まずエージェントに尋ねます:

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.
Enter fullscreen mode Exit fullscreen mode

内部的には、これは sources を ["alexandria"] のみに設定した検索です。"web" を省くと無料のままです。ウェブ結果には課金されるためです:

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}'
Enter fullscreen mode Exit fullscreen mode

レスポンスにはランク付けされた tools が一覧表示され、それぞれにプロバイダー、機能、説明が含まれます。入力と価格を読むには、エージェントが find-tools を実行します:

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

ステップ 3: 0 クレジットで Apollo から候補者を検索する

Apollo のページでは、エージェントに常にここから始めるよう指示しています。無料で、何かにお金を使う前に誰が存在するかを示してくれます。

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.
Enter fullscreen mode Exit fullscreen mode

生の呼び出し:

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
      }
    }
  }'
Enter fullscreen mode Exit fullscreen mode

各プレビューにはマスクされた姓と Apollo の id が含まれており、次のステップで最も信頼できる入力です。

ステップ 4: people/match で 1 人を開示する

ここでは、連絡する価値のある人物にだけ支払います。マッチあたり 30 クレジットです:

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.
Enter fullscreen mode Exit fullscreen mode 
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>"}}}'
Enter fullscreen mode Exit fullscreen mode

必要でない限り、2 つの開示フラグはオフのままにします。Apollo のページには、個人メールは「追加課金」され、電話番号は「基本マッチよりかなり高額」と書かれています。

ステップ 5: 既知のメールを People Data Labs でエンリッチする

すでにメールを持っている場合、たとえばインバウンド登録から得た場合、person/enrich はより完全なプロフィールを返します。仕事用メール、役職、会社、LinkedIn URL、経験、スキルです。

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.
Enter fullscreen mode Exit fullscreen mode 
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}}}'
Enter fullscreen mode Exit fullscreen mode

min_likelihood は 1〜10 で、デフォルトは 2 です。プロバイダーのページはトレードオフを明確に述べています。404 は「ここでは無料だが、誤ったレコードはそうではない」。リストをループ処理する前に値を上げてください。

THIRD_PARTY_DATA_TERMS_REQUIRED を処理する

プロバイダーへの最初の有料呼び出しは、THIRD_PARTY_DATA_TERMS_REQUIRED で失敗することがあります。ドキュメントによると、このエラーには requiresAction.url が含まれ、呼び出しが通る前に組織の管理者がそれを開いてそのプロバイダーの規約に同意する必要があります。

エージェントにそれをクリックさせないでください。ドキュメントでは、エージェントは規約に同意する前にユーザーの明示的な承認を必要とし、規約は個人データをどのように使用してよいかを規定すると述べています。CLAUDE.md に次の 1 行を追加します。「呼び出しが THIRD_PARTY_DATA_TERMS_REQUIRED を返したら、停止して requiresAction.url を表示してください。」

alexandria[].data ペイロードを読む

結果は alexandria 配列で返り、ツール呼び出しごとに 1 エントリがあり、プロバイダーのペイロードは data の下にあります。生の HTTP は SDK 結果全体をトップレベルの data で包むため、curl レスポンスでは Apollo のマッチは data.alexandria[0].data.person にあります:

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

次の 2 つのチェックで不正な行を CRM に入れないようにします:

  1. 各結果にエラーがないか確認する、data を読む前に。ドキュメントはこれを明示しています。HTTP リクエストが成功しても、1 回の呼び出しは失敗することがあります。
  2. プレースホルダーのメールは欠落として扱う。 Apollo は、email_status が verified を示していても、未開示のメールが文字列 email_not_unlocked@domain.com として返ることがあると注記しています。

People Data Labs では、人物は結果内の data の下にあり、エンベロープの status と likelihood の隣にあります。

フィードバックを送って 1 クレジットを取り戻す

Alexandria はフィードバックに対して支払います。各提出は評価に関係なく 1 クレジットを返金し、UTC 日ごとにウェブサイトあたり 10 クレジット、チームあたり 100 クレジットが上限です。チームの最新の Alexandria 呼び出しから 20 分あり、それを過ぎると FEEDBACK_WINDOW_EXPIRED になります。

CLI からは firecrawl alexandria feedback を実行します（オプションについては --help を参照）。MCP では、エージェントは endpoint: "alexandria" を指定して firecrawl_feedback を呼び出します。プロンプトの 1 行が有効です。「結果が間違っているか空に見える場合は、それを説明する Alexandria フィードバックを送信してください。」

Claude Code に Apidog CLI でこれらの呼び出しをガードさせる

スクリプトが people/search から people/match が受け入れる id が返ることに依存すると、フィールド名の変更が静かに壊します。エージェントはこのガイドの呼び出しを Apidog CLI の回帰シナリオに変換し、スケジュールで実行できます。書くのは 1 つのプロンプトだけです。

CLI とそのエージェントスキルを一度セットアップします:

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
Enter fullscreen mode Exit fullscreen mode

次に、Claude Code にこのプロンプトを渡します:

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.
Enter fullscreen mode Exit fullscreen mode

エージェントは各ペイロードスキーマを読み取り、検証してから、次のようなコマンドを実行します:

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
Enter fullscreen mode Exit fullscreen mode

Diagram of an Apidog test scenario chaining Firecrawl v2/search, Apollo people/search and Apollo people/match, run by a coding agent with apidog run and producing a test report

完全な実行ごとにマッチの 30 クレジットがかかるため、コミットごとではなく毎日スケジュールしてください。apidog run リファレンス にはレポートと反復のフラグが一覧されており、Claude Code での Apidog CLI ではセットアップをより詳しく示しています。Apidog の Free プランは最大 4 ユーザーまでカバーします。

FAQ

Firecrawl Alexandria people API は無料ですか？ ディスカバリは無料で、Apollo people/search は 2026年11月4日時点で 0 クレジットでした。人物の開示にはクレジットがかかります。Apollo people/match は 30、People Data Labs person/enrich は 60 です。Free プランにはカード不要で月 1,000 クレジットが含まれます。

Apollo または People Data Labs の別アカウントが必要ですか？ いいえ。Alexandria は両方をあなたの Firecrawl API キー経由で実行し、Firecrawl クレジットで請求します。組織の管理者は各プロバイダーの規約に一度同意する必要があり、それが THIRD_PARTY_DATA_TERMS_REQUIRED の求めるところです。

people/match のレスポンスに email_not_unlocked@domain.com と表示されるのはなぜですか？ それは、開示されなかったメールに対する Apollo のプレースホルダーです。email_status が verified と言っていても、利用不可として扱ってください。

Claude Code の代わりに Codex や Cursor で実行できますか？ はい。npx -y firecrawl-cli@latest init --all は検出されたすべてのエージェントをセットアップし、MCP ツールは任意の MCP クライアントで動作します。curl 呼び出しはエージェントなしでも動作します。

誤ったマッチに支払わないようにするには？ マッチする前に検索し、名前ではなく Apollo id でマッチし、People Data Labs では min_likelihood を 6 以上に設定します。Apollo はミスに課金せず、PDL の 404 は無料です。

Top comments (0)