> ## 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

> Provision a Firecrawl account, API key, and plan from the Stripe Projects CLI

<Note>
  **Official Stripe docs:** [docs.stripe.com/projects](https://docs.stripe.com/projects) · [Firecrawl in the provider directory](https://projects.dev/providers/)

  Firecrawl is a Stripe Projects provider. Add it to any project with `stripe projects add firecrawl/api`.
</Note>

## Overview

[Stripe Projects](https://projects.dev) provisions third-party services from the terminal and syncs their credentials to your `.env`. Firecrawl is one of the providers, so one command creates a Firecrawl account, writes an API key into your project, and lets you pick a plan. Paid plans bill through the payment method on your Stripe account.

| You get       | Detail                                                                                                                 |
| ------------- | ---------------------------------------------------------------------------------------------------------------------- |
| **Account**   | A Firecrawl account keyed on your Stripe account's email. If that email already has a Firecrawl account, it is reused. |
| **API key**   | A workspace API key written to your `.env`. One key covers every Firecrawl endpoint.                                   |
| **Plan**      | Free by default. Upgrade to Hobby, Standard, or Growth, monthly or yearly, from the CLI.                               |
| **Dashboard** | `stripe projects open firecrawl` signs you in to the Firecrawl dashboard.                                              |

## Quick start

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

`--name firecrawl` sets the local resource name, which becomes the prefix of the variables the CLI writes. With it the key lands in `FIRECRAWL_API_KEY`, which the Firecrawl [SDKs](/sdks/overview) and [CLI](/sdks/cli) read automatically. Without it, the resource is called `firecrawl-api` and the key lands in `FIRECRAWL_API_API_KEY`.

The CLI also writes `FIRECRAWL_API_BASE_URL` and `FIRECRAWL_DOCUMENTATION_URL`. Both are informational. The SDKs read `FIRECRAWL_API_URL`, and only for self-hosted deployments; a Stripe-provisioned account uses the hosted API, which is the default, so leave `FIRECRAWL_API_URL` unset.

From here, follow the [Node.js](/quickstarts/nodejs) or [Python](/quickstarts/python) quickstart, or the [SDK overview](/sdks/overview) for other languages. The key works with every endpoint: [search](/features/search), [scrape](/features/scrape), [crawl](/features/crawl), [map](/features/map), [extract](/features/extract), [interact](/features/interact), [parse](/features/parse), and [monitor](/features/monitoring).

## Catalog

Run `stripe projects catalog firecrawl` for the live list. The CLI shows the final price before you confirm anything.

| Slug                 | Kind    | What it is                                                                       |
| -------------------- | ------- | -------------------------------------------------------------------------------- |
| `firecrawl/api`      | Service | The Firecrawl API. Provisions the account and the API key. Free tier by default. |
| `firecrawl/free`     | Plan    | The Free plan. No card needed.                                                   |
| `firecrawl/hobby`    | Plan    | The Hobby plan. Asks for `Monthly` or `Yearly`.                                  |
| `firecrawl/standard` | Plan    | The Standard plan. Asks for `Monthly` or `Yearly`.                               |
| `firecrawl/growth`   | Plan    | The Growth plan. Asks for `Monthly` or `Yearly`.                                 |

Plans and prices match [firecrawl.dev/pricing](https://www.firecrawl.dev/pricing). Scale and Enterprise are not offered through Stripe Projects; [talk to us](https://www.firecrawl.dev/enterprise) for those.

## Manage the resource

```bash theme={null}
# Add a payment method to your Stripe account once
stripe projects billing add

# Move to a paid plan; the CLI asks which plan and which billing interval
stripe projects upgrade firecrawl

# Rotate the API key, then pull the new value into .env
stripe projects rotate firecrawl
stripe projects env --pull

# Remove Firecrawl from this project
stripe projects remove firecrawl
```

Upgrades use a Stripe [Shared Payment Token](https://docs.stripe.com/agentic-commerce/concepts/shared-payment-tokens), so Firecrawl never sees your card details. The plan shows up in your Firecrawl dashboard like any other subscription. To go back to Free, run `stripe projects upgrade firecrawl` and pick `free`, or change the plan from [Billing](https://www.firecrawl.dev/app/settings?tab=billing) in the dashboard.

## Accounts and billing

* **One Stripe account, one Firecrawl account.** Firecrawl looks up your Stripe account's email. A new email gets a new Firecrawl account, already verified, with a team and a default API key. An email that already has a Firecrawl account reuses the team it linked through Stripe before; the first time, it gets a new team named `via stripe` in its own organization, so Stripe billing stays separate from your other Firecrawl teams.
* **Everyone on the Stripe account can act on the linked Firecrawl account** through Projects, in line with Stripe's model. The Firecrawl dashboard shows the account under the Stripe account's email.
* **Paid plans are Firecrawl subscriptions**, paid with your Shared Payment Token and reported by `stripe projects spend`. Credits, rate limits, and features match the same plan bought on firecrawl.dev.

## Coding agents

Stripe Projects is built for agents as much as for people. Stripe publishes a [skill](https://docs.stripe.com/projects#coding-agent) that teaches Claude Code, Cursor, Codex, and other agents the Projects CLI, and `stripe projects llm-context` bundles this page with the guidance of every other provider in the project.

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

When an agent provisions Firecrawl: copy the slug from `stripe projects catalog firecrawl --json` rather than guessing it, pass `--name firecrawl`, run `stripe projects env --pull` and use `FIRECRAWL_API_KEY` from the environment rather than editing `.env`, and leave paid upgrades to the human, since they charge the card on the Stripe account. `--accept-tos` accepts the [Firecrawl Terms of Service](https://www.firecrawl.dev/terms-of-service) on the human's behalf, so confirm with them first. The rest of the agent setup is on [Build with AI](/ai-onboarding).

## Troubleshooting

| What you see                                     | What to do                                                                                                                                              |
| ------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Provider connection requires re-authentication` | Run `stripe projects link firecrawl`, then retry.                                                                                                       |
| `Unknown provider or category: firecrawl`        | Run `stripe plugin upgrade projects`, then `stripe projects catalog firecrawl --refresh`.                                                               |
| Paid provisioning fails                          | Run `stripe projects billing add` to confirm a payment method. If your Firecrawl account already has a paid plan, change it from the dashboard instead. |
| The key lands in `FIRECRAWL_API_API_KEY`         | You provisioned without `--name`. Export it as `FIRECRAWL_API_KEY`, or remove the resource and add it again with `--name firecrawl`.                    |

Still stuck? Email [help@firecrawl.com](mailto:help@firecrawl.com) with the Stripe request id from the error.

## Resources

* [Stripe Projects docs](https://docs.stripe.com/projects)
* [Provider directory](https://projects.dev/providers/) and [templates](https://projects.dev/templates/); the Shopify Trending Products template bundles Firecrawl
* [Firecrawl pricing](https://www.firecrawl.dev/pricing)
* Other ways to get a key: the [dashboard](https://www.firecrawl.dev/app/api-keys), the [Vercel Marketplace](/quickstarts/vercel-marketplace), or the [Partner API](/partner-integration) if you run a platform
