All posts

Firecrawl MCP v3 공개: 카탈로그 조회와 유료 공급자 실행의 차이

Firecrawl MCP v3의 도구 탐색과 공급자 순차 조회를 살펴본다. 무료 카탈로그 조회와 실제 실행의 차이, max_credits를 생략했을 때의 비용 조건을 공식 변경 이력으로 확인했다.

여러 데이터 공급자를 연결한 AI 에이전트가 카탈로그 탐색 경로와 계량기가 달린 데이터 실행 경로를 나눠 사용하는 개념도

Firecrawl이 2026년 11월 12일 MCP v3를 공개했다. Alexandria의 데이터 도구를 한 연결에서 찾고 실행하는 업데이트다. Firecrawl은 공급자가 결과를 찾지 못하면 다음 공급자를 시도한다고 설명했다. 병렬 하위 작업도 소개했다. 개발자가 살필 부분은 도구 탐색과 실제 데이터 조회의 비용 차이다.

발표 수치를 읽는 법

Firecrawl은 3,000개 이상의 도구를 제공하고 요청 한도는 최대 60배, MCP 사용량은 4배로 늘었다고 밝혔다. 공급자 탐색은 v2보다 약 8배, MCP 검색은 약 2배 빠르다는 설명도 덧붙였다. 이 수치는 회사 발표이며 이 글에서 독립 측정하지 않았다. 모든 요청의 지연이나 전체 작업 비용이 같은 비율로 개선된다고 볼 근거는 없다.

공식 발표는 당시 서비스를 사용할 수 있다고 안내한다. 병렬 하위 작업도 발표에 포함됐다. 실제 도입에서는 사용하는 MCP 클라이언트에서 도구가 노출되고 호출되는지 확인하는 편이 좋다.

카탈로그 조회와 공급자 실행

같은 날 공개된 서버 3.40.0 변경 이력에는 alexandria_library_search와 alexandria_library_read가 추가됐다. 이름이 비슷해도 두 도구의 역할은 다르다.

alexandria_library_search는 카탈로그를 읽기 전용 파일시스템처럼 탐색한다. 이 도구로 공급자 계약을 무료로 확인한다. 공급자는 실행하지 않는다. 반면 alexandria_library_read는 공급자의 기능을 실행한다. 호출 배열에는 1~10개의 항목을 넣는다. 개발자는 카탈로그 조회와 공급자 데이터 조회를 나눠 관리해야 한다.

공식 변경 이력의 3.40.0 항목은 새 도구를 아직 반영하지 않은 클라이언트를 위한 기존 호출 경로도 설명한다. 새 도구가 보이지 않는다면 해당 클라이언트의 도구 갱신 상태와 지원 경로를 함께 확인할 수 있다.

순차 조회를 쓸 때의 비용 조건

people_company_enrich는 입력을 처리할 수 있는 공급자를 순서대로 조회한다. 필드별로 값을 찾으면 해당 필드의 조회를 멈춘다. 결과를 찾은 공급자는 명시된 요금을 청구하고 찾지 못한 조회는 무료다.

비용 상한에 주의가 필요하다. people_company_enrich는 max_credits를 지정하지 않으면 상한이 없다. 개발자는 실제 실행 도구에 예산을 전달하고 응답의 공급자 정보를 살펴봐야 한다. 이 동작은 무료 카탈로그 조회와 별개다.

이 글은 공식 발표와 공개 변경 이력을 대조했다. 유료 호출이나 병렬 실행을 직접 시험하지 않았으므로 실제 지연과 청구액은 확인하지 못했다. 도입을 시험한다면 같은 입력으로 반환 데이터와 공급자별 결과, 사용 크레딧을 함께 기록하는 방법이 적절하다.

Discussion

No comments yet