/interact para começar a realizar ações nessa página - clicar em botões, preencher formulários, extrair conteúdo dinâmico ou navegar mais profundamente. Basta descrever o que você quer, ou escrever código se precisar de controle total.
Prompts de IA
Descreva a ação que você quer executar na página
Execução de código
Interaja com segurança por meio da execução de código usando playwright, agent-browser
Visualização em tempo real
Assista ou interaja com o navegador em tempo real por meio de um stream incorporável
Como funciona
- Faça o scraping de uma URL com
POST /v2/scrape. A resposta inclui umscrapeIdemdata.metadata.scrapeId. Opcionalmente, passe umprofilepara persistir o estado do navegador entre sessões. - Interaja chamando
POST /v2/scrape/{scrapeId}/interactcom umpromptou comcodedo Playwright. Na primeira chamada, a sessão extraída é retomada e você pode começar a interagir com a página. - Encerre a sessão com
DELETE /v2/scrape/{scrapeId}/interactquando terminar.
Início rápido
Response
Interaja usando prompts
output com a resposta do agente:
Response
Mantenha os Prompts Pequenos e Focados
interact separadas. Cada chamada reutiliza a mesma sessão do navegador, então o estado é mantido entre elas.
Executando código
page (um objeto Page do Playwright) está disponível tanto em Node.js quanto em Python. O modo Bash vem com agent-browser pré-instalado. Você também pode fazer capturas de tela na sessão — use (await page.screenshot()).toString("base64") em Node.js, await page.screenshot(path="/tmp/screenshot.png") em Python ou agent-browser screenshot no Bash.
Node.js (Playwright)
page já está conectado ao navegador.
Python
language como "python" para a API do Python do Playwright.
Bash (agent-browser)
@e1, @e2, …) — ideal para automação conduzida por LLM.
Visualização em tempo real
interact retorna uma liveViewUrl que você pode incorporar para acompanhar o navegador em tempo real. Útil para depuração, demonstrações ou para criar UIs com navegador.
Response
Visualização em tempo real interativa
interactiveLiveViewUrl. Diferentemente da visualização em tempo real padrão, que é somente para visualização, a visualização em tempo real interativa permite que os usuários cliquem, digitem e interajam com a sessão do navegador diretamente pelo stream incorporado. Isso é útil para criar interfaces de navegador voltadas para o usuário final, como fluxos de login ou fluxos de trabalho guiados em que os usuários finais precisam controlar o navegador.
Ciclo de vida da sessão
Criação
POST /v2/scrape/{scrapeId}/interact dá continuidade à sessão de scraping e inicia a interação.
Reutilização
interact no mesmo scrapeId reutilizam a sessão existente. O navegador permanece aberto e mantém seu estado entre as chamadas, para que você possa encadear várias interações:
Limpeza
Perfis persistentes
profile, você pode salvar e reutilizar o estado do navegador (cookies, localStorage, sessões) entre scrapes. Isso é útil para continuar conectado e preservar preferências.
Passe o parâmetro profile ao chamar o scraping. Sessões com o mesmo nome de perfil compartilham o estado.
Apenas uma sessão pode salvar em um perfil por vez. Se outra sessão já estiver salvando, você receberá um erro
409. Você ainda pode abrir o mesmo perfil com saveChanges: false ou tentar novamente mais tarde.Quando usar o quê
Interact vs Browser Sandbox: O Interact é construído sobre a mesma infraestrutura que o Browser Sandbox, mas oferece uma interface melhor para o padrão mais comum — fazer scrape de uma página e depois se aprofundar. O Browser Sandbox é melhor quando você precisa de uma sessão do navegador independente que não esteja vinculada a um scrape específico.
Preços
- Somente código (sem
prompt) — 2 créditos por minuto de sessão - Com prompts de IA — 7 créditos por minuto de sessão
- Scraping — cobrado separadamente (1 crédito por scraping, além de quaisquer custos específicos do formato)
Referência da API
- Execute Interact —
POST /v2/scrape/{scrapeId}/interact - Stop Interact —
DELETE /v2/scrape/{scrapeId}/interact
Corpo da Requisição (POST)
Resposta
Tem feedback ou precisa de ajuda? Envie um e-mail para help@firecrawl.com ou entre em contato no Discord.

