TL;DR
- Firecrawl到Nstdata的迁移是适配器迁移,而不是简单的基础URL交换。
- 单独映射开始、轮询、收集、归一化和错误路径;保持下游文档模式稳定。
- 公共的Nstdata快速入门和路由部分在同步抓取路径上有所不同,因此在接入生产请求之前,请确认您账户的实时API参考。
- 小的顺利路径集成可能需要30分钟;完整迁移时间取决于您的爬虫过滤器、错误处理和验收测试。
迁移时会发生什么变化?
Firecrawl的 爬虫API指南 描述了POST /v2/crawl、一个作业ID、通过GET /v2/crawl/{jobId}进行轮询,以及已完成结果的分页next链接。 Nstdata Crawl 文档包含一个网站爬虫提交路由、状态查找、页面列表,以及用于工件引用的单独存储读取。这意味着应用程序边界应该是一个内部的crawl_site()适配器,返回您自己的页面记录。保持RAG分块和向量存储对供应商响应形状不知情。
| Pipeline step | Firecrawl public contract | Nstdata public contract | Adapter action |
|---|---|---|---|
| Start crawl | POST /v2/crawl | POST /api/v1/crawl in current docs | Translate URL, path, and limit options |
| Poll job | GET /v2/crawl/{jobId} | GET /api/v1/crawl/status/{crawlId} | Normalize state and terminal errors |
| Collect pages | Crawl result pages and next | GET /api/v1/crawl/pages/{crawlId} | Paginate until complete |
| Read content | Inline page content | Artifact reference such as markdownRef |





