用途:从一手来源回答开发者问题,例如 bug 报告所在的 issue、修复它的已合并 PR、规定接口契约的 README 或文档页。索引仅覆盖公开仓库,私有或内部仓库不在其中,此类问题需直接阅读代码。
主要能力:提供三种调用方式,均返回带匹配段落的排序结果。HTTP:GET|POST https://api.firecrawl.dev/v2/search/developer;MCP:firecrawl_developer_search(query, k?, skills?);CLI:firecrawl developer <query> [--limit <n>]。结果为每条带 id(前缀标识类型:doc:、issue:、pull_request:、readme:)、url 和 markdown 段落。k/--limit 取值 1–100,默认 10;skills="only" 仅限 HTTP/MCP,用于只搜 agent skill 文件。可无密钥使用,发送 Authorization: Bearer $FIRECRAWL_API_KEY 可提高速率限制。另有把开发者结果并入普通搜索的方式:MCP firecrawl_search(query, categories:["developer"]) 或 CLI firecrawl search <query> --categories developer;以及通用网页抓取与搜索 firecrawl_scrape(url) / firecrawl search <query>。
过滤项(仅 HTTP 支持):types 可选 doc、issue、pull_request、readme,默认全选;repos 限定仓库半边(issue/PR/readme);sources 限定文档半边(最多 20 个文档源 id);两者同时传入为并集。passages 为每条结果最多段落数(1–5,默认 1)。language、topic、license、min_stars、max_stars、archived、fork 描述仓库。若在不带 sources 的情况下使用仓库过滤,响应只含仓库证据,这是设计而非索引故障。不匹配的过滤组合返回 400 而非空列表。
用法建议:字面报错或堆栈字符串用 types=["issue","pull_request"] 搜索该字符串加库名,无结果则去掉易变部分(路径、行号、id、地址)重试;概念性“如何做 X”用自然语言加全部类型,优先提高 passages 再提高 k;已知 bug 搜 issue 与 PR,再按该 issue 的仓库限定 types=["pull_request"];API 契约用 types=["readme","doc"];版本相关行为需读 issue 的结论与关联 PR,不能只看开头的报告;限定单个库用 repos=["owner/name"],若结果为空先看回显的 indexed 标志,false 表示该仓库或源永远不会命中;生态范围问题不加限定,可用 language/topic/min_stars 限定维护中的仓库;agent skill 与工具约定用 skills="only"。
限制:不支持私有仓库;仓库过滤会排除多数文档页;doc 结果常缺 title,可回退到 url;比较、观点、新闻或未收录项目应走开放网络。原则是引用段落并附 url,已合并 PR 覆盖 issue 报告,先全域搜索再缩小范围,索引无语时应改走网络。