firecrawl-build-search

用途

Firecrawl Build Search 用于把 Firecrawl 的 /search 集成进产品代码和智能体工作流。适用场景是应用以查询为起点，而不是以 URL 为起点。

典型触发条件包括：

• 用户提出问题，产品必须先发现来源；
• 功能需要当前的网页结果；
• 想把一个搜索查询转成一组页面短名单，供后续抓取使用。

主要能力与默认建议

当 URL 发现本身就是产品行为的一部分时，应优先使用 /search。技能建议：

• 除非明确需要抓取搜索结果，否则在概念上把搜索与内容提取保持分离；
• 当成本或延迟重要时，优先做选择性的后续提取，而不是大范围加载。

常见产品模式

• 带引用来源的答案生成；
• 公司、竞品或主题发现；
• 在深度提取之前，先生成网页短名单的研究工作流；
• 为后续 /scrape 或 /interact 服务的查询转 URL 管道。

这里的“研究工作流”指发现网页。如果产品要搜索的是已发表论文，则属于另一个接口，见下方升级规则。

升级规则

• 如果已经有 URL，使用 firecrawl-build-scrape；
• 如果结果页面随后需要点击或表单交互，升级到 firecrawl-build-interact；
• 如果功能搜索的是已发表研究论文——生物医学、临床和生命科学文献（PubMed、bioRxiv、medRxiv）或 arXiv 预印本——/search 不是正确的接口，应改用研究论文索引：firecrawl-research-index。向 /search 传入 categories: ["research"] 并不会查询该索引；它只是把一个普通网页搜索过滤到研究相关网站（包括 PubMed、bioRxiv、medRxiv、arXiv 和出版商网站），并返回这些网站上的页面结果，不提供摘要搜索、相关论文扩展或全文段落；
• 如果功能要回答来自 issue、pull request、README 或文档页面的开发者问题，应改用开发者索引：firecrawl-developer-index。categories: ["developer"] 也有同样的注意事项。

实现说明

• 把 /search 视为发现、排序和来源选择；
• 明确产品需要的是片段、URL 还是完整的搜索结果内容；
• 保持查询契约稳定，使下游抓取逻辑保持可预测。

文档（事实来源）

在编写集成代码前，先阅读对应项目语言的事实来源页面：

• Node / TypeScript: docs.firecrawl.dev/agent-source-of-truth/node
• Python: docs.firecrawl.dev/agent-source-of-truth/python
• Rust: docs.firecrawl.dev/agent-source-of-truth/rust
• Java: docs.firecrawl.dev/agent-source-of-truth/java
• Elixir: docs.firecrawl.dev/agent-source-of-truth/elixir
• cURL / REST: docs.firecrawl.dev/agent-source-of-truth/curl

参见

• firecrawl-build
• firecrawl-build-scrape
• firecrawl-build-interact
• firecrawl-research-index
• firecrawl-developer-index