firecrawl-interact — Claude Code skill: what it does, how to install
Controls a live browser session on scraped web pages through text instructions or direct code. Useful when pages block simple scrapers with login walls or complex dynamic feeds.
npx skills add firecrawl/cli --skill firecrawl-interact -a claude-codeWhat firecrawl-interact does
The skill sends browser actions via the firecrawl command-line utility. You fetch the page first. After the initial scrape, the tool executes natural language prompts or code to click elements and submit input fields. For granular steps, developers pass browser agent commands directly through the --code flag.
State persistence works through named profiles with --profile. This keeps authentication cookies and localStorage across CLI calls. Subsequent runs immediately access protected dashboards without repeating login forms. Adding --no-save-changes connects to an existing profile in read-only mode.
Every interaction depends on a valid scrape identifier. Without calling firecrawl scrape beforehand, the command fails immediately. Saved browser sessions expire after roughly 10 minutes. If the CLI reports a stale session, scrape the target URL again. Once finished, run firecrawl interact stop to terminate background processes and free system memory.
What it helps with
- bypass login forms and store session cookies
- navigate paginated tables and continuous scroll feeds
- fill out complex web inputs automatically
- extract dynamic pricing data hidden behind user clicks
Example prompts for the agent
- Scrape
https://app.example.com/logininto profileteam, submit credentials and click submit - Scroll down the product list twice to load additional items
- Run
firecrawl interact stopto close the active session
How to install firecrawl-interact
1Skills CLI (Vercel)
npx skills add firecrawl/cli --skill firecrawl-interact -a claude-code2Manually: put the files in place
~/.claude/skills/firecrawl-interact/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/firecrawl-interact/
1Skills CLI (Vercel)
npx skills add firecrawl/cli --skill firecrawl-interact -a codex2Manually: put the files in place
.agents/skills/firecrawl-interact/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add firecrawl/cli --skill firecrawl-interact -a cursor2Manually: put the files in place
.cursor/skills/firecrawl-interact/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install firecrawl/cli firecrawl-interact2Manually: put the files in place
.github/skills/firecrawl-interact/SKILL.md1Skills CLI (Vercel)
npx skills add firecrawl/cli --skill firecrawl-interact -a gemini-cli2Platform CLI
gemini skills install https://github.com/firecrawl/cli --path skills/firecrawl-interactManually: put the files in place
.devin/skills/firecrawl-interact/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add firecrawl/cli --skill firecrawl-interact -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about firecrawl-interact
How do I install firecrawl-interact in Claude Code?
Install it by running npx skills add firecrawl/cli --skill firecrawl-interact -a claude-code in your project terminal.
What does firecrawl-interact do?
It drives a live browser session after a page is scraped through the firecrawl CLI. The skill lets your agent click buttons, submit web forms, navigate pagination, and extract dynamic content.
How long does a browser session stay open?
Saved sessions expire after about 10 minutes of inactivity. When the CLI reports that a session is stale, run firecrawl scrape again to start a fresh one.
