SuperAPI AI 工具集

firecrawl-browser

通用与其它

查看项目

更新于 10-16 16:26

技能介绍

firecrawl-browser 是 Firecrawl CLI 中的一项云端浏览器自动化技能,运行在 Firecrawl 的远程沙箱化环境中的云端 Chromium 会话里,用于与需要交互的页面进行交互,例如点击、表单填写、分页或登录。

用途

该技能适用于以下情况:内容需要交互才能获取,包括点击、表单填写、分页、登录;scrape 因为内容被 JavaScript 交互挡住而失败;需要走多步骤流程;以及在 search → scrape → map → crawl → browser 的升级模式中作为最后手段。文档明确说明,不要在网页搜索时使用 browser,搜索请改用 search。

主要能力与命令

该技能提供以下命令:open <url> 导航到 URL;snapshot -i 获取带 @ref ID 的可交互元素;screenshot 截取 PNG 截图;click <@ref> 按引用点击元素;type <@ref> <text> 向元素输入文本;fill <@ref> <text> 填写表单字段(先清空);scrape 将页面内容提取为 markdown;scroll <direction> 向上/下/左/右滚动;wait <seconds> 等待指定时长;eval <js> 在页面上执行 JavaScript。会话管理命令包括 launch-session --ttl 600、list、close。文档说明简写形式会自动启动会话(如果不存在),无需设置。

使用方式

典型浏览器工作流为:firecrawl browser "open <url>";firecrawl browser "snapshot -i" 查看带 @ref ID 的可交互元素;firecrawl browser "click @e5" 交互;firecrawl browser "fill @e3 'search query'" 填写表单字段;firecrawl browser "scrape" -o .firecrawl/page.md 提取内容;最后 firecrawl browser close 关闭会话。

可用选项包括:--ttl <seconds> 会话存活时间;--ttl-inactivity <seconds> 非活动超时;--session <id> 使用指定会话 ID;--profile <name> 使用命名 profile(持久化状态);--no-save-changes 只读重连(不写入会话状态);-o, --output <path> 输出文件路径。

Profiles

Profile 在关闭后仍保留,并可按名称重新连接,用于“先登录再工作”的流程。文档给出的示例为:第一个会话先执行 launch-session --profile my-app,打开登录页,snapshot -i,填写邮箱,点击按钮,wait 2,然后 close;第二个会话再次 launch-session --profile my-app,打开 dashboard 并 scrape 到 .firecrawl/dashboard.md,最后 close。只读重连可使用 --profile my-app --no-save-changes;带 profile 的简写为 firecrawl browser --profile my-app "open https://example.com"。

提示与限制

文档提示:如果遇到 forbidden 错误,会话可能已过期,需要新建;如需并行浏览器工作,可启动独立会话并通过 --session <id> 操作;完成后应始终关闭会话以释放资源。相关技能包括 firecrawl-scrape(先尝试 scrape,仅在需要时升级到 browser)、firecrawl-search(用于网页搜索,绝不要用 browser 搜索)、firecrawl-agent(AI 驱动的提取,手动控制更少)。关于该技能的收费、价格、平台支持范围、具体效果或性能等信息,资料中暂未提供。