mcpField
F
firecrawl-interact

firecrawl-interact

github.com/firecrawlData & databases25271 installsUpdated 6d ago
Repository

About firecrawl-interact

firecrawl-interact is a skill for operating a live browser session on a page after it has been scraped. It supports natural-language or code-driven actions and extraction, with browser profiles for retaining session state.

Key features

  1. 01Click, fill forms, and navigate pages
  2. 02Extract data from a specific page
  3. 03Use natural-language prompts or code
  4. 04Persist browser state with profiles

Use cases

  1. 01Submit a form on a scraped page
  2. 02Extract a pricing table from a page
  3. 03Return to a site using saved browser state

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/firecrawl/firecrawl-claude-plugin --skill firecrawl-interact

After installing, type/firecrawl-interactin Claude Code to confirm it loaded.

Details

From the project README

firecrawl interact

Interact with scraped pages in a live browser session. Scrape a page first, then use natural language prompts or code to click, fill forms, navigate, and extract data. For web searches, use search — interact is for acting on a specific page.

Quick start

# 1. Scrape a page (scrape ID is saved automatically)
firecrawl scrape "<url>"

# 2. Interact with the page using a positional prompt
firecrawl interact "Click the login button"
firecrawl interact "Fill in the email field with [email protected]"
firecrawl interact "Extract the pricing table"

# A UUID first argument is auto-detected as the scrape ID
firecrawl interact "<scrape-id>" "Extract the pricing table"

# 3. Or use code for precise control
firecrawl interact --code "agent-browser click @e5" --bash
firecrawl interact --code "agent-browser snapshot -i" --bash

# 4. Stop the session when done
firecrawl interact stop

Run firecrawl interact --help for the full option list.

Done when: the requested content or action result is captured and the session is stopped with firecrawl interact stop.

Profiles

Use --profile on the scrape to persist browser state (cookies, localStorage) across scrapes:

# Session 1: Login and save state
firecrawl scrape "https://app.example.com/login" --profile my-app
firecrawl interact --prompt "Fill in email with [email protected] and click login"

# Session 2: Come back authenticated
firecrawl scrape "https://app.example.com/dashboard" --profile my-app
firecrawl interact --prompt "Extract the dashboard data"

Read-only reconnect (no writes to profile state):

firecrawl scrape "https://app.example.com" --profile my-app --no-save-changes

Tips

  • Always scrape first — interact requires a scrape ID from a previous firecrawl scrape call
  • The scrape ID is saved automatically, so you can omit --scrape-id for subsequent interact calls. Saved sessions may expire after about 10 minutes; re-scrape if the CLI warns that the session is stale
  • Use firecrawl interact stop to free resources when done
  • For parallel work, scrape multiple pages and interact with each using --scrape-id

See also

Comments

Markdown supported