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

# Tines

> Chame busca, scraping, extração, map e rastreamento do Firecrawl a partir de stories do Tines com actions HTTP Request

<Note>
  **Documentação do Tines:** [Action HTTP Request](https://www.tines.com/docs/actions/types/http-request/) e [Credenciais](https://www.tines.com/docs/credentials/)

  Adicione dados da web em tempo real do Firecrawl às stories do Tines
</Note>

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

Os stories do Tines podem chamar qualquer API REST com a action HTTP Request. Ao apontar essa action para a API do Firecrawl, um story pode fazer uma busca na web, fazer scraping de uma página e convertê-la em markdown, extrair dados estruturados, mapear um site ou rastreá-lo e repassar o resultado para a próxima action do story.

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

1. [Crie uma chave de API do Firecrawl](https://www.firecrawl.dev/app/api-keys)
2. No Tines, abra **Credenciais**, crie uma credencial do tipo **Text** chamada `firecrawl` e cole a chave como valor
3. Adicione uma action **HTTP Request** à sua story e configure-a conforme mostrado abaixo

Ao referenciar a chave como `<<CREDENTIAL.firecrawl>>`, você a mantém fora da configuração da action.

<h2 id="scrape-a-page">
  Fazer scraping de uma página
</h2>

Esta action envia uma solicitação de raspagem e retorna a página em markdown:

```json theme={null}
{
  "url": "https://api.firecrawl.dev/v2/scrape",
  "method": "post",
  "content_type": "json",
  "headers": {
    "Authorization": "Bearer <<CREDENTIAL.firecrawl>>"
  },
  "payload": {
    "url": "https://example.com",
    "formats": ["markdown"],
    "integration": "_tines"
  }
}
```

Substitua `https://example.com` por uma URL vinda de um evento upstream, por exemplo, `<<receive_event.body.url>>`. O campo opcional `integration` identifica as requisições originadas do Tines.

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

| Capacidade | Endpoint | Caso de uso |
| - | - | - |
| **Pesquisar** | `POST /v2/search` | Encontrar fontes para uma pergunta ou alerta antes de executar outras actions |
| **Raspar** | `POST /v2/scrape` | Transformar uma URL em markdown ou JSON estruturado |
| **Extrair** | `POST /v2/scrape` com o formato `json` | Obter campos como título ou detalhes de produto usando um prompt e um schema |
| **Mapear** | `POST /v2/map` | Listar as URLs de um site |
| **Rastrear** | `POST /v2/crawl` | Coletar páginas de todo um site e depois consultar o resultado |

Todos os endpoints usam a URL base `https://api.firecrawl.dev`, o mesmo cabeçalho `Authorization` e um corpo JSON.

<h2 id="search-the-web">
  Fazer uma busca na web
</h2>

```json theme={null}
{
  "url": "https://api.firecrawl.dev/v2/search",
  "method": "post",
  "content_type": "json",
  "headers": {
    "Authorization": "Bearer <<CREDENTIAL.firecrawl>>"
  },
  "payload": {
    "query": "firecrawl web scraping",
    "limit": 5,
    "sources": ["web"],
    "integration": "_tines"
  }
}
```

<h2 id="extract-structured-data">
  Extrair dados estruturados
</h2>

Defina a entrada de `formats` com o tipo `json`, junto com um prompt e um schema JSON:

```json theme={null}
{
  "url": "https://api.firecrawl.dev/v2/scrape",
  "method": "post",
  "content_type": "json",
  "headers": {
    "Authorization": "Bearer <<CREDENTIAL.firecrawl>>"
  },
  "payload": {
    "url": "https://example.com",
    "formats": [
      {
        "type": "json",
        "prompt": "Extract the page title",
        "schema": {
          "type": "object",
          "properties": { "title": { "type": "string" } }
        }
      }
    ],
    "integration": "_tines"
  }
}
```

<h2 id="crawl-a-site">
  Rastrear um site
</h2>

O rastreamento é executado de forma assíncrona. Use uma action para iniciá-lo e outra para ler o resultado.

**Inicie o rastreamento** com `POST /v2/crawl`:

```json theme={null}
{
  "url": "https://api.firecrawl.dev/v2/crawl",
  "method": "post",
  "content_type": "json",
  "headers": {
    "Authorization": "Bearer <<CREDENTIAL.firecrawl>>"
  },
  "payload": {
    "url": "https://example.com",
    "limit": 10,
    "integration": "_tines"
  }
}
```

A resposta inclui um `id`. **Verifique o status** com uma segunda action HTTP Request que consulta o rastreamento por esse `id` e repita-a até que o `status` seja `completed`:

```json theme={null}
{
  "url": "https://api.firecrawl.dev/v2/crawl/<<start_crawl.body.id>>",
  "method": "get",
  "headers": {
    "Authorization": "Bearer <<CREDENTIAL.firecrawl>>"
  }
}
```

Aqui, `start_crawl` é o nome da action que iniciou o rastreamento.

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

* [Action HTTP Request do Tines](https://www.tines.com/docs/actions/types/http-request/)
* [Credenciais do Tines](https://www.tines.com/docs/credentials/)
* [Introdução à API do Firecrawl](/pt-BR/api-reference/v2-introduction)
* [Documentação de scraping do Firecrawl](/pt-BR/features/scrape)
* [Documentação de rastreamento do Firecrawl](/pt-BR/features/crawl)


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