Apa Itu Firecrawl Local? Jalankan Firecrawl di Mesin Anda Sendiri

Firecrawl Local adalah satu binary Rust yang melakukan scraping, crawling, dan pemetaan situs web menjadi markdown di mesin Anda sendiri serta menyediakan Firecrawl v2 API di localhost:3002. Berikut adalah apa yang berjalan secara lokal, apa yang dikirim ke cloud, cara menginstalnya, dan di mana...

INEZA Felin-Michel

INEZA Felin-Michel

19 November 2026

Apa Itu Firecrawl Local? Jalankan Firecrawl di Mesin Anda Sendiri

Apidog untuk Perusahaan

Penerapan On-Premises

SSO & RBAC

Sesuai SOC 2

Jelajahi Apidog Enterprise

Firecrawl Local adalah satu binary Rust yang melakukan scraping, crawling, dan mapping situs web menjadi markdown bersih di mesin Anda sendiri. Anda menginstalnya dengan cargo install firecrawl-local, dan ini dapat menyajikan Firecrawl v2 API di localhost:3002 tanpa API key, tanpa database, tanpa queue, dan tanpa container. Search serta beberapa fitur lain tetap diarahkan ke Firecrawl Cloud, dan Anda dapat mematikannya.

Berikut pembahasannya: apa yang berjalan di laptop Anda, apa yang dikirim ke cloud, cara menginstalnya, rute API yang dilayani, batasannya, dan cara membuat coding agent Anda menguji API lokal dengan Apidog CLI.

Apa itu Firecrawl Local?

Firecrawl Local adalah edisi open-source Firecrawl yang berjalan di perangkat Anda. Ini adalah satu binary yang mengambil halaman web, membersihkannya dengan kode pembersih HTML yang sama dengan yang dipakai Firecrawl API hosted, lalu mengembalikan markdown, HTML, atau tautan. Firecrawl Local berjalan sebagai CLI, sebagai MCP server untuk agen AI, atau sebagai salinan lokal dari Firecrawl v2 API.

Firecrawl mengumumkannya pada 18 November 2026 dalam launch post di X, dan kodenya berada di folder apps/local pada repository Firecrawl. Paketnya dipublikasikan di crates.io sebagai firecrawl-local, dan repository tersebut dilisensikan AGPL-3.0.

Firecrawl mengklaim Firecrawl Local 37x lebih cepat daripada Firecrawl self-hosted dan menggunakan memori 230x lebih sedikit (11 MB saat idle). README tidak menerbitkan metode benchmark, jadi anggap itu sebagai klaim vendor.

Jika Anda mengenal API hosted atau Firecrawl CLI, konsepnya sederhana: panggilan yang sama, dijawab di mesin Anda.

Cara kerja Firecrawl Local: satu binary, sepuluh perintah

Setiap fitur berada di balik subcommand dari firecrawl-local. Berikut daftar lengkapnya dari README:

Perintah Apa fungsinya Berjalan di
scrape <urls...> Scrape satu atau beberapa URL Mesin Anda
crawl <url> Ikuti tautan dari URL awal Mesin Anda
map <url> Daftarkan URL suatu situs dari sitemap dan halaman awal Mesin Anda
serve Jalankan Firecrawl v2 API di localhost Mesin Anda
mcp Jalankan Firecrawl MCP server melalui stdio Mesin Anda, beberapa tool di cloud
init Tambahkan MCP server ke tool AI di mesin ini Mesin Anda
search <query> Cari di web Firecrawl Cloud
find-tools <query> Temukan penyedia data Alexandria Firecrawl Cloud, perlu sign-in
data <provider> <capability> Jalankan penyedia data Alexandria Firecrawl Cloud, perlu sign-in
login Masuk ke Firecrawl melalui browser Firecrawl Cloud

Tiga perintah mencakup sebagian besar penggunaan harian:

# Print one page as markdown
firecrawl-local scrape https://example.com --markdown

# Crawl up to 50 pages and save one markdown file per page
firecrawl-local crawl https://docs.firecrawl.dev --limit 50 --out ./pages

# List every URL on a site
firecrawl-local map https://firecrawl.dev

Tanpa --markdown, scrape mencetak JSON dari Firecrawl API. --format menerima markdown, html, rawHtml, dan links. PDF dan dokumen Office juga di-parse secara lokal.

Untuk halaman JavaScript, Firecrawl Local mengendalikan Chrome atau Chromium yang sudah Anda miliki. Tanpa keduanya, halaman statis tetap berfungsi dan halaman yang membutuhkan browser akan mengembalikan peringatan. --browser auto|never|always menentukan kapan Chrome digunakan.

Apa yang berjalan lokal vs di Firecrawl Cloud

Scraping, crawling, mapping, dan parsing dokumen berjalan di mesin Anda dan tidak mengirim apa pun ke Firecrawl. Tiga fitur diarahkan ke Firecrawl Cloud karena laptop tidak memiliki indeks, jaringan, atau data yang dibutuhkan:

Pemisahan Firecrawl Local: scrape, crawl, map, serta parsing PDF dan Office berjalan di mesin Anda dengan Chrome opsional, sementara search, fallback halaman terblokir, dan data Alexandria diarahkan ke Firecrawl Cloud di bawah FIRECRAWL_CLOUD=auto, yang bisa dialihkan ke search atau dimatikan

Variabel environment FIRECRAWL_CLOUD mengontrol pengalihan ini:

Nilai Efek
auto (default) Search, fallback halaman terblokir, dan Alexandria semuanya berfungsi
search Hanya search yang diarahkan ke Firecrawl Cloud
off Tidak ada yang diarahkan ke Firecrawl Cloud

Nilai yang tidak dikenali dianggap off. Hasil yang diambil dari cloud membawa "source": "firecrawl-cloud"; jika cloud juga gagal, Anda akan mendapatkan "blocked": true.

Panggilan cloud membawa ID instalasi acak dan nama tool yang memanggil, yang menjadi cara Firecrawl menghitung instalasi.

Cara menginstal Firecrawl Local

Anda memerlukan Rust dan kompiler C. Lalu:

  1. Instal build tools. Di macOS jalankan xcode-select --install. Di Debian atau Ubuntu, instal build-essential.
  2. Tambahkan Chrome atau Chromium (opsional) jika Anda membutuhkan halaman yang dirender JavaScript atau screenshot.
  3. Tambahkan Node.js 22 atau lebih baru (opsional) jika Anda menginginkan MCP server, yang menjalankan paket npm firecrawl-mcp melalui npx.
  4. Masuk (opsional) dengan firecrawl-local login untuk penyedia Alexandria.

Instal binary dari crates.io.

cargo install firecrawl-local
firecrawl-local --version

Untuk membangun kode terbaru sebagai alternatif, jalankan cargo build --release di apps/local dari clone repository.

API Firecrawl Local: rute v2 di localhost:3002

firecrawl-local serve melayani Firecrawl v2 API di port 3002. Tidak diperlukan API key untuk rute-rute lokal.

firecrawl-local serve

# in another terminal
curl -s http://localhost:3002/v2/scrape \
  -H 'content-type: application/json' \
  -d '{"url":"https://example.com","formats":["markdown"]}'

Rute-rute ini berjalan di mesin Anda:

Rute Apa fungsinya
POST /v2/scrape Scrape satu URL
POST /v2/map Daftar URL suatu situs
POST /v2/crawl, GET dan DELETE /v2/crawl/{id} Memulai, memeriksa, dan membatalkan crawl
POST /v2/batch/scrape, GET dan DELETE /v2/batch/scrape/{id} Memulai, memeriksa, dan membatalkan batch scrape
GET /health Health check

Setiap rute /v2 lainnya, seperti /v2/search, diteruskan ke Firecrawl Cloud kecuali FIRECRAWL_CLOUD menentukan sebaliknya. Rute v0 dan v1 tidak dilayani.

Kode yang sudah ada dapat dipindahkan hanya dengan mengubah satu pengaturan: arahkan URL API SDK Firecrawl mana pun ke http://localhost:3002. Scraper atau pipeline RAG Anda tetap memakai kodenya, dan Anda berhenti menghabiskan cloud credit selama iterasi. Untuk gambaran lebih luas tentang pipeline scraping, lihat panduan web scraping Firecrawl kami.

Firecrawl Local sebagai MCP server untuk agen AI

firecrawl-local init mendaftarkan Firecrawl Local sebagai server Model Context Protocol di setiap tool AI yang ditemukannya. Firecrawl Local mengenali Claude Code, Claude Desktop, Cursor, Windsurf, Gemini CLI, dan Codex, mencadangkan setiap file konfigurasi terlebih dahulu, serta menerima --dry-run untuk melihat pratinjau perubahan atau --agent cursor untuk menyiapkan satu tool saja.

Agen Anda mendapatkan tool Firecrawl MCP standar: scrape, crawl, map, dan batch scrape berjalan secara lokal, sedangkan sisanya diarahkan ke Firecrawl Cloud.

Jika agen Anda menjelajahi situs yang tidak Anda percayai, daftarkan sebagai firecrawl-local mcp --public-only. Jika tidak, halaman dengan instruksi tersembunyi dapat mengarahkan agen untuk membuka URL internal di jaringan Anda.

Batasan Firecrawl Local

Firecrawl Local bukanlah Firecrawl server lengkap. README mencantumkan apa yang tidak tersedia:

Untuk queue, worker, dan semua format, server lengkap di apps/api tetap tersedia, yang dibahas dalam panduan self-hosting Firecrawl.

Default keamanan yang perlu Anda ketahui

Default-nya berbeda per perintah, karena serve menerima permintaan dari program lain:

Chrome berjalan secara headless dan sandboxed dengan profil sekali pakai. Saat crawling, Firecrawl Local membaca robots.txt sesuai Robots Exclusion Protocol, di mana pemilik situs dapat menyebutnya sebagai FirecrawlLocal.

Untuk siapa Firecrawl Local

Firecrawl Local kurang cocok jika Anda bergantung pada ekstraksi json, actions browser, atau job crawl yang berjalan lama. Jika Anda hanya membutuhkan search untuk agen, lihat kumpulan open-source web search untuk Claude dari kami.

Biarkan coding agent Anda menguji API lokal dengan Apidog CLI

Setelah serve berjalan, Anda memiliki HTTP API sungguhan di localhost:3002. Sebelum menghubungkan pipeline ke sana, pastikan rute-rutenya merespons sesuai yang diharapkan kode Anda. Berikan Apidog CLI dan satu prompt kepada coding agent Anda, alih-alih mengklik satu per satu permintaan.

Siapkan sekali saja:

npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
apidog skill install

Lalu minta agen Anda:

Start firecrawl-local serve in the background. Write an OpenAPI 3 file for its
local routes (POST /v2/scrape, POST /v2/map, GET /health) and import it into
Apidog project <id>. Create an environment pointing at http://localhost:3002,
add test cases that assert /health returns 200 and /v2/scrape returns
success: true with non-empty data.markdown for https://example.com, then run
them and summarize any failures.
Alur kerja coding agent: agen menjalankan firecrawl-local serve di localhost:3002, Apidog CLI mengimpor spesifikasi, membuat test case, dan menjalankannya terhadap POST /v2/scrape, POST /v2/map, dan GET /health, lalu menulis laporan cli, json, atau junit

Agen membaca skema, memvalidasi payload-nya, dan menjalankan perintah seperti ini:

firecrawl-local serve &
apidog import --project <id> --format openapi --file ./firecrawl-local-v2.yaml
apidog environment create firecrawl-local --project <id> --base-url http://localhost:3002
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <id> --file ./case.json
apidog run --test-case <caseId> --project <id> -e <envId> -r cli,json

Apidog CLI mengirim permintaan dari mesin Anda, sehingga localhost:3002 dapat dijangkau. Ganti -r cli,json dengan -r junit dan run yang sama dapat langsung masuk ke CI; panduan Apidog CLI CI/CD kami menunjukkan pengaturannya, dan Apidog CLI di Claude Code membahas sisi agennya. Paket Free Apidog mencakup tim hingga 4 pengguna.

FAQ

Apakah Firecrawl Local gratis? Binary ini open source di bawah AGPL-3.0, dan scraping, crawling, serta mapping lokal tidak memerlukan API key. Search, fallback halaman terblokir, dan Alexandria diarahkan ke Firecrawl Cloud, dan Alexandria memerlukan akun gratis.

Bisakah saya memakai kode Firecrawl SDK yang sudah ada dengan Firecrawl Local? Ya, untuk rute lokal. Atur URL API SDK ke http://localhost:3002. Scrape, map, crawl, dan batch scrape berjalan secara lokal; rute v0 dan v1 tidak dilayani.

Bagaimana cara menghentikan Firecrawl Local agar tidak memanggil cloud? Atur FIRECRAWL_CLOUD=off. Search dan fallback halaman terblokir berhenti berfungsi, dan tidak ada yang keluar dari mesin Anda kecuali login eksplisit.

Apa bedanya Firecrawl Local dengan Firecrawl self-hosted? Firecrawl self-hosted adalah server lengkap di apps/api, dengan queue, worker, dan semua format. Firecrawl Local adalah binary tunggal yang lebih ringan yang menghilangkan format json dan summary, actions browser, serta job persisten.

Mengembangkan API dengan Apidog

Apidog adalah alat pengembangan API yang membantu Anda mengembangkan API dengan lebih mudah dan efisien.