> ## Documentation Index
> Fetch the complete documentation index at: https://firecrawl-locadex-parallel-t9n-main-ydzk9zxoc20klj1uk5u1gd5b.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Stripe Projects

> 通过 Stripe Projects CLI 开通 Firecrawl 账户、API 密钥和方案

<Note>
  **Stripe 官方文档：** [docs.stripe.com/projects](https://docs.stripe.com/projects) · [提供商名录中的 Firecrawl](https://projects.dev/providers/)

  Firecrawl 是 Stripe Projects 的提供商之一。运行 `stripe projects add firecrawl/api` 即可将其添加到任意项目。
</Note>

<div id="overview">
  ## 概览
</div>

[Stripe Projects](https://projects.dev) 可在终端中开通第三方服务，并将其凭据同步到你的 `.env` 文件。Firecrawl 是其中一个提供商，因此一条命令即可创建 Firecrawl 账户、把 API 密钥写入项目，并让你选择方案。付费方案通过你 Stripe 账户上的支付方式扣款。

| 你将获得          | 详情                                                            |
| ------------- | ------------------------------------------------------------- |
| **账户**        | 以你 Stripe 账户邮箱为标识的 Firecrawl 账户。若该邮箱已有 Firecrawl 账户，则直接复用。    |
| **API 密钥**    | 写入 `.env` 的 workspace API 密钥。一个密钥即可调用所有 Firecrawl endpoint。   |
| **方案**        | 默认值为 Free。可在 CLI 中升级到 Hobby (入门) 、Standard 或 Growth，按月或按年计费。  |
| **Dashboard** | 运行 `stripe projects open firecrawl` 即可登录 Firecrawl dashboard。 |

<div id="quick-start">
  ## 快速开始
</div>

```bash theme={null}
stripe plugin install projects
stripe projects init
stripe projects add firecrawl/api --name firecrawl
stripe projects env --pull
```

`--name firecrawl` 用于设置本地资源名称，该名称会成为 CLI 写入的变量的前缀。加上它后，密钥会写入 `FIRECRAWL_API_KEY`，Firecrawl [SDKs](/zh/sdks/overview) 和 [CLI](/zh/sdks/cli) 会自动读取该变量。不加时，资源名为 `firecrawl-api`，密钥则会写入 `FIRECRAWL_API_API_KEY`。

CLI 还会写入 `FIRECRAWL_API_BASE_URL` 和 `FIRECRAWL_DOCUMENTATION_URL`，这两个变量仅供参考。SDKs 读取的是 `FIRECRAWL_API_URL`，且仅在自托管部署时使用；通过 Stripe 开通的账户使用的是托管 API (即默认方式) ，因此请不要设置 `FIRECRAWL_API_URL`。

接下来，可参照 [Node.js](/zh/quickstarts/nodejs) 或 [Python](/zh/quickstarts/python) 快速上手指南，其他语言请查看 [SDK 概览](/zh/sdks/overview)。该密钥适用于所有 endpoint：[search](/zh/features/search)、[scrape](/zh/features/scrape)、[crawl](/zh/features/crawl)、[map](/zh/features/map)、[extract](/zh/features/extract)、[交互](/zh/features/interact)、[解析](/zh/features/parse) 和[监控](/zh/features/monitoring)。

<div id="catalog">
  ## 目录
</div>

运行 `stripe projects catalog firecrawl` 查看实时列表。在你确认之前，CLI 会先显示最终价格。

| Slug                 | 类型 | 说明                                         |
| -------------------- | -- | ------------------------------------------ |
| `firecrawl/api`      | 服务 | Firecrawl API。开通账户并生成 API 密钥。默认使用 Free 档位。 |
| `firecrawl/free`     | 方案 | Free 套餐，无需绑定银行卡。                           |
| `firecrawl/hobby`    | 方案 | Hobby (入门) 方案，需选择 `Monthly` 或 `Yearly`。    |
| `firecrawl/standard` | 方案 | Standard 方案，需选择 `Monthly` 或 `Yearly`。      |
| `firecrawl/growth`   | 方案 | Growth 方案，需选择 `Monthly` 或 `Yearly`。        |

方案与价格均与 [firecrawl.dev/pricing](https://www.firecrawl.dev/pricing) 一致。Scale (扩展) 和 Enterprise 不通过 Stripe Projects 提供，如有需要请[联系我们](https://www.firecrawl.dev/enterprise)。

<div id="manage-the-resource">
  ## 管理资源
</div>

```bash theme={null}
# 为你的 Stripe 账户添加支付方式（只需一次）
stripe projects billing add

# 切换到付费方案；CLI 会询问选择哪个方案以及哪种计费周期
stripe projects upgrade firecrawl

# 轮换 API 密钥，然后将新值拉取到 .env
stripe projects rotate firecrawl
stripe projects env --pull

# 从此项目中移除 Firecrawl
stripe projects remove firecrawl
```

升级通过 Stripe [共享支付令牌](https://docs.stripe.com/agentic-commerce/concepts/shared-payment-tokens)完成，因此 Firecrawl 始终不会接触到你的银行卡信息。该方案会像其他订阅一样显示在你的 Firecrawl dashboard 中。若要退回 Free，请运行 `stripe projects upgrade firecrawl` 并选择 `free`，或在 dashboard 的 [计费](https://www.firecrawl.dev/app/settings?tab=billing) 中更改方案。

<div id="accounts-and-billing">
  ## 账户与计费
</div>

* **一个 Stripe 账户对应一个 Firecrawl 账户。** Firecrawl 会读取你 Stripe 账户的邮箱。若为新邮箱，则创建一个新的 Firecrawl 账户，该账户已验证，并自带一个团队和一个默认 API 密钥。若该邮箱已有 Firecrawl 账户，则复用此前通过 Stripe 关联的团队；首次关联时，会在其自有组织下新建一个名为 `via stripe` 的团队，使 Stripe 计费与你的其他 Firecrawl 团队相互独立。
* **Stripe 账户下的所有成员都可以通过 Projects 操作所关联的 Firecrawl 账户**，这与 Stripe 的模型一致。Firecrawl dashboard 会在该 Stripe 账户的邮箱下显示此账户。
* **付费方案即 Firecrawl 订阅**，通过你的共享支付令牌支付，并由 `stripe projects spend` 上报。额度、限流和功能与在 firecrawl.dev 上购买的同一方案完全相同。

<div id="coding-agents">
  ## 编码代理
</div>

Stripe Projects 既面向人类，也面向代理。Stripe 发布了一个[技能](https://docs.stripe.com/projects#coding-agent)，可向 Claude Code、Cursor、Codex 等代理讲解 Projects CLI 的用法；而 `stripe projects llm-context` 会将本页内容与项目中其他所有提供商的指南一并打包。

```bash theme={null}
npx skills add https://docs.stripe.com --skill stripe-projects -g -y
```

当代理开通 Firecrawl 时：请从 `stripe projects catalog firecrawl --json` 的输出中复制 slug，不要凭猜测填写；传入 `--name firecrawl`；运行 `stripe projects env --pull`，并使用环境变量中的 `FIRECRAWL_API_KEY`，不要直接编辑 `.env`；付费升级请交由人类操作，因为这会从 Stripe 账户绑定的银行卡扣款。`--accept-tos` 会代表人类接受 [Firecrawl 服务条款](https://www.firecrawl.dev/terms-of-service)，因此请先与其确认。代理配置方式的其余内容请参阅 [Build with AI](/zh/ai-onboarding)。

<div id="troubleshooting">
  ## 故障排查
</div>

| 问题现象                                             | 解决方法                                                                                   |
| ------------------------------------------------ | -------------------------------------------------------------------------------------- |
| `Provider connection requires re-authentication` | 运行 `stripe projects link firecrawl`，然后重试。                                              |
| `Unknown provider or category: firecrawl`        | 依次运行 `stripe plugin upgrade projects` 和 `stripe projects catalog firecrawl --refresh`。 |
| 付费开通失败                                           | 运行 `stripe projects billing add` 确认支付方式。如果你的 Firecrawl 账户已有付费方案，请直接在 Dashboard 中更改。    |
| 密钥出现在 `FIRECRAWL_API_API_KEY` 中                  | 说明开通时未指定 `--name`。可将其导出为 `FIRECRAWL_API_KEY`，或删除该资源后加上 `--name firecrawl` 重新添加。        |

仍未解决？请发送邮件至 [help@firecrawl.com](mailto:help@firecrawl.com)，并附上错误信息中的 Stripe request id。

<div id="resources">
  ## 资源
</div>

* [Stripe Projects 文档](https://docs.stripe.com/projects)
* [提供商名录](https://projects.dev/providers/)和[模板](https://projects.dev/templates/)；Shopify Trending Products 模板已集成 Firecrawl
* [Firecrawl 定价](https://www.firecrawl.dev/pricing)
* 获取密钥的其他方式：[Dashboard](https://www.firecrawl.dev/app/api-keys)、[Vercel Marketplace](/zh/quickstarts/vercel-marketplace)；如果你运营平台，也可使用[合作伙伴 API](/zh/partner-integration)