> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firecrawl.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Pesquisa na web e scraping via MCP no Goose

> Adicione a pesquisa na web e a raspagem do Firecrawl ao Goose

Conecte o Firecrawl ao Goose como uma extensão remota para que o Goose possa fazer uma busca na web e ler páginas pelo servidor MCP hospedado.

<h2 id="requirements">
  Requisitos
</h2>

* Goose 1.55 ou superior.
* Uma [chave de API do Firecrawl](https://www.firecrawl.dev/app/api-keys), exportada como `FIRECRAWL_API_KEY`.

<h2 id="quick-setup">
  Configuração rápida
</h2>

1. Exporte sua API key no shell em que você inicia o Goose:

```bash theme={null}
export FIRECRAWL_API_KEY="fc-YOUR-API-KEY"
```

2. Adicione a extensão à seção `extensions` do arquivo `~/.config/goose/config.yaml`:

```yaml theme={null}
extensions:
  firecrawl:
    type: streamable_http
    name: firecrawl
    enabled: true
    uri: https://mcp.firecrawl.dev/v2/mcp
    headers:
      Authorization: "Bearer $FIRECRAWL_API_KEY"
    env_keys:
      - FIRECRAWL_API_KEY
    timeout: 300
```

3. Inicie uma sessão e peça ao Goose para fazer uma busca ou scraping:

```bash theme={null}
goose session
```

<Warning>
  Escreva o cabeçalho como `$FIRECRAWL_API_KEY`, sem chaves ({ }), e mantenha `env_keys` no lugar. Caso contrário, o Goose envia `${FIRECRAWL_API_KEY}` como texto literal, e o servidor rejeita a request.
</Warning>

Veja [Configurar uma API key](/pt-BR/mcp-server/keyless#add-an-api-key) para saber mais sobre chaves.

<h2 id="try-it">
  Experimente
</h2>

```text theme={null}
Faça uma busca na web pelas notas de versão mais recentes do Rust e resuma as fontes.
```

```text theme={null}
Faça scraping de https://firecrawl.dev e explique o que ele faz.
```

<h2 id="what-you-can-do">
  O que você pode fazer
</h2>

<CardGroup cols={2}>
  <Card title="Busca" icon="magnifying-glass" href="/pt-BR/features/search">
    Encontre informações atualizadas e leia o conteúdo dos resultados relevantes.
  </Card>

  <Card title="Scraping" icon="file-lines" href="/pt-BR/features/scrape">
    Converta URLs em markdown limpo ou dados estruturados.
  </Card>

  <Card title="Interagir" icon="hand-pointer" href="/pt-BR/features/interact">
    Navegue, clique e preencha formulários para chegar aos dados de que você precisa.
  </Card>

  <Card title="Alexandria" icon="books" href="/pt-BR/features/alexandria">
    Descubra ferramentas de dados estruturados, confira as entradas e os preços e execute-as pelo Firecrawl.
  </Card>
</CardGroup>

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

* **A chave é apontada como inválida ou revogada:** verifique se o cabeçalho usa `$FIRECRAWL_API_KEY` sem chaves e se `FIRECRAWL_API_KEY` foi exportada no shell que inicia o Goose.
* **A extensão não aparece:** execute `goose session` novamente depois de salvar o arquivo e confirme que `enabled: true` está definido.
* **As chamadas excedem o tempo limite:** aumente o valor de `timeout`. A raspagem de uma página grande pode levar mais tempo que o padrão.
* **As ferramentas não são usadas:** alguns modelos chamam ferramentas MCP de forma mais confiável que outros. Experimente outro modelo.


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