Firecrawl 셀프 호스팅은 오랫동안 한 가지를 의미했습니다. 저장소를 클론하고 Docker Compose를 실행한 뒤, API, Playwright 서비스, Redis, RabbitMQ, Postgres를 장비 위에서 계속 살려두는 것이었죠. 2026년 11월 18일, Firecrawl은 두 번째 선택지를 내놓았습니다. Firecrawl Local은 사이트를 마크다운으로 스크레이핑, 크롤링, 매핑하고 localhost:3002에서 동일한 v2 API에 응답하는 단일 Rust 바이너리로, 데이터베이스도, 큐도, 컨테이너도 필요 없습니다.
간단한 답: 노트북이나 에이전트의 툴벨트에서 인프라 없이 스크레이프, 크롤, 맵, 배치 스크레이프를 원한다면 Firecrawl Local을 선택하세요. 영구적인 작업(persistent jobs), json 및 summary 포맷, 자체 모델을 통한 LLM 추출, 또는 Firecrawl Cloud를 전혀 거치지 않는 검색 라우트가 필요하다면 셀프 호스팅 Docker 스택을 유지하세요.
Firecrawl 셀프 호스팅이란 무엇이고, Firecrawl Local은 무엇인가요?
셀프 호스팅 Firecrawl은 apps/api에 있는 전체 Firecrawl 서버를 Docker Compose로 자체 인프라에서 실행하는 것입니다. Firecrawl Local은 apps/local에 있는 별도의 더 가벼운 빌드로, 동일한 HTML 정리 코드를 사용해 여러분의 머신에서 페이지를 가져와 정리하고, 검색, 차단된 페이지, Alexandria는 Firecrawl Cloud에 넘깁니다.
둘 다 Firecrawl GitHub 저장소에 있고, 둘 다 포트 3002에서 v2 API를 제공하며, 둘 다 AGPL-3.0으로 오픈 소스입니다. Firecrawl Local은 서버를 대체하지 않습니다. Firecrawl Local README가 이를 직접 명시합니다. 셀프 호스팅 가이드는 "‘apps/api에 있으며 Firecrawl Local에 의해 변경되지 않는다’”고 말이죠.
Firecrawl이 처음이신가요? Firecrawl 웹 스크레이핑 가이드부터 시작하세요.
Firecrawl Local vs 셀프 호스팅 Firecrawl 한눈에 보기
다음은 2026년 11월 19일에 확인한 셀프 호스팅 가이드, 오픈 소스 vs 클라우드 페이지, 그리고 Local README를 바탕으로 정리한 요약입니다.
| 셀프 호스팅 Firecrawl | Firecrawl Local | |
|---|---|---|
| 실행 대상 | Docker Compose 스택: api, playwright-service, redis, rabbitmq, nuq-postgres | 단일 바이너리, firecrawl-local |
| 설치 | git clone, .env 작성, docker compose up --build -d |
cargo install firecrawl-local |
| 사전 요구사항 | Git, Docker Engine, Compose v2 | Rust 및 C 컴파일러; Chrome과 Node 22+ 선택 사항 |
| API | 포트 3002의 v2 | 포트 3002의 v2 (scrape, map, crawl, batch scrape, health) |
| 검색 라우트 | 기본 스택에 포함 | Firecrawl Cloud로 전달 |
LLM 포맷 (json, summary) |
OpenAI 호환 프로바이더 또는 Ollama 연결 | 경고와 함께 건너뜀 |
| 스크린샷 | Fire-engine 필요, 기본 스택에 없음 | Chrome이 설치되어 있으면 동작 |
브라우저 actions |
Fire-engine 필요 | 무시됨 |
| 작업 저장소 | Postgres 기반 큐 | 메모리 내, 1시간 후 만료 |
| Alexandria | 셀프 호스트 기능 표에 없음 | 무료 계정으로 Firecrawl Cloud 경유 |
| MCP 설정 | MCP 서버를 여러분의 URL로 지정 | firecrawl-local init이 구성 파일 작성 |
| 라이선스 | AGPL-3.0 | AGPL-3.0 |
Local은 깊이를 무게와 맞바꿉니다. 에이전트가 가장 많이 호출하는 라우트는 유지하고, 큐나 모델, 브라우저 팜이 필요한 것은 버립니다.
무엇이 바뀌었나: 다섯 개 서비스에서 하나의 바이너리로
셀프 호스팅 경로는 가이드에서 릴리스 v2.11.162를 고정합니다. 저장소를 클론하고, Postgres 자격 증명과 USE_DB_AUTHENTICATION=false가 담긴 작은 .env를 작성한 뒤, 스택을 빌드하고 시작합니다:
git clone https://github.com/firecrawl/firecrawl.git
cd firecrawl
git checkout v2.11.162
docker compose up --build -d
docker compose ps --all
이 compose 파일은 api 컨테이너(워커도 함께 실행), 렌더링용 playwright-service, 작업 큐를 위한 redis, rabbitmq, nuq-postgres를 시작합니다. compose 파일은 API를 최대 4 CPU와 8 GB 메모리로, Playwright 서비스를 최대 2 CPU와 4 GB로 제한하며, 가이드는 이 제한이 "검증된 최소 요구사항이 아니다"라고 언급합니다.

Firecrawl Local은 이를 하나의 명령으로 압축합니다:
cargo install firecrawl-local
firecrawl-local scrape https://example.com --markdown
firecrawl-local crawl https://docs.firecrawl.dev --limit 50 --out ./pages
firecrawl-local map https://firecrawl.dev
firecrawl-local serve
.env도, 컨테이너도 없습니다. JavaScript 페이지는 이미 설치된 Chrome이나 Chromium에서 렌더링되며, 크롬이 없어도 정적 페이지는 여전히 작동하고 나머지는 경고를 반환합니다.
search, find-tools, data, login 명령은 Firecrawl Cloud에 도달합니다. firecrawl-local login은 Firecrawl CLI 설치 가이드에 나온 호스팅 CLI의 자격 증명을 재사용합니다.
엔드포인트 범위: 각각 무엇을 제공하는가
마이그레이션에서 가장 자주 깨지는 부분이 여기이므로, SDK의 base URL을 바꾸기 전에 반드시 확인하세요.
Firecrawl Local은 여러분의 머신에서 다음 라우트를 제공합니다:
POST /v2/scrape— 하나의 URL 스크레이프POST /v2/map— 사이트의 URL 목록 조회POST /v2/crawl, 그리고GET및DELETE /v2/crawl/{id}POST /v2/batch/scrape, 그리고GET및DELETE /v2/batch/scrape/{id}GET /health
다른 모든 /v2 라우트(/v2/search 등)는 FIRECRAWL_CLOUD가 다르게 지정하지 않는 한 Firecrawl Cloud로 전달됩니다. v0 및 v1 라우트는 아예 제공되지 않습니다.
셀프 호스팅 Firecrawl은 오픈 소스 vs 클라우드 페이지 기준으로 기본 스택에서 핵심 scrape, crawl, map, search를 다룹니다. LLM 기반 추출은 직접 연결한 프로바이더가 필요합니다. Agent, Browser, Interact, 대시보드는 포함되지 않습니다.
실전에서 짚어야 할 두 가지 함정:
- 헬스 체크가 다릅니다. 셀프 호스팅 가이드는
/v0/health/readiness에서 준비 상태를 확인합니다. Firecrawl Local은 v0를 제공하지 않으므로GET /health를 사용해야 합니다. 모니터와 compose 헬스체크를 업데이트하세요. - 검색이 실행되는 위치가 바뀝니다. Docker 스택에서는 검색이 여러분의 인프라에 그대로 있습니다. Local에서는 Firecrawl Cloud로 가며, 키 없는 검색은 속도 제한이 걸립니다. 어떤 데이터도 머신 밖으로 나가면 안 된다면
FIRECRAWL_CLOUD=off로 설정하세요. 다만 이 경우 검색은 동작하지 않습니다.
속도와 메모리: 주장을 신중하게 읽기
Firecrawl의 X 런치 포스트는 Firecrawl Local이 "셀프 호스팅 대비 37배 빠른 Rust 기반 scrape 프리미티브"이며 "메모리 사용량이 230배 적다(유휴 시 11 MB)"고 밝힙니다. 해당 게시물은 첫날 약 32.4만 조회수와 3.2천 좋아요를 기록했습니다.
이 수치는 Firecrawl의 주장으로 받아들이세요. README에는 벤치마크 방법도, 페이지 세트도, 하드웨어도 공개되어 있지 않으므로 "37배"가 무엇을 측정한 것인지 알 수 없습니다. 다만 아키텍처 관점에서 방향성은 뒷받침됩니다. 유휴 상태의 프로세스 하나가, compose 제한만으로 API와 Playwright 서비스에만 최대 12 GB를 허용하는 다섯 개 컨테이너보다 훨씬 가벼워야 한다는 것은 합리적입니다.
속도가 선택의 기준이라면, 실제 URL로 직접 측정하세요. 동일한 스크레이프를 두 서버에 대해 실행하고 타이밍을 비교한 뒤 마크다운이 일치하는지 확인하세요. 아래 Apidog CLI 관련 섹션에서 이를 반복 가능한 테스트로 만드는 방법을 보여드립니다.
보안, 클라우드 핸드오프, 데이터 흐름
셀프 호스팅은 완전한 제어와 완전한 책임을 부여합니다. 가이드의 퀵스타트는 인증을 비활성화하며 이것이 "프로덕션 아키텍처가 아니다"라고 경고하므로, 영구 볼륨, 인증, TLS, 모니터링은 여러분이 직접 추가해야 합니다.
Firecrawl Local은 단일 머신을 위한 더 엄격한 기본값과 함께 제공됩니다:
serve는127.0.0.1에 바인딩되며,--allow-private를 전달하지 않는 한 localhost 및 프라이빗 주소는 거부됩니다.- 링크-로컬 및 클라우드 메타데이터 주소는 모든 모드에서(리다이렉트 이후에도 포함) 차단됩니다.
scrape,crawl,mcp는--public-only를 지원하며, README는 신뢰할 수 없는 사이트를 에이전트가 탐색할 때 이를 권장합니다.- 크롤은
robots.txt를 준수합니다.
대가는 클라우드 핸드오프입니다. 기본값 FIRECRAWL_CLOUD=auto로 설정하면 검색, 여러분의 머신을 차단하는 페이지, Alexandria가 Firecrawl Cloud로 갑니다. 해당 결과에는 "source": "firecrawl-cloud"가 붙습니다. 검색만 허용하려면 FIRECRAWL_CLOUD=search로, 아무것도 전송하지 않으려면 off로 설정하세요.
Firecrawl의 데이터 제공자 카탈로그인 Alexandria는 무료 계정과 firecrawl-local login이 필요합니다. Firecrawl Alexandria 해설에서 무엇을 반환하는지 다룹니다.
어떤 걸 선택해야 할까?
다음의 경우 Firecrawl Local을 선택하세요:
- AI 에이전트가 노트북에서 스크레이프 및 크롤을 수행하길 원한다.
firecrawl-local init은 각 구성 파일을 먼저 백업하면서 Claude Code, Claude Desktop, Cursor, Windsurf, Gemini CLI, Codex에 MCP 서버를 추가합니다. - 한 시간 이내에 끝나는 짧은 작업을 실행한다.
- 마크다운, HTML, 원시 HTML, 링크만 필요하다.
- Postgres, Redis, RabbitMQ를 직접 관리하고 싶지 않다.
다음의 경우 셀프 호스팅 Firecrawl을 유지하세요:
- 크롤 작업이 재시작 후에도 살아남아야 하거나 한 시간 이상 실행되어야 한다.
- 자체 모델을 통한
json또는summary출력이 필요하다. - 검색이 여러분의 인프라에 머물러야 한다.
- 여러 서비스나 사용자가 하나의 스크레이핑 백엔드를 인증 뒤에서 공유한다.
많은 팀이 둘 다 운영합니다. 노트북과 에이전트에는 Local, 프로덕션에는 Docker 스택이나 Firecrawl Cloud를 쓰는 식이죠. 검색만 필요한 에이전트 구성이라면 Claude용 오픈 소스 웹 검색 정리글에서 다른 옵션을 확인할 수 있고, Firecrawl MCP 및 llms.txt 가이드에서는 호스팅 MCP 서버를 다룹니다.
SDK 코드를 셀프 호스팅에서 Local로 마이그레이션하기
SDK 코드는 바뀌지 않습니다. URL만 바꾸면 됩니다. Python 또는 Node SDK의 API URL을 http://localhost:3002로 설정하고, 로컬 라우트에는 API 키를 넣지 마세요. 전환하기 전에 여러분의 코드에 v0나 v1 호출이 없는지, json, summary, actions를 요청하지 않는지, 한 시간이 넘은 크롤 ID를 폴링하거나 serve 재시작을 넘나들며 폴링하지 않는지 확인하세요.
코딩 에이전트가 Apidog CLI로 패리티 테스트를 실행하게 하기
백엔드를 전환하는 것은 계약(contract) 문제입니다. Local의 /v2/scrape가 여러분의 코드가 이미 파싱하는 것과 동일한 형태를 반환하는지 말이죠. 응답을 손으로 diff하지 마세요. 두 서버를 나란히 실행하고(Docker는 3002, firecrawl-local serve --port 3012) 코딩 에이전트가 Apidog CLI로 둘 다 테스트하도록 하세요.
한 번만 설정하면 됩니다:
npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
apidog skill install
그런 다음 에이전트에 프롬프트 하나를 주세요:
Self-hosted Firecrawl runs on http://localhost:3002 and Firecrawl Local on
http://localhost:3012. In Apidog project <id>, create two environments,
"self-hosted" and "local". Add test cases for POST /v2/scrape on
https://example.com (assert 200, success: true, non-empty data.markdown) and
POST /v2/map (assert 200 and a non-empty links array). Run the cases against
both environments and tell me every assertion that differs.

에이전트는 페이로드 스키마를 읽고, 검증한 뒤, 동일한 케이스를 두 번 실행합니다:
firecrawl-local serve --port 3012 &
apidog environment create self-hosted --project <id> --base-url http://localhost:3002
apidog environment create local --project <id> --base-url http://localhost:3012
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file scrape-case.json
apidog test-case create --project <id> --file scrape-case.json
apidog run --test-case <caseId> --project <id> -e <selfHostedEnvId> -r cli,json --out-file self-hosted
apidog run --test-case <caseId> --project <id> -e <localEnvId> -r cli,json --out-file local
Apidog CLI는 여러분의 머신에서 요청을 보내므로 두 localhost 포트 모두 접근 가능합니다. -r cli,json을 -r junit으로 바꾸면 Firecrawl을 업그레이드할 때마다 동일한 검사를 CI에서 실행할 수 있습니다. Apidog CLI CI/CD 가이드에서 설정을, Claude Code에서의 Apidog CLI에서 에이전트 쪽을 다룹니다. Apidog의 Free 요금제는 최대 4명 팀까지 커버합니다.
FAQ
Firecrawl Local이 셀프 호스팅 Firecrawl을 대체하나요? 아닙니다. apps/local에 있는 별도의 빌드입니다. apps/api의 전체 서버와 그 셀프 호스팅 가이드는 그대로이며, 영구 작업과 LLM 포맷을 위해서는 여전히 필요합니다.
Firecrawl Local이 정말 셀프 호스팅 Firecrawl보다 37배 빠른가요? 런치 포스트에서 언급한 Firecrawl의 주장이며, 메모리 230배 절감과 유휴 시 11 MB도 함께 언급되었습니다. README에 벤치마크 방법이 공개되어 있지 않으므로, 실제 URL로 직접 테스트해 보세요.
Firecrawl Local이 클라우드 없이 동작하나요? 네. FIRECRAWL_CLOUD=off로 설정하면 스크레이핑, 크롤링, 매핑이 머신에 머뭅니다. 다만 검색, 차단된 페이지 폴백, Alexandria는 동작을 멈춥니다.
셀프 호스팅 Firecrawl은 무료인가요? 코드는 서버와 Local 모두 AGPL-3.0으로 무료입니다. 머신 비용과 Postgres, Redis, RabbitMQ를 직접 운영하는 시간을 지불하는 셈이죠.
AI 에이전트는 어느 쪽을 써야 하나요? 대부분의 경우 Firecrawl Local입니다. firecrawl-local init이 여섯 가지 에이전트 도구에 MCP 서버로 등록해 주며, --public-only는 에이전트가 사설 네트워크에 접근하는 것을 막아줍니다.
