开发者索引

搜索 issue、已合并的 pull request、仓库 README 和精选文档站点

Firecrawl Developer 是专为编程代理打造的索引。它涵盖公共代码仓库中的 issue、已合并的 pull request 和 README，以及精选文档站点，让代理能够基于第一手资料回答有关代码行为、库或框架、API 契约、错误消息或已知 bug 的问题，而不是依赖普通网页。

• 查找报告并修复某个 bug 的 issue 或 pull request
• 阅读 README 或文档页面中能够回答某个具体问题的相关段落
• 追溯 API 契约至修改它的 pull request
• 找出错误消息背后的讨论

要让您的代理访问开发者索引，我们强烈建议将我们的 CLI 或 MCP 与专用开发者技能结合使用。您可以通过以下命令安装该技能：

npx -y firecrawl-cli@latest setup developer-index

​

端点

任务	端点
搜索开发者索引	GET 或 POST /search/developer
在网页搜索中添加开发者结果	使用 POST /search，并设置 categories: ["developer"]

​

搜索开发者索引

发送自然语言问题，即可获得按排名返回的开发者结果及匹配段落。当你只想搜索开发者来源时，可使用此路径，并可按结果类型、仓库和文档来源进行筛选。

开发者搜索每 10 条结果消耗 2 个额度，向上取整 (1–10 条结果 = 2 个额度，11–20 条 = 4 个额度，以此类推) 。开始使用无需 API 密钥；添加 API 密钥可获得更高的限流。

cURL

# 开始使用无需 API 密钥；如需更高的限流，请添加 -H "Authorization: Bearer $FIRECRAWL_API_KEY"：
curl -s "https://api.firecrawl.dev/v2/search/developer?query=how%20do%20I%20configure%20retries&k=10"

同一路径也支持 POST；当你需要以 JSON 传递数组筛选条件时，这种形式更方便：

cURL

# 无需 API 密钥即可上手；如需更高的限流额度，请添加 -H "Authorization: Bearer $FIRECRAWL_API_KEY"：
curl -X POST https://api.firecrawl.dev/v2/search/developer \
  -H "Content-Type: application/json" \
  -d '{
    "query": "how do I configure retries",
    "k": 10,
    "types": ["issue", "pull_request"]
  }'

每个结果都包含稳定的 id，例如 issue:owner/repo#123、url 和 Markdown 格式的匹配 passages，从而保留表格和代码块。工件类型编码在 id 前缀中：doc:、issue:、pull_request: 或 readme:。doc 结果通常没有 title，因为源页面可能没有可用标题；因此应回退到 url，不要假定该字段一定存在。

当你使用 sources 或 repos 限定搜索范围时，响应会回显它们，并为每个条目附带 indexed 标志，因此你可以区分未编入索引的 id 与仅仅未找到结果的查询。请参见开发者搜索参考，了解回显结构。

可选筛选条件可缩小搜索范围：

• k 设置返回结果数量，默认值为 10；passages 设置每个结果包含的匹配段落数量
• types 选择要搜索的 doc、issue、pull_request 和 readme 类型
• repos 限定索引中仓库部分的搜索范围，sources 限定文档部分的搜索范围
• 将 skills 设为 only 可将搜索限制为已建立索引的代理技能文件
• language、topic、license、min_stars、max_stars、archived 和 fork 按仓库属性筛选，例如 language=Rust、topic=async 或 license=MIT

这七个筛选条件用于描述代码仓库。因此，在未限定 sources 范围的情况下发送其中任一筛选条件，不会返回 doc 结果。发送前请阅读仓库筛选条件如何限定搜索范围。

请参见开发者搜索参考，了解各筛选条件的类型和取值范围、repos 和 sources 如何限定搜索范围，以及完整的响应 schema。

下方所示的 Python 和 Node SDKs 通过 developer 类别访问开发者索引。它们未提供此端点的专用方法，因此请通过 HTTP、CLI 或 MCP 调用。

​

在网页搜索中添加开发者结果

将 developer 作为 /search 的 categories 数组中的唯一条目传入。响应会在标准 web 分组中返回开发者结果，每个结果均标记为 category: "developer"。developer 类别不能与其他类别组合使用。

无需 API 密钥即可开始使用 — /search 接受免密钥请求，并包含 developer 类别，但受免密钥额度限制。如需更高的限流，请提供 API 密钥。

cURL

# 无需 API 密钥即可开始使用；如需更高的限流，请添加 -H "Authorization: Bearer $FIRECRAWL_API_KEY"：
curl -X POST https://api.firecrawl.dev/v2/search \
  -H "Content-Type: application/json" \
  -d '{
    "query": "how do I configure retries",
    "categories": ["developer"],
    "limit": 10
  }'

开发者结果包含 url、title、description 和 position，结构与网页结果相同，并额外包含 category: "developer"。SDK 用户可通过 result.web 获取这些结果。

此工具集返回的是网页结果结构，而非经过排序的开发者结果结构。如需匹配段落和索引筛选条件，请使用开发者搜索端点。

托管的 MCP server 同时提供这两种工具集，且两者均不会写入任何内容。请参见 MCP tools，了解 firecrawl_developer_search、如何通过 firecrawl_search 获取开发者结果，以及两者中哪个可通过免密钥工具集使用。