无需认证。
/agent-signup 端点是公开的。代理无需现有 API 密钥即可调用它。工作原理
- 代理调用
POST /v2/agent-signup，并提供用户的电子邮件、代理名称以及accept_terms: true。 - Firecrawl 会立即返回一个 API 密钥。该密钥会被置于沙盒环境中，具有 50 额度，并且在发起方确认之前仅限进行纯索引抓取。
- 用户本人会收到一封电子邮件，其中包含两个链接：Confirm & Link Key 或 Block this key。
- 确认后，该沙盒密钥会合并到用户本人现有的 Firecrawl 账户中 (如果没有，则会创建一个新账户) 。该密钥将继承完整套餐的限制。
- 阻止后，该密钥会被禁用，并且该电子邮件将受到保护，防止今后未经授权的注册。
供代理使用
创建密钥
api_key 进行抓取、搜索以及其他 Firecrawl 操作。该密钥会立即生效，但在人工确认之前，额度上限为 50。
处理沙箱限制
sponsor_status 为 "pending" 时：
- 该密钥有一个硬性 50 额度上限。额度耗尽后，请求会返回
402，并带有error: "unverified_credit_limit_reached"。 - 所有 scrape 请求都仅限于 仅索引模式 (不进行完整的浏览器渲染) 。
- 如果未在 5 天内确认，该密钥将过期。
错误处理
面向用户
- 确认并关联密钥 — 将代理的密钥合并到你的 Firecrawl 账户中。如果你还没有账户，系统会为你创建一个。该密钥将继承你当前方案的限制。
- 阻止此密钥 — 立即禁用该密钥，并阻止该邮箱后续的代理注册。