Back to Details

firecrawl-build-search

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Firecrawl Build Search

Firecrawl 搜索构建

Use this when the application starts with a query, not a URL.
当应用以查询而非URL作为入口时使用本功能。

Use This When

适用场景

  • the user asks a question and the product must discover sources first
  • the feature needs current web results
  • you want to turn a search query into a shortlist of pages for later scraping
  • 用户提出问题，产品必须先查找信息来源
  • 功能需要获取最新的网页结果
  • 你需要将搜索查询转换为候选页面列表，供后续爬取使用

Default Recommendations

默认建议

  • Use 
    /search
    first when URL discovery is part of the product behavior.
  • Keep search and extraction conceptually separate unless scraping search results is clearly required.
  • Prefer selective follow-up extraction over broad hydration when cost or latency matters.
  • 当产品行为包含URL发现环节时，优先使用
    /search
    接口
  • 除非明确要求爬取搜索结果，否则应从概念上区分搜索和提取流程
  • 当成本或延迟优先级较高时，优先选择选择性后续提取而非广泛内容填充

Common Product Patterns

常见产品模式

  • answer generation with cited sources
  • company, competitor, or topic discovery
  • research workflows that produce a shortlist before deeper extraction
  • query-to-URL pipelines for later 
    /scrape
    or 
    /interact
  • 带引用来源的答案生成
  • 公司、竞品或主题调研
  • 先生成候选列表再进行深度提取的研究工作流
  • 供后续
    /scrape
    或
    /interact
    接口使用的查询转URL pipeline

Escalation Rules

升级规则

  • If you already have the URL, use firecrawl-build-scrape.
  • If the result page then requires clicks or form interaction, escalate to firecrawl-build-interact.
  • If the search target is a known site and you only need URLs on that site, firecrawl-build-map may be a better fit.
  • 如果你已经有对应URL，请使用firecrawl-build-scrape。
  • 如果结果页面需要点击或表单交互，请升级使用firecrawl-build-interact。
  • 如果搜索目标是已知站点，且你只需要该站点内的URL，firecrawl-build-map可能是更合适的选择。

Implementation Notes

实现注意事项

  • Treat 
    /search
    as discovery, ranking, and source selection.
  • Be explicit about whether the product needs snippets, URLs, or full result content.
  • Keep the query contract stable so downstream scraping logic stays predictable.
  • 将
    /search
    接口视为内容发现、排序和来源选择的工具。
  • 明确产品需要的是摘要片段、URL还是完整的结果内容。
  • 保持查询约定稳定，确保下游爬取逻辑可预测。

Docs

文档

See Also

参考链接

  • firecrawl-build
  • firecrawl-build-scrape
  • firecrawl-build-map
  • firecrawl-build
  • firecrawl-build-scrape
  • firecrawl-build-map