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:
- Search. Tidak ada indeks pencarian di mesin Anda. Search tanpa API key berfungsi, tetapi dibatasi rate limit.
- Halaman yang menolak mesin Anda. Jika sebuah situs memblokir fetch biasa maupun browser lokal, Firecrawl Cloud yang mengambilnya. Tidak perlu akun.
- Penyedia data Alexandria. Ini berjalan di Firecrawl Cloud dan membutuhkan akun gratis. Penjelasan Firecrawl Alexandria kami membahas apa itu penyedia data tersebut.

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:
- Instal build tools. Di macOS jalankan
xcode-select --install. Di Debian atau Ubuntu, instalbuild-essential. - Tambahkan Chrome atau Chromium (opsional) jika Anda membutuhkan halaman yang dirender JavaScript atau screenshot.
- Tambahkan Node.js 22 atau lebih baru (opsional) jika Anda menginginkan MCP server, yang menjalankan paket npm
firecrawl-mcpmelaluinpx. - Masuk (opsional) dengan
firecrawl-local loginuntuk 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:
- Tidak ada format
jsonatausummarysecara lokal. Scrape lokal melewatinya dengan peringatan karena memerlukan model. - Tidak ada
actionsbrowser. Langkah klik, scroll, dan pengetikan diabaikan. - Screenshot membutuhkan Chrome.
- Job hidup di memori. Job crawl dan batch kedaluwarsa satu jam setelah dimulai dan hilang saat
serveberhenti. - Tidak ada rute API v0 atau v1.
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:
scrape,crawl,map, danmcpberjalan untuk orang yang ada di keyboard, sehingga dapat menjangkaulocalhostdan jaringan privat Anda.scrape,crawl, danmcpmenerima--public-onlyuntuk menolak alamat-alamat tersebut.serveterikat ke127.0.0.1dan menolak target localhost maupun privat kecuali Anda memberikan--allow-private. Mengikat alamat lain dengan--hostmemerlukan--token.- Alamat link-local dan metadata cloud selalu diblokir, termasuk setelah redirect dan resolusi DNS.
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
- Developer yang membangun scraper atau pipeline RAG yang menginginkan iterasi cepat dan gratis sebelum membayar volume cloud.
- Pengguna coding agent yang menginginkan pembacaan web di dalam Claude Code, Cursor, atau Codex tanpa mengirim setiap halaman melalui pihak ketiga.
- Tim dengan aturan data yang mengharuskan konten hasil fetch tetap berada di mesin, menggunakan
FIRECRAWL_CLOUD=off.
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.

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.
