Firecrawl Local คือไบนารี Rust ไฟล์เดียวที่ใช้ scrape, crawl และ map เว็บไซต์ให้กลายเป็น markdown สะอาด ๆ บนเครื่องของคุณเอง ติดตั้งได้ด้วย cargo install firecrawl-local และสามารถให้บริการ Firecrawl v2 API บน localhost:3002 ได้โดยไม่ต้องใช้ API key ไม่ต้องมีฐานข้อมูล ไม่ต้องมีคิว และไม่ต้องใช้ container ส่วนฟีเจอร์ค้นหาและอีก quelques อย่างยังคงส่งต่อไปยัง Firecrawl Cloud ซึ่งคุณสามารถปิดได้
ด้านล่างนี้คือสิ่งที่รันบนแล็ปท็อปของคุณ สิ่งที่ส่งไปยังคลาวด์ วิธีติดตั้ง เส้นทาง API ที่ให้บริการ ข้อจำกัด และวิธีให้ coding agent ของคุณทดสอบ API ภายในเครื่องด้วย Apidog CLI
Firecrawl Local คืออะไร?
Firecrawl Local คือเวอร์ชันโอเพนซอร์สที่รันบนอุปกรณ์ของคุณเองของ Firecrawl เป็นไบนารีไฟล์เดียวที่ดึงหน้าเว็บ ทำความสะอาดด้วยโค้ด HTML-cleaning ตัวเดียวกับที่ hosted Firecrawl API ใช้ แล้วส่งคืนเป็น markdown, HTML หรือ links ใช้งานได้ทั้งในรูปแบบ CLI, MCP server สำหรับ AI agents หรือเป็นสำเนา Firecrawl v2 API ภายในเครื่อง
Firecrawl ประกาศเปิดตัวเมื่อวันที่ 18 พฤศจิกายน 2026 ในโพสต์เปิดตัวบน X และโค้ดอยู่ในโฟลเดอร์ apps/local ของ repository Firecrawl แพ็กเกจเผยแพร่บน crates.io ในชื่อ firecrawl-local และ repository ใช้สัญญาอนุญาต AGPL-3.0
Firecrawl อ้างว่าเร็วกว่า self-hosted Firecrawl ถึง 37 เท่า และใช้หน่วยความจำน้อยกว่า 230 เท่า (11 MB ตอนว่าง) แต่ใน README ไม่ได้เผยแพร่วิธีการ benchmark จึงควรถือว่าเป็นคำกล่าวอ้างของผู้ขาย
ถ้าคุณคุ้นเคยกับ hosted API หรือ Firecrawl CLI แนวคิดก็ง่ายมาก: การเรียกแบบเดิม แต่ตอบกลับบนเครื่องของคุณ
Firecrawl Local ทำงานอย่างไร: หนึ่งไบนารี สิบคำสั่ง
ทุกฟีเจอร์อยู่ภายใต้ subcommand ของ firecrawl-local นี่คือรายการทั้งหมดจาก README:
| คำสั่ง | ทำอะไร | รันที่ไหน |
|---|---|---|
scrape <urls...> |
Scrape หนึ่ง URL หรือมากกว่า | เครื่องของคุณ |
crawl <url> |
ไล่ตามลิงก์จาก URL เริ่มต้น | เครื่องของคุณ |
map <url> |
แสดงรายการ URL ของเว็บไซต์จาก sitemaps และหน้าเริ่มต้น | เครื่องของคุณ |
serve |
รัน Firecrawl v2 API บน localhost | เครื่องของคุณ |
mcp |
รัน Firecrawl MCP server ผ่าน stdio | เครื่องของคุณ (บางเครื่องมืออยู่บนคลาวด์) |
init |
เพิ่ม MCP server ไปยังเครื่องมือ AI บนเครื่องนี้ | เครื่องของคุณ |
search <query> |
ค้นหาเว็บ | Firecrawl Cloud |
find-tools <query> |
ค้นหา Alexandria data providers | Firecrawl Cloud (ต้องลงชื่อเข้าใช้) |
data <provider> <capability> |
รัน Alexandria data provider | Firecrawl Cloud (ต้องลงชื่อเข้าใช้) |
login |
ลงชื่อเข้าใช้ Firecrawl ผ่านเบราว์เซอร์ | Firecrawl Cloud |
สามคำสั่งครอบคลุมการใช้งานประจำวันส่วนใหญ่:
# 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
ถ้าไม่ใส่ --markdown คำสั่ง scrape จะพิมพ์ JSON ของ Firecrawl API --format รองรับ markdown, html, rawHtml และ links ส่วน PDF และเอกสาร Office ก็ถูก parse ภายในเครื่องเช่นกัน
สำหรับหน้าเว็บที่ใช้ JavaScript จะใช้งาน Chrome หรือ Chromium ที่คุณมีอยู่แล้ว ถ้าไม่มี หน้าเว็บแบบ static ก็ยังใช้งานได้ และหน้าที่ต้องใช้เบราว์เซอร์จะส่งคำเตือนกลับมา --browser auto|never|always ใช้ตัดสินว่าจะเรียกใช้ Chrome เมื่อไหร่
อะไรบ้างรันภายในเครื่อง vs บน Firecrawl Cloud
การ scrape, crawl, map และ parse เอกสารรันบนเครื่องของคุณและไม่ส่งอะไรไปยัง Firecrawl เลย มีสามฟีเจอร์ที่ส่งไปยัง Firecrawl Cloud เพราะแล็ปท็อปไม่มี index ไม่มีเครือข่าย หรือไม่มีข้อมูลเหล่านั้น:
- Search — ไม่มี search index บนเครื่องคุณ การค้นหาแบบไม่ใช้ key ใช้งานได้แต่มี rate limit
- หน้าที่ปฏิเสธเครื่องคุณ — ถ้าเว็บไซต์บล็อกทั้งการ fetch แบบธรรมดาและเบราว์เซอร์ภายในเครื่อง Firecrawl Cloud จะดึงให้ ไม่ต้องมีบัญชี
- Alexandria data providers — เหล่านี้รันบน Firecrawl Cloud และต้องมีบัญชีฟรี บทความ Firecrawl Alexandria อธิบาย ของเราครอบคลุมว่ามันคืออะไร
ตัวแปรสภาพแวดล้อม FIRECRAWL_CLOUD ควบคุมการส่งต่อ:
| ค่า | ผลลัพธ์ |
|---|---|
auto (ค่าเริ่มต้น) |
Search, blocked-page fallback และ Alexandria ทำงานทั้งหมด |
search |
เฉพาะ search ที่ส่งไป Firecrawl Cloud |
off |
ไม่มีอะไรส่งไป Firecrawl Cloud |
ค่าที่ไม่รู้จักจะถูกนับเป็น off ผลลัพธ์ที่ดึงจากคลาวด์จะมี "source": "firecrawl-cloud" ถ้าคลาวด์ล้มเหลวเช่นกัน คุณจะได้ "blocked": true
การเรียกไปยังคลาวด์จะแนบ install ID แบบสุ่มและชื่อเครื่องมือที่เรียก ซึ่งเป็นวิธีที่ Firecrawl ใช้นับจำนวนการติดตั้ง
วิธีติดตั้ง Firecrawl Local
คุณต้องมี Rust และ C compiler จากนั้น:
-
ติดตั้ง build tools — บน macOS รัน
xcode-select --installบน Debian หรือ Ubuntu ติดตั้งbuild-essential - เพิ่ม Chrome หรือ Chromium (ทางเลือก) — ถ้าต้องการหน้าเว็บที่ render ด้วย JavaScript หรือ screenshots
-
เพิ่ม Node.js 22 ขึ้นไป (ทางเลือก) — ถ้าต้องการ MCP server ซึ่งรันแพ็กเกจ npm
firecrawl-mcpผ่านnpx -
ลงชื่อเข้าใช้ (ทางเลือก) — ด้วย
firecrawl-local loginสำหรับ Alexandria providers
ติดตั้งไบนารีจาก crates.io
cargo install firecrawl-local
firecrawl-local --version
ถ้าต้องการ build จากโค้ดล่าสุดแทน ให้รัน cargo build --release ใน apps/local ของ repo ที่ clone มา
Firecrawl Local API: เส้นทาง v2 บน localhost:3002
firecrawl-local serve ตอบสนอง Firecrawl v2 API บนพอร์ต 3002 ไม่ต้องใช้ API key สำหรับเส้นทางภายในเครื่อง
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"]}'
เส้นทางเหล่านี้รันบนเครื่องของคุณ:
| เส้นทาง | ทำอะไร |
|---|---|
POST /v2/scrape |
Scrape หนึ่ง URL |
POST /v2/map |
แสดงรายการ URL ของเว็บไซต์ |
POST /v2/crawl, GET and DELETE /v2/crawl/{id}
|
เริ่ม ตรวจสอบ และยกเลิก crawl |
POST /v2/batch/scrape, GET and DELETE /v2/batch/scrape/{id}
|
เริ่ม ตรวจสอบ และยกเลิก batch scrape |
GET /health |
ตรวจสอบสถานะ |
เส้นทาง /v2 อื่น ๆ ทั้งหมด เช่น /v2/search จะถูกส่งต่อไปยัง Firecrawl Cloud เว้นแต่ FIRECRAWL_CLOUD จะกำหนดไว้เป็นอย่างอื่น เส้นทาง v0 และ v1 ไม่ได้ให้บริการ
โค้ดที่มีอยู่แล้วย้ายมาได้โดยเปลี่ยนแค่การตั้งค่าเดียว: ชี้ API URL ของ Firecrawl SDK ใด ๆ ไปที่ http://localhost:3002 scraper หรือ RAG pipeline ของคุณยังคงโค้ดเดิมไว้ และคุณหยุดใช้ cloud credits ระหว่างที่ทำ iteration สำหรับภาพรวมของ scraping pipelines เพิ่มเติม ดูคู่มือ Firecrawl web scraping ของเรา
Firecrawl Local ในฐานะ MCP server สำหรับ AI agents
firecrawl-local init จะลงทะเบียน Firecrawl Local เป็น Model Context Protocol server ในทุกเครื่องมือ AI ที่มันตรวจพบ มันรู้จัก Claude Code, Claude Desktop, Cursor, Windsurf, Gemini CLI และ Codex สำรองไฟล์ config แต่ละไฟล์ก่อน และมี --dry-run ให้ดูตัวอย่างการเปลี่ยนแปลง หรือ --agent cursor เพื่อตั้งค่าเฉพาะเครื่องมือเดียว
Agent ของคุณจะได้รับเครื่องมือ Firecrawl MCP มาตรฐาน: scrape, crawl, map และ batch scrape รันภายในเครื่อง ส่วนที่เหลือส่งไป Firecrawl Cloud
ถ้า agent ของคุณเข้าชมเว็บไซต์ที่คุณไม่ไว้วางใจ ให้ลงทะเบียนเป็น firecrawl-local mcp --public-only มิฉะนั้นหน้าเว็บที่มีคำสั่งซ่อนอยู่อาจชี้นำให้ agent เปิด URL ภายในเครือข่ายของคุณได้
ข้อจำกัดของ Firecrawl Local
Firecrawl Local ไม่ใช่ Firecrawl server แบบเต็มรูปแบบ README ระบุสิ่งที่ขาดหายไป:
-
ไม่มีรูปแบบ
jsonหรือsummaryภายในเครื่อง — การ scrape ภายในเครื่องจะข้ามไปพร้อมคำเตือน เพราะต้องใช้โมเดล -
ไม่มี browser
actions— ขั้นตอนคลิก เลื่อน และพิมพ์จะถูกเพิกเฉย - Screenshots ต้องใช้ Chrome
-
Jobs อยู่ในหน่วยความจำ — Crawl และ batch jobs หมดอายุหนึ่งชั่วโมงหลังเริ่ม และจะหายไปเมื่อ
serveหยุด - ไม่มีเส้นทาง API v0 หรือ v1
สำหรับคิว, workers และทุกรูปแบบ server แบบเต็มใน apps/api ยังมีอยู่ ครอบคลุมในคู่มือ self-hosting ของ Firecrawl
ค่าเริ่มต้นด้านความปลอดภัยที่ควรรู้
ค่าเริ่มต้นแตกต่างกันตามคำสั่ง เพราะ serve รับคำขอจากโปรแกรมอื่น:
-
scrape,crawl,mapและmcpรันให้คนที่นั่งอยู่หน้าแป้นพิมพ์ จึงเข้าถึงlocalhostและเครือข่ายส่วนตัวของคุณได้scrape,crawlและmcpรับ--public-onlyเพื่อปฏิเสธที่อยู่เหล่านั้น -
servebind กับ127.0.0.1และปฏิเสธเป้าหมาย localhost และ private เว้นแต่คุณจะส่ง--allow-privateการ bind ที่อยู่อื่นด้วย--hostต้องใช้--token - ที่อยู่ link-local และ cloud metadata ถูกบล็อกเสมอ รวมถึงหลัง redirect และ DNS resolution
Chrome รันแบบ headless และ sandboxed ด้วยโปรไฟล์ชั่วคราว เมื่อ crawl Firecrawl Local จะอ่าน robots.txt ตาม Robots Exclusion Protocol ซึ่งเจ้าของเว็บไซต์สามารถระบุถึงมันได้ในชื่อ FirecrawlLocal
Firecrawl Local เหมาะกับใคร
- นักพัฒนาที่สร้าง scrapers หรือ RAG pipelines ที่ต้องการ iteration ฟรีและรวดเร็ว ก่อนจ่ายเงินสำหรับ cloud volume
- ผู้ใช้ coding agent ที่ต้องการอ่านเว็บภายใน Claude Code, Cursor หรือ Codex โดยไม่ต้องส่งทุกหน้าผ่านบุคคลที่สาม
-
ทีมที่มีกฎเกณฑ์ด้านข้อมูล ที่ต้องการให้เนื้อหาที่ดึงมายังอยู่บนเครื่อง โดยใช้
FIRECRAWL_CLOUD=off
จะไม่ค่อยเหมาะถ้าคุณพึ่งพาการสกัด json, browser actions หรือ crawl jobs ที่มีอายุยาวนาน ถ้าต้องการแค่ agent search ดูบทความรวบรวมเว็บค้นหาโอเพนซอร์สสำหรับ Claude ของเรา
ให้ coding agent ของคุณทดสอบ API ภายในเครื่องด้วย Apidog CLI
เมื่อ serve รันแล้ว คุณจะมี HTTP API จริงบน localhost:3002 ก่อนที่คุณจะต่อ pipeline เข้ากับมัน ให้ตรวจสอบว่าเส้นทางตอบสนองตามที่โค้ดของคุณคาดหวัง ให้ Apidog CLI และ prompt หนึ่งอันแก่ coding agent ของคุณ แทนการคลิกส่งคำขอด้วยตัวเอง
ตั้งค่าครั้งเดียว:
npm install -g apidog-cli@latest
apidog auth login --with-token <YOUR_TOKEN>
apidog skill install
จากนั้นถาม agent ของคุณ:
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.
Agent จะอ่าน schema ตรวจสอบ payload ของมัน และรันคำสั่งเหล่านี้:
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 ส่งคำขอจากเครื่องของคุณ ดังนั้น localhost:3002 จึงเข้าถึงได้ เปลี่ยน -r cli,json เป็น -r junit แล้วการรันเดียวกันจะใส่ใน CI ได้ทันที คู่มือ Apidog CLI CI/CD ของเราแสดงการตั้งค่า และ Apidog CLI ใน Claude Code อธิบายฝั่ง agent แผน Free ของ Apidog ครอบคลุมทีมสูงสุด 4 ผู้ใช้
คำถามที่พบบ่อย
Firecrawl Local ฟรีหรือไม่? ไบนารีเป็นโอเพนซอร์สภายใต้ AGPL-3.0 และการ scrape, crawl และ map ภายในเครื่องไม่ต้องใช้ API key ส่วน search, blocked-page fallback และ Alexandria ส่งไป Firecrawl Cloud และ Alexandria ต้องมีบัญชีฟรี
ฉันใช้โค้ด Firecrawl SDK เดิมกับ Firecrawl Local ได้ไหม? ได้ สำหรับเส้นทางภายในเครื่อง ตั้งค่า API URL ของ SDK เป็น http://localhost:3002 Scrape, map, crawl และ batch scrape รันภายในเครื่อง ส่วนเส้นทาง v0 และ v1 ไม่ได้ให้บริการ
ฉันจะหยุด Firecrawl Local ไม่ให้เรียกคลาวด์ได้อย่างไร? ตั้ง FIRECRAWL_CLOUD=off Search และ blocked-page fallback จะหยุดทำงาน และไม่มีอะไรออกจากเครื่องคุณยกเว้น login ที่สั่งชัดเจน
Firecrawl Local ต่างจาก self-hosted Firecrawl อย่างไร? Self-hosted Firecrawl คือ server แบบเต็มใน apps/api พร้อมคิว, workers และทุกรูปแบบ Firecrawl Local เป็นไบนารีเดี่ยวที่เบากว่า ซึ่งตัดรูปแบบ json และ summary, browser actions และ jobs แบบถาวรออกไป


Top comments (0)