Agent Skills › firecrawl/cli › firecrawl-interact

firecrawl-interact

GitHub

在已抓取的页面上驱动实时浏览器会话，支持点击、填表、登录和分页等交互操作。用于处理需交互的内容或抓取不完整的情况，通过自然语言或代码控制页面行为并提取数据。

skills/firecrawl-interact/SKILL.md firecrawl/cli

Trigger Scenarios

需要模拟用户点击或填写表单内容加载依赖交互（如登录、无限滚动）静态抓取失败或返回不完整数据

Install

npx skills add firecrawl/cli --skill firecrawl-interact -g -y

More Options

Use without installing

npx skills use firecrawl/cli@firecrawl-interact

指定 Agent (Claude Code)

npx skills add firecrawl/cli --skill firecrawl-interact -a claude-code -g -y

安装 repo 全部 skill

npx skills add firecrawl/cli --all -g -y

预览 repo 内 skill

npx skills add firecrawl/cli --list

SKILL.md

Frontmatter

{
    "name": "firecrawl-interact",
    "description": "Drive a live browser on a scraped page: click, fill forms, log in, paginate, infinite-scroll. Use when content requires interaction or a scrape failed or returned incomplete content.\n",
    "allowed-tools": [
        "Bash(firecrawl *)",
        "Bash(npx firecrawl-cli *)"
    ]
}

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 test@example.com"
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 user@example.com 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

firecrawl-interact