Pular para o conteúdo principal

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.

FIRE-1 é um agente de IA que potencializa os recursos de scraping do Firecrawl por meio de navegação e interação inteligentes na web. Ele lida com paginação, controla ações do navegador e percorre estruturas complexas de sites para viabilizar uma extração de dados mais completa do que os métodos tradicionais de scraping.

​
O que o FIRE-1 pode fazer:

  • Navegar automaticamente por conteúdo paginado.
  • Interagir com botões, links, campos e elementos dinâmicos.
  • Realizar tarefas avançadas de extração em várias páginas.

​
Ativando o FIRE-1 (Agente)

Para ativar o agente FIRE-1, inclua o objeto agent no payload da sua requisição de API para os endpoints scrape ou extract. O objeto agent possui as seguintes propriedades:
  • model (string, opcional): Especifica o modelo de IA a ser usado. Se não for fornecido, o padrão é FIRE-1. Atualmente, FIRE-1 é o único modelo disponível.
  • prompt (string, obrigatório para o endpoint scrape): Fornece instruções para o agente de IA, descrevendo que conteúdo buscar e como navegar no site (por exemplo, como lidar com paginação, quais botões clicar, etc.). Em /extract, ele usará o prompt fornecido no parâmetro prompt.

​
Usando o FIRE-1 com o endpoint /scrape

Você pode usar o FIRE-1 (Agente) com o endpoint /v1/scrape para aplicar navegação inteligente antes de fazer o scrape do conteúdo final. Exemplo (cURL): 
curl -X POST https://api.firecrawl.dev/v1/scrape \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer SUA_CHAVE_DE_API' \
    -d '{
      "url": "https://example.com/products?page=1",
      "formats": ["markdown"],
      "agent": {
        "model": "FIRE-1",
        "prompt": "Navegue pelas listagens de produtos clicando no botão “Próxima página” até que ele fique desativado. Extraia o conteúdo de cada página visitada."
      }
    }'
Neste exemplo, o FIRE-1 (Agente) é instruído a navegar pela paginação das listagens de produtos antes que a raspagem final seja executada.

​
Usando o FIRE-1 com o endpoint Extract

Da mesma forma, você pode usar o FIRE-1 (Agente) com o endpoint /v1/extract para tarefas complexas de extração que exigem navegação por várias páginas ou interação com elementos. Exemplo (cURL): 
curl -X POST https://api.firecrawl.dev/v1/extract \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer YOUR_API_KEY' \
    -d '{
      "urls": ["https://example-forum.com/topic/123"],
      "prompt": "Extract all user comments from this forum thread.",
      "schema": {
        "type": "object",
        "properties": {
          "comments": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "author": {"type": "string"},
                "comment_text": {"type": "string"}
              },
              "required": ["author", "comment_text"]
            }
          }
        },
        "required": ["comments"]
      },
      "agent": {
        "model": "FIRE-1"
      }
    }'
Aqui, o agente garante que todos os comentários sejam carregados na página ao interagir com o botão “Carregar mais comentários” antes de iniciar o processo de extração com base no schema e no prompt fornecidos. Observação: O FIRE-1 (Agente) oferece recursos avançados, mas pode consumir mais créditos dependendo da complexidade das instruções de navegação e da quantidade de páginas com as quais interage.

​
Conheça o FIRE-1: Navegação e Interação Inteligentes

Visualização do FIRE-1 (Agente) O FIRE-1 leva a inteligência do Firecrawl a um novo patamar, aprimorando suas tarefas de scraping com navegação por estruturas complexas de sites, tratamento de paginação, interação com conteúdo dinâmico e muito mais. Esse poderoso agente de IA garante uma extração abrangente de dados, indo além dos métodos tradicionais de scraping.

​
O que o FIRE-1 pode fazer:

  • Navegar automaticamente por conteúdos paginados.
  • Interagir com botões, links e elementos dinâmicos.
  • Realizar tarefas avançadas de extração em várias páginas.

​
Como habilitar o FIRE-1

Ativar o FIRE-1 é simples. Basta incluir um objeto agent na sua solicitação à API de scrape ou extract: 
"agent": {
  "model": "FIRE-1",
  "prompt": "Insira aqui suas instruções detalhadas de navegação."
}
Nota: O campo prompt é obrigatório em solicitações ao endpoint /scrape, indicando exatamente ao FIRE-1 como interagir com a página da web.

​
Exemplo de uso com o endpoint /scrape

Veja um exemplo rápido usando o FIRE-1 com o endpoint /scrape para paginar entre listagens de produtos: 
curl -X POST https://api.firecrawl.dev/v1/scrape \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{
    "url": "https://example.com/products?page=1",
    "formats": ["markdown"],
    "agent": {
      "model": "FIRE-1",
      "prompt": "Navigate through the product listings by clicking the \'Next Page\' button until disabled. Scrape each page."
    }
  }'
Neste cenário, o FIRE-1 navega pela paginação de forma inteligente e coleta todos os produtos.

​
Considerações

  • O uso do FIRE-1 pode consumir mais créditos, dependendo da complexidade da tarefa e da profundidade da interação.
  • Certifique-se de que seus prompts orientem claramente o FIRE-1 para otimizar os resultados e a eficiência.

​
Comece a usar o FIRE-1 hoje

Experimente o futuro do web scraping hoje: