Firecrawl 연동: AI Flowi Workflow
Firecrawl 연동에서는 URL 기반 정보 수집에 Crawl, Extract, Map 또는 Scrape를 선택할 수 있습니다. 2026년 10월 9일에 내보낸 AI Flowi Workflow 1.9.2 카탈로그의 firecrawl 카테고리에는 정확히 4개의 컴포넌트가 있습니다.
Firecrawl 워크플로 비용 참고 자료: 요금제 가격 및 자동화 비용 가이드.
공식 출처: Firecrawl 문서
카탈로그에 문서화되어 있으며, Ai Flowi의 운영 환경 테스트는 거치지 않았습니다
배경 정보는 공통 인증 정보 개요를 참고하세요. 작업별 대상 필드와 JSON 옵션은 이 페이지에서 자세히 설명합니다.
Firecrawl 컴포넌트 4개 전체
이 목록은 firecrawl 바로 아래의 4개 항목만 다룹니다. composio에 있는 별도의 Firecrawl 컴포넌트는 포함하지 않습니다. 정확한 표시 이름, 설명, 필수 입력 표시는 제공된 내보내기 파일을 따릅니다.
4개 작업 모두 api_key를 문자열로 입력해야 하며, 허용 유형 목록은 비어 있습니다. Crawl과 Scrape는 단수형 필드인 url이 필수이고, Extract와 Map은 복수형 필드인 urls가 필수입니다. 이 필드도 문자열 유형입니다.
| 컴포넌트 | 기능 | 필수 입력(명시된 인증 정보 포함) |
|---|---|---|
| Firecrawl Crawl API | 카탈로그 설명: “URL을 크롤링하고 결과를 반환합니다.” | api_key (str; 명시된 허용 유형 없음)url (str; 허용 유형: Message) |
| Firecrawl Extract API | 카탈로그 설명: “URL에서 데이터를 추출합니다.” | api_key (str; 명시된 허용 유형 없음)prompt (str; 허용 유형: Message)urls (str; 허용 유형: Message) |
| Firecrawl Map API | 카탈로그 설명: “URL을 매핑하고 결과를 반환합니다.” | api_key (str; 명시된 허용 유형 없음)urls (str; 허용 유형: Message) |
| Firecrawl Scrape API | 카탈로그 설명: “URL을 스크레이핑하고 결과를 반환합니다.” | api_key (str; 명시된 허용 유형 없음)url (str; 허용 유형: Message) |
카탈로그 참고 자료: Firecrawl 카테고리. 모바일에서는 표를 가로로 스크롤할 수 있습니다. 키보드 사용자는 각 영역에 초점을 맞춘 뒤 방향키를 누르면 됩니다.
관련 자료: Apify 사용법: Actor 실행과 데이터 연동.
Firecrawl 선택 입력과 명시된 선택 항목
선택 설정은 작업마다 다릅니다. 하나의 설정을 4개 컴포넌트 모두에 복사하면 이러한 차이가 반영되지 않습니다. 객체 형태의 옵션 필드에 명시된 연결 유형은 Data와 JSON입니다.
| 컴포넌트 | 선택 입력과 유형 | 명시된 선택 항목 |
|---|---|---|
| Firecrawl Crawl API | crawlerOptions (other; 허용 유형: Data, JSON)idempotency_key (str; 허용 유형이 제공되지 않음)scrapeOptions (other; 허용 유형: Data, JSON)timeout (int; 허용 유형이 제공되지 않음) | 명시된 선택 항목 없음 |
| Firecrawl Extract API | enable_web_search (bool; 허용 유형이 제공되지 않음)schema (other; 허용 유형: Data, JSON) | 명시된 선택 항목 없음 |
| Firecrawl Map API | ignore_sitemap (bool; 허용 유형이 제공되지 않음)include_subdomains (bool; 허용 유형이 제공되지 않음)sitemap_only (bool; 허용 유형이 제공되지 않음) | 명시된 선택 항목 없음 |
| Firecrawl Scrape API | extractorOptions (other; 허용 유형: Data, JSON)scrapeOptions (other; 허용 유형: Data, JSON)timeout (int; 허용 유형이 제공되지 않음) | 명시된 선택 항목 없음 |
Firecrawl 출력 포트
Crawl, Extract, Map, Scrape에는 각각 하나의 출력이 선언되어 있습니다. 표시 이름은 JSON, 내부 이름은 data, 유형은 JSON입니다. 내보내기 파일에는 이 4개 작업의 응답 본문 예시가 없습니다.
| 컴포넌트 | 표시 이름 | 포트 이름 | 유형 |
|---|---|---|---|
| Firecrawl Crawl API | JSON | data | JSON |
| Firecrawl Extract API | JSON | data | JSON |
| Firecrawl Map API | JSON | data | JSON |
| Firecrawl Scrape API | JSON | data | JSON |
Firecrawl 인증 정보와 작업 설정
- 선택한 컴포넌트의 필수 입력인
api_key에 Firecrawl API 키를 입력합니다. 이 작업에 문서화된 인증 정보 필드는 모델 제공업체 인증 정보나 저장된 Google 계정 선택기가 아닙니다. - Firecrawl Crawl API 또는 Firecrawl Scrape API를 사용하는 경우 대상 URL을
url에 입력합니다. Firecrawl Map API에서는urls를 사용합니다. 이 필수 문자열 입력들은 모두 허용 연결 유형으로 Message를 명시합니다. - Firecrawl Extract API에서는
urls와prompt를 모두 입력합니다. 두 필드 모두 Message를 허용하는 필수 문자열입니다. 설정에 필요하다면 선택 입력인schema를 Data 또는 JSON으로 추가합니다. 카탈로그에는 복수형 이름의 필드에 여러 URL을 어떻게 인코딩하는지 정의되어 있지 않습니다. - 작업에 맞는 옵션만 설정합니다. Crawl은
crawlerOptions,scrapeOptions,idempotency_key,timeout을 허용하며, Scrape는extractorOptions,scrapeOptions,timeout을 허용합니다. Map에는 사이트맵 및 하위 도메인과 관련된 불리언 설정이 3개 있고, Extract에는 선택 입력인enable_web_search가 있습니다. - 내용을 확인할 수 있는 테스트 URL에 선택한 작업을 실행한 뒤, 후속 처리를 추가하기 전에
data를 살펴봅니다. 4개 작업의 응답을 감싸는 구조가 같다고 가정하지 말고, 다음 노드에 필요한 반환 필드를 기록합니다.
인증 정보를 재사용하려면 문서에 설명된 변수 기능을 읽고 편집기의 해당 필드에서 사용할 수 있는지 확인합니다. 카탈로그에는 Firecrawl의 저장된 연결 선택기가 명시되어 있지 않으며, 비밀 정보 저장 방식도 설명되어 있지 않습니다.
워크플로 아이디어 예시 3가지
다음 조합은 가능한 작업의 개요입니다. 검증된 가져오기 파일로 제공되는 것이 아니므로 URL 선택과 페이로드 확인을 직접 수행해야 합니다.
1. 선택한 페이지에서 구조화된 사실 정보 준비 — 운영 환경 미검증
Firecrawl Extract API를 설정할 때 api_key를 입력하고, 대상은 urls에, 지침은 prompt에 입력합니다. 필요하다면 미리 준비한 Data 또는 JSON 값을 선택 입력인 schema에 연결합니다. 필드 선택 단계에서 JSON Operations로 전달하기 전에 JSON 결과를 확인합니다. 카탈로그는 결과가 입력으로 제공된 스키마를 충족한다고 보장하지 않습니다.
2. 사이트를 매핑한 뒤 선택한 URL 확인 — 운영 환경 미검증
Firecrawl Map API에 api_key와 urls를 입력하고, ignore_sitemap, sitemap_only 또는 include_subdomains을 설정할지 결정합니다. JSON 출력을 검토한 뒤 Firecrawl Scrape API의 필수 입력인 url에 사용할 URL을 선택합니다. 매핑 응답의 구조를 검증할 때까지는 수동 선택으로 시작하세요. 스크레이핑 노드에도 API 키를 설정합니다.
3. 확인한 크롤링 데이터를 검토 메모로 변환 — 운영 환경 미검증
Firecrawl Crawl API에 api_key와 url을 입력해 실행합니다. Data 또는 JSON 형식의 crawlerOptions나 scrapeOptions는 지원되는 구조를 확인한 뒤에만 추가합니다. data를 살펴본 뒤 Parser 참고 문서를 활용해 검토 메모용 Message 출력을 설계합니다. 템플릿 설정은 실제 크롤링 필드와 일치해야 합니다. 특정 콘텐츠 키나 서식 적용 결과를 보장하는 예시는 아닙니다.
확인해야 할 Firecrawl 제한사항은 무엇인가요?
- 복수형 필드 이름만으로 URL 배열 형식이 정의되지는 않습니다. Extract와 Map의
urls는 Data나 JSON 입력이 아니라 Message를 허용하는str유형입니다. 내보내기 파일에는 구분자, JSON 문자열 형식, 여러 URL의 유효성 검증 규칙이 제공되지 않습니다. - 옵션 스키마와 기본값이 문서에 명시되어 있지 않습니다.
crawlerOptions,scrapeOptions,extractorOptions,schema는 Data 또는 JSON을 허용하지만 지원되는 키는 명시하지 않습니다. 불리언 필드인enable_web_search에는 검색 범위에 대한 설명이 없으며, Map 플래그를 함께 사용할 때의 우선순위도 명시되어 있지 않습니다. - 시간 제한과 멱등성을 검증해야 합니다. Crawl과 Scrape의
timeout은 선택 사항인 정수형 입력이지만 단위, 기본값, 허용 범위는 명시되어 있지 않습니다.idempotency_key는 Crawl에만 명시되어 있습니다. 이 필드가 있다는 사실만으로 보존 기간, 재시도 정책, 중복 방지 결과가 확정되지는 않습니다. - JSON은 포트 유형이며 응답 명세가 아닙니다. 4개의
data출력에는 URL 필드, 텍스트 필드, 추출 결과를 감싸는 구조, 작업 식별자, 폴링 동작, 부분 실패 결과에 대한 설명이 없습니다. 선택기를 만들기 전에 해당 작업의 실제 응답을 확인합니다. - 이 카테고리의 범위는 이 4개 작업으로 한정됩니다. 별도의 크롤링 상태 확인, 취소, 예약 실행, 웹훅 컴포넌트는 여기에 명시되어 있지 않습니다. 인증 실패, 제공업체의 할당량, 오류 복구에 대해서도 카탈로그에는 설명이 없습니다.