/agent by Firecrawl의 기능
/agent는 Firecrawl API의 엔드포인트(POST https://api.firecrawl.dev/v2/agent)로, Firecrawl은 이를 데이터를 위한 딥 리서치라고 설명합니다. 창업자와 웹사이트가 포함된 기업 목록처럼 필요한 내용을 설명하는 prompt(최대 10,000자)를 보내면, agent가 웹을 검색하고 사이트를 탐색하며 JavaScript 페이지, 페이지 넘김, 무한 스크롤을 처리한 뒤 JSON을 반환합니다. 타입이 지정된 출력을 받으려면 JSON 스키마(Python은 Pydantic, Node는 Zod)를 전달할 수 있고, 실행 범위를 좁히기 위해 urls 목록을 선택적으로 전달할 수 있습니다. strictConstrainToURLs를 사용하면 해당 페이지에서만 실행됩니다. Firecrawl은 /agent가 기존 /extract 엔드포인트를 대체하며 /extract는 지원 중단 예정이라고 밝히고 있고, 이미 알고 있는 단일 URL에는 /scrape의 JSON 모드가 더 저렴하다고 안내합니다.
이제 모든 실행은 Firecrawl의 Spark 2 모델을 사용하며(이전 명칭인 Spark 1 Mini와 Pro도 계속 작동하지만 Spark 2로 연결됩니다), effort 설정을 low, medium, high 중에서 선택적으로 지정할 수 있습니다. 작업은 비동기로 실행됩니다. 작업 ID로 폴링하거나 웹훅을 받을 수 있고, 결과는 API를 통해 24시간 동안 조회할 수 있으며, 스레드 ID를 사용하면 후속 프롬프트를 보내 실행을 이어갈 수 있습니다. 그 밖의 옵션으로는 전체 실행에 적용되는 프록시 country, SafeSearch 필터링, Zero Data Retention(2배 요금 부과), 승인 단계를 거쳐 유료 Alexandria 데이터 제공자를 이용하는 기능이 있습니다. firecrawl.dev/agent의 플레이그라운드에서 코드 없이 사용해 볼 수 있으며, Python 및 Node SDK, CLI, Firecrawl의 MCP 서버로도 호출할 수 있습니다. Parallel Agents는 수백 또는 수천 건의 /agent 쿼리를 스프레드시트 형태의 그리드로 일괄 처리합니다.
