DEV Community

Cover image for Firecrawl Local คืออะไร? รัน Firecrawl บนเครื่องของคุณเอง
Thanawat Wongchai
Thanawat Wongchai

Posted on Originally published at apidog.com

Firecrawl Local คืออะไร? รัน Firecrawl บนเครื่องของคุณเอง

Firecrawl Local คือไบนารี Rust ไฟล์เดียวที่ใช้ scrape, crawl และ map เว็บไซต์ให้กลายเป็น markdown สะอาด ๆ บนเครื่องของคุณเอง ติดตั้งได้ด้วย cargo install firecrawl-local และสามารถให้บริการ Firecrawl v2 API บน localhost:3002 ได้โดยไม่ต้องใช้ API key ไม่ต้องมีฐานข้อมูล ไม่ต้องมีคิว และไม่ต้องใช้ container ส่วนฟีเจอร์ค้นหาและอีก quelques อย่างยังคงส่งต่อไปยัง Firecrawl Cloud ซึ่งคุณสามารถปิดได้

ลองใช้ Apidog วันนี้

ด้านล่างนี้คือสิ่งที่รันบนแล็ปท็อปของคุณ สิ่งที่ส่งไปยังคลาวด์ วิธีติดตั้ง เส้นทาง 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
Enter fullscreen mode Exit fullscreen mode

ถ้าไม่ใส่ --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 Local split: scrape, crawl, map and PDF and Office parsing run on your machine with optional Chrome, while search, the blocked-page fallback and Alexandria data go to Firecrawl Cloud under FIRECRAWL_CLOUD=auto, switchable to search or off

ตัวแปรสภาพแวดล้อม 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 จากนั้น:

  1. ติดตั้ง build tools — บน macOS รัน xcode-select --install บน Debian หรือ Ubuntu ติดตั้ง build-essential
  2. เพิ่ม Chrome หรือ Chromium (ทางเลือก) — ถ้าต้องการหน้าเว็บที่ render ด้วย JavaScript หรือ screenshots
  3. เพิ่ม Node.js 22 ขึ้นไป (ทางเลือก) — ถ้าต้องการ MCP server ซึ่งรันแพ็กเกจ npm firecrawl-mcp ผ่าน npx
  4. ลงชื่อเข้าใช้ (ทางเลือก) — ด้วย firecrawl-local login สำหรับ Alexandria providers

ติดตั้งไบนารีจาก crates.io

cargo install firecrawl-local
firecrawl-local --version
Enter fullscreen mode Exit fullscreen mode

ถ้าต้องการ 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"]}'
Enter fullscreen mode Exit fullscreen mode

เส้นทางเหล่านี้รันบนเครื่องของคุณ:

เส้นทาง ทำอะไร
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 เพื่อปฏิเสธที่อยู่เหล่านั้น
  • serve bind กับ 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
Enter fullscreen mode Exit fullscreen mode

จากนั้นถาม 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.
Enter fullscreen mode Exit fullscreen mode

Coding agent workflow: the agent starts firecrawl-local serve on localhost:3002, Apidog CLI imports the spec, creates test cases and runs them against POST /v2/scrape, POST /v2/map and GET /health, and writes a cli, json or junit report

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
Enter fullscreen mode Exit fullscreen mode

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)