Back to Details

firecrawl-build-interact

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Firecrawl Build Interact

Firecrawl Build Interact

Use this when 
/scrape
is not enough because the feature needs to act on the page.
当
/scrape
接口无法满足需求，功能需要对页面执行操作时使用本功能。

Use This When

适用场景

  • content appears only after clicks, typing, or navigation
  • the feature needs forms, pagination, filters, or multi-step flows
  • the product must stay in the same browser context after scraping
  • 内容仅在点击、输入或导航操作后才会展示
  • 功能需要处理表单、分页、筛选器或多步流程
  • 产品必须在爬取后保持同一浏览器上下文

Default Recommendations

默认建议

  • Start with 
    /scrape
    , then escalate to 
    /interact
    .
  • Keep 
    /interact
    scoped to the smallest browser workflow that unlocks the data.
  • Use persistent profiles only when the feature truly needs authenticated state across sessions.
  • 优先使用
    /scrape
    接口，无法满足时再升级使用
    /interact
  • 将
    /interact
    的适用范围控制在能获取数据的最小浏览器工作流内
  • 仅当功能确实需要跨会话保留身份验证状态时，才使用持久配置文件

Common Product Patterns

常见产品模式

  • search forms and faceted filters
  • paginated result sets
  • login-gated dashboards or tools
  • flows where the page must be explored before extraction is complete
  • 搜索表单和多面筛选器
  • 分页结果集
  • 登录后才可访问的仪表盘或工具
  • 需要先浏览页面才能完成提取的流程

Implementation Notes

实现注意事项

  • /interact
    is the right tool when the page must be manipulated, not just read.
  • Keep prompts or action code specific to the product flow.
  • If the use case is fully open-ended browser automation, evaluate whether a browser sandbox is a better product fit.
  • 当需要操作页面而非仅读取页面内容时，
    /interact
    是合适的工具
  • 保持提示词或操作代码与产品流程的适配性
  • 如果使用场景是完全开放的浏览器自动化，请评估浏览器沙箱是否更适配产品需求

Escalation Rules

升级规则

  • If the page can be read directly, stay on firecrawl-build-scrape.
  • If you need a site-wide or section-wide extraction job, use firecrawl-build-crawl instead of driving one page at a time.
  • 如果可以直接读取页面内容，请继续使用 firecrawl-build-scrape
  • 如果需要全站或全版块的提取任务，请使用 firecrawl-build-crawl，而非逐页操作

Docs (Source of Truth)

官方文档（唯一可信来源）

Read the docs for request/response schemas, parameters, and SDK examples before writing integration code:
编写集成代码前，请阅读官方文档了解请求/响应模式、参数和SDK示例：

See Also

相关参考

  • firecrawl-build
  • firecrawl-build-scrape
  • firecrawl-build-search
  • firecrawl-build
  • firecrawl-build-scrape
  • firecrawl-build-search