firecrawl local可在自己的电脑上抓取网页并输出markdown。若要避免抓取失败后转交firecrawl cloud,在运行命令时设置firecrawl_cloud=off;这个开关关闭云端回退,但不会让抓取离线完成,目标网页仍需联网访问。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
项目官方文档:Firecrawl Local
安装本地二进制并核对环境
官方说明要求Rust和C编译器;macOS使用Xcode命令行工具,Debian或Ubuntu准备build-essential。安装来源是crates.io,不需要为本例启动数据库、Redis或容器。
cargo install firecrawl-local firecrawl-local --version
需要JavaScript渲染的页面会使用本机已有Chrome或Chromium;没有浏览器时,静态页面仍可处理,需渲染的页面可能返回警告。MCP集成另有Node.js要求,本例只调用本地CLI,不运行init或改动Agent配置。

项目官方文档:本地抓取失败时的云回退及FIRECRAWL_CLOUD开关
关闭云端回退后保存一次抓取
以下是macOS或Linux的Shell示例,在允许写入的工作目录运行。先写临时文件,仅在命令成功且输出非空时替换page.md,避免失败时把旧结果清空。将示例网址替换为自己有权访问的公开页面。
mdBook 是一个从 Markdown 文件创建在线书籍的命令行工具。该工具使用 Rust 编写并由 Rust 项目维护,为《The Rust Programming Language》一书提供支持,非常适合用于创建产品文档、教程、课程材料和技术参考。
set -eu
tmp=$(mktemp ./page.XXXXXX)
trap 'rm -f "$tmp"' EXIT
if FIRECRAWL_CLOUD=off firecrawl-local scrape https://example.org --markdown > "$tmp"; then
test -s "$tmp"
mv "$tmp" ./page.md
else
exit 1
fi
核对结果与本地处理边界
打开page.md,确认正文对应目标页面,而不是登录页、错误页或挑战页。关闭云回退后,本地抓取不成功就保留失败处理,不应自动换用云端重试。Firecrawl Cloud提供的搜索、Alexandria等能力也不因安装本地CLI而变为本地计算;若要求所有内容留在本机,就不要调用这些云端功能。CLI的成功状态和非空输出也不能保证网页内容完整,仍需核对实际正文。









