> ## Documentation Index
> Fetch the complete documentation index at: https://firecrawl-claude-eager-dijkstra-ul56gh.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Stripe Projects

> Provisione uma conta, uma API key e um plano do Firecrawl pela CLI do Stripe Projects

<Note>
  **Documentação oficial da Stripe:** [docs.stripe.com/projects](https://docs.stripe.com/projects) · [Firecrawl no diretório de providers](https://projects.dev/providers/)

  O Firecrawl é um provider do Stripe Projects. Adicione-o a qualquer projeto com `stripe projects add firecrawl/api`.
</Note>

<h2 id="overview">
  Visão geral
</h2>

O [Stripe Projects](https://projects.dev) provisiona serviços de terceiros pelo terminal e sincroniza suas credenciais com o seu `.env`. O Firecrawl é um dos providers, então um único comando cria uma conta no Firecrawl, grava uma API key no seu projeto e permite escolher um plano. Os planos pagos são cobrados no método de pagamento da sua conta Stripe.

| O que você recebe | Detalhe |
| - | - |
| **Conta** | Uma conta Firecrawl vinculada ao email da sua conta Stripe. Se esse email já tiver uma conta Firecrawl, ela é reaproveitada. |
| **API key** | Uma API key do espaço de trabalho gravada no seu `.env`. Uma única key cobre todos os endpoints do Firecrawl. |
| **Plano** | Free por padrão. Faça upgrade para Hobby, Standard ou Growth, mensal ou anual, pela CLI. |
| **Painel** | `stripe projects open firecrawl` conecta você ao painel do Firecrawl. |

<h2 id="quick-start">
  Início rápido
</h2>

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

`--name firecrawl` define o nome do recurso local, que se torna o prefixo das variáveis gravadas pela CLI. Com ele, a key vai para `FIRECRAWL_API_KEY`, que os [SDKs](/pt-BR/sdks/overview) e a [CLI](/pt-BR/sdks/cli) do Firecrawl leem automaticamente. Sem ele, o recurso passa a se chamar `firecrawl-api` e a key vai para `FIRECRAWL_API_API_KEY`.

A CLI também grava `FIRECRAWL_API_BASE_URL` e `FIRECRAWL_DOCUMENTATION_URL`. Ambas são apenas informativas. Os SDKs leem `FIRECRAWL_API_URL` somente em implantações self-hosted; uma account provisionada pelo Stripe usa a API hospedada, que é o padrão, então deixe `FIRECRAWL_API_URL` sem definição.

Daqui em diante, siga o guia de início rápido de [Node.js](/pt-BR/quickstarts/nodejs) ou [Python](/pt-BR/quickstarts/python), ou a [visão geral dos SDKs](/pt-BR/sdks/overview) para outras linguagens. A key funciona com todos os endpoints: [search](/pt-BR/features/search), [scrape](/pt-BR/features/scrape), [crawl](/pt-BR/features/crawl), [map](/pt-BR/features/map), [extract](/pt-BR/features/extract), [interact](/pt-BR/features/interact), [parse](/pt-BR/features/parse) e [monitor](/pt-BR/features/monitoring).

<h2 id="catalog">
  Catálogo
</h2>

Execute `stripe projects catalog firecrawl` para ver a lista atualizada. A CLI mostra o preço final antes de você confirmar qualquer coisa.

| Slug | Tipo | O que é |
| - | - | - |
| `firecrawl/api` | Serviço | A API do Firecrawl. Provisiona a conta e a API key. Tier Free por padrão. |
| `firecrawl/free` | Plano | O plano Free. Não precisa de cartão. |
| `firecrawl/hobby` | Plano | O plano Hobby. Pergunta se é `Monthly` ou `Yearly`. |
| `firecrawl/standard` | Plano | O plano Standard. Pergunta se é `Monthly` ou `Yearly`. |
| `firecrawl/growth` | Plano | O plano Growth. Pergunta se é `Monthly` ou `Yearly`. |

Os planos e preços são os mesmos de [firecrawl.dev/pricing](https://www.firecrawl.dev/pricing). Scale e Enterprise não são oferecidos via Stripe Projects; nesses casos, [fale com a gente](https://www.firecrawl.dev/enterprise).

<h2 id="manage-the-resource">
  Gerenciar o recurso
</h2>

```bash theme={null}
# Adicione um método de pagamento à sua conta Stripe uma única vez
stripe projects billing add

# Mude para um plano pago; a CLI pergunta qual plano e qual intervalo de cobrança
stripe projects upgrade firecrawl

# Rotacione a API key e depois traga o novo valor para o .env
stripe projects rotate firecrawl
stripe projects env --pull

# Remova o Firecrawl deste projeto
stripe projects remove firecrawl
```

Os upgrades usam um [Shared Payment Token](https://docs.stripe.com/agentic-commerce/concepts/shared-payment-tokens) da Stripe, ou seja, a Firecrawl nunca tem acesso aos dados do seu cartão. O plano aparece no seu painel da Firecrawl como qualquer outra assinatura. Para voltar ao Free, execute `stripe projects upgrade firecrawl` e escolha `free`, ou altere o plano em [Billing](https://www.firecrawl.dev/app/settings?tab=billing) no painel.

<h2 id="accounts-and-billing">
  Contas e cobrança
</h2>

* **Uma conta Stripe, uma conta Firecrawl.** O Firecrawl consulta o e-mail da sua conta Stripe. Um e-mail novo recebe uma nova conta Firecrawl, já verificada, com uma equipe e uma API key padrão. Um e-mail que já possui uma conta Firecrawl reutiliza a equipe que ele vinculou anteriormente via Stripe; na primeira vez, é criada uma nova equipe chamada `via stripe` em uma organização própria, para que a cobrança do Stripe fique separada das suas outras equipes Firecrawl.
* **Todos na conta Stripe podem atuar na conta Firecrawl vinculada** por meio dos Projects, seguindo o modelo do Stripe. O painel do Firecrawl exibe a conta sob o e-mail da conta Stripe.
* **Os planos pagos são assinaturas do Firecrawl**, pagas com seu Shared Payment Token e informadas por `stripe projects spend`. Créditos, limites de taxa e recursos são os mesmos do plano equivalente adquirido em firecrawl.dev.
* **Remover o recurso cancela o plano dele.** A conta e a API key permanecem.

<h2 id="coding-agents">
  Coding agents
</h2>

O Stripe Projects foi criado tanto para agentes quanto para pessoas. A Stripe publica uma [skill](https://docs.stripe.com/projects#coding-agent) que ensina a CLI do Projects ao Claude Code, Cursor, Codex e outros agentes, e o `stripe projects llm-context` reúne esta página com as orientações de todos os outros providers do projeto.

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

Quando um agente provisiona o Firecrawl: copie o slug de `stripe projects catalog firecrawl --json` em vez de adivinhá-lo, passe `--name firecrawl`, execute `stripe projects env --pull` e use a `FIRECRAWL_API_KEY` do ambiente em vez de editar o `.env`, e deixe os upgrades pagos para o humano, já que eles geram cobrança no cartão da conta Stripe. O `--accept-tos` aceita os [Termos de Serviço do Firecrawl](https://www.firecrawl.dev/terms-of-service) em nome do humano, portanto confirme com ele antes. O restante da configuração do agente está em [Desenvolva com IA](/pt-BR/ai-onboarding).

<h2 id="troubleshooting">
  Solução de problemas
</h2>

| O que você vê | O que fazer |
| - | - |
| `Provider connection requires re-authentication` | Execute `stripe projects link firecrawl` e tente novamente. |
| `Unknown provider or category: firecrawl` | Execute `stripe plugin upgrade projects` e, em seguida, `stripe projects catalog firecrawl --refresh`. |
| O provisionamento pago falha | Execute `stripe projects billing add` para confirmar um método de pagamento. Se a sua conta Firecrawl já tiver um plano pago, altere-o pelo painel. |
| A chave vai parar em `FIRECRAWL_API_API_KEY` | Você fez o provisionamento sem `--name`. Exporte-a como `FIRECRAWL_API_KEY` ou remova o recurso e adicione-o novamente com `--name firecrawl`. |

Ainda com problemas? Envie um e-mail para [help@firecrawl.com](mailto:help@firecrawl.com) com o request id da Stripe exibido no erro.

<h2 id="resources">
  Recursos
</h2>

* [Documentação do Stripe Projects](https://docs.stripe.com/projects)
* [Diretório de provedores](https://projects.dev/providers/) e [modelos](https://projects.dev/templates/); o modelo Shopify Trending Products já vem com o Firecrawl
* [Preços do Firecrawl](https://www.firecrawl.dev/pricing)
* Outras formas de obter uma chave: o [painel](https://www.firecrawl.dev/app/api-keys), o [Marketplace da Vercel](/pt-BR/quickstarts/vercel-marketplace) ou a [Partner API](/pt-BR/partner-integration), caso você opere uma plataforma


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.