Agent Signupを使うと、AI AgentがプログラムからFirecrawl APIキーを作成できます。ブラウザ不要、OAuth不要、作成時に人が介在する必要もありません。Agentは人間のメールアドレスを指定し、Firecrawlはすぐに使える、50クレジット上限のサンドボックス化されたAPIキーを発行します。人間には、そのキーを確認またはブロックするためのメールが届きます。
認証は不要です。 /agent-signup endpoint は公開されています。Agentは、これを呼び出すための既存のAPIキーを必要としません。
- Agent が
POST /v2/agent-signup を呼び出し、ユーザーの email、agent の名前、accept_terms: true を送信します。
- Firecrawl は API key を即座に返します。この key には 50 credits のサンドボックス制限が適用され、スポンサーが確認するまではインデックス専用の scraping のみ実行できます。
- 人間のユーザーには email が届き、2 つのリンクが含まれます: Confirm & Link Key または Block this key。
- 確認されると、サンドボックス化された key はその人間の既存の Firecrawl account に統合されます (既存の account がない場合は新規作成されます) 。この key には完全な plan の制限が適用されます。
- ブロックされると、その key は無効になり、その email は今後の不正な signup から保護されます。
Agent Firecrawl Human
│ │ │
│── POST /agent-signup ──▶│ │
│◀── API key (sandboxed) ─│── verification email ──▶│
│ │ │
│ uses key (50 credits) │ │
│ │ │
│ │◀── confirm or block ────│
│ │ │
│ key upgraded to full │ │
│ plan (if confirmed) │ │
curl -X POST "https://api.firecrawl.dev/v2/agent-signup" \
-H "Content-Type: application/json" \
-d '{
"email": "user@company.com",
"agent_name": "Research Assistant",
"accept_terms": true
}'
{
"success": true,
"api_key": "fc-...",
"sponsor_status": "pending",
"credit_limit": 50,
"credits_remaining": 50,
"verification_deadline_at": "2026-03-23T12:00:00.000Z",
"tos_url": "https://firecrawl.dev/terms-of-service"
}
api_keyは、スクレイピング、検索、その他のFirecrawlオペレーションにすぐ使用できます。キーはすぐに有効になりますが、人間が確認するまでは50クレジットに制限されます。
sponsor_status が "pending" の間:
- キーには厳格な 50クレジットの上限 があります。使い切ると、リクエストは
402 と error: "unverified_credit_limit_reached" を返します。
- すべてのスクレイピングリクエストは index-only mode に制限されます (完全なブラウザレンダリングは行われません) 。
- 5日以内 に確認されない場合、キーは失効します。
人間が確認すると、キーはクレジット上限やモード制限のない本来のプランにアップグレードされます。
| ステータス | エラー | 意味 |
|---|
402 | unverified_credit_limit_reached | 50クレジットのサンドボックスを使い切りました。人間に確認を依頼してください。 |
403 | sponsor_verification_expired | 確認されないまま、5日間の期限を過ぎました。 |
403 | This API key has been blocked | 人間がこのAPIキーをブロックしました。使用を停止してください。 |
409 | A pending agent signup confirmation has already been sent | このメールアドレスでは、すでにagent登録の確認が送信されており、キーが確認待ちになっています。 |
- Confirm & Link Key — agent のキーをあなたの Firecrawl アカウントに紐付けます。アカウントがない場合は、自動的に作成されます。このキーには、あなたのプランの制限が適用されます。
- Block this key — このキーを即座に無効化し、そのメールアドレスから今後 agent が signup できないようにします。
agent キーは Firecrawl dashboard から管理することもできます。既存のアカウントがある場合は、アプリ内通知も表示されます。
その agent を承認していない場合は、すぐに Block this key をクリックしてください。これによりキーが取り消され、以後使用できなくなります。
