给软件工程师的 Firecrawl 上手指南：步骤、提示词与注意事项
Firecrawl 是一款开源项目：把网站抓取并转为 Markdown 的开源爬取服务。
这篇写给软件工程师：围绕代码阅读与重构、测试与排错和技术文档这几类日常工作，说明它能帮上什么忙、怎么用、哪些地方必须自己把关。
软件工程师的三个高频用法
1. 代码阅读与重构
可直接复制到 Firecrawl 里修改：
先不要改代码。阅读这个模块，画出主要函数的调用关系，指出可以安全重构的部分和风险点，再给出分步重构计划。
把关：先计划后改动。
2. 测试与排错
在 Firecrawl 中可以这样提：
这是失败的测试输出和相关代码，请定位原因，给出最小修复，并补一个能防止回归的测试用例。
把关：修复后测试通过。
3. 技术文档
可直接复制到 Firecrawl 里修改：
根据这段代码和注释生成接口文档：参数、返回值、错误码、调用示例，示例必须能直接运行。
把关：示例代码可运行。
也可以试试：内部文档入库
这是「搜索与知识库」类工具的通用任务，软件工程师同样用得上。
把这些文档解析为干净的文本：保留标题层级和表格，去掉页眉页脚，按章节切分，每段附上原文件名和页码。
边界与合规
不要把密钥和未开源代码上传到未授权工具，合并前审阅每处改动。
- 产出由软件工程师本人负责，AI 只是草稿和辅助。
- 对外内容发布前至少看一遍。
- 如单位有规定的工具清单，优先在清单内选择；Firecrawl 的同类还有 Jina Reader、Crawl4AI。
一周试用建议
选一个最常做的任务连续用 5 个工作日，记录每次节省的时间和需要修改的地方，再决定是否把 Firecrawl 纳入日常流程。
更多可以试的用法
构建问答测试集
输入：一份产品手册。
根据手册编写 20 个用户可能问的问题及标准答案，标注答案所在章节，用来评估知识库检索效果。
检查点：每个答案都能在手册中找到。
带来源的快速调研
输入：一个需要事实支撑的问题。
请回答【问题】，每个关键结论后标注来源链接；如果不同来源说法不一，请分别列出；最后给出你认为最可靠的来源及原因。
交付前确认：关键结论都有可点击来源。
资料卡片整理
准备材料：搜索得到的十几篇资料。
把这些资料整理成卡片：每张卡片包括一句话结论、关键数据、来源和可信度评价，最后按主题分组。
验收标准：每张卡片都有来源。
常见问题：搜索结果过时
限定时间范围，或在提问中注明需要最新信息并核对发布日期。
常见问题：答案引用了错误段落
调整切分大小、加入重排序，并检查文档解析是否丢失标题。
常见问题：表格内容检索不到
换用能保留表格结构的解析工具，或单独把表格转成文本描述。
概念补充：混合检索
同时使用关键词和向量检索，兼顾精确匹配与语义理解。
使用提醒
本文基于 Firecrawl 公开的定位与通用用法编写，具体功能、套餐与可用地区以官方页面为准，产品更新后界面和名称可能变化。
文中提示词和示例仅作示意，实际效果取决于你的材料和 Firecrawl 当前版本，重要内容请人工核对后再使用。