v2.2.0

Features

• MCP version 3 is live. Stable support for cloud mcp with HTTP Transport and SSE modes. Compatible with v2 and v1 from.
• Webhooks: Now we support signatures + extract support + event failures
• Map is now 15x faster + supports more urls
• Search reliability improvements
• Usage is now tracked by API Key
• Support for additional locations (CA, CZ, IL, IN, IT, PL, and PT)
• Queue status endpoint
• Added maxPages parameter to v2 scrape API for pdf parsing

Improvements

• API:
  • New /team/queue-status endpoint.
  • Added nuq feature.
  • Added VIASOCKET integration.
  • Historical credit/token usage endpoints with expanded data.
• Student Program: Support for more universities + students to get free credits through our student program
• Map: 15x faster and increased the limit to 100k
• Scrape API: Added maxPages parameter for PDF parser.
• Python SDK:
  • Added get_queue_status to aio + normalization of docs in search results.
  • SDKs: Added next cursor pagination and integration param support.
• Infrastructure: Added static IP proxy pool + proxy location support.
• Webhooks: Implemented signatures, refactored sending, added scrape error events.
• Performance: Optimized map, converted Rust natives to single NAPI library.
• CI/CD: Revamped CI, added pre-commit hooks, cross-platform harness.

🐛 Fixes

• Corrected concurrency limit scaling.
• Fixed search result links/descriptions and retry mechanism for empty results.
• Re-signed expired screenshot URLs.
• Trimmed null chars from PDF titles + fixed encoding.
• Fixed sitemap parsing and added .gz sitemap support.
• Fixed js-sdk zod-to-json-schema import.
• Fixed webhook data format regression.
• Improved credit handling in account object.

🛠️ Chores & Other

• Removed unused dependencies, updated CONTRIBUTING.md.
• Added debug logging, ignored scripts during CI build.
• Various dependency bumps and build improvements.

🔗 Full Changelog: v2.1.0...v2.2.0

What's Changed

• feat(sdks): next cursor pagination by @rafaelsideguide in https://github.com/firecrawl/firecrawl/pull/2067
• feat: add maxPages parameter to PDF parser in v2 scrape API by @devin-ai-integration[bot] in https://github.com/firecrawl/firecrawl/pull/2047
• fix(concurrency-limit): scale! by @mogery in https://github.com/firecrawl/firecrawl/pull/2071
• feat(api): add /team/queue-status endpoint by @mogery in https://github.com/firecrawl/firecrawl/pull/2063
• build(deps): bump actions/checkout from 3 to 5 by @dependabot[bot] in https://github.com/firecrawl/firecrawl/pull/1998
• build(deps): bump actions/setup-python from 4 to 5 by @dependabot[bot] in https://github.com/firecrawl/firecrawl/pull/2028
• build(deps): bump docker/login-action from 1 to 3 by @dependabot[bot] in https://github.com/firecrawl/firecrawl/pull/1996
• build(deps): bump docker/build-push-action from 5 to 6 by @dependabot[bot] in https://github.com/firecrawl/firecrawl/pull/1995
• build(deps): bump actions/setup-node from 3 to 4 by @dependabot[bot] in https://github.com/firecrawl/firecrawl/pull/1997
• feat: historical credit/token usage endpoints + more data in existing usage endpoints by @mogery in https://github.com/firecrawl/firecrawl/pull/2077
• fix(api/tsconfig): remove baseUrl by @mogery in https://github.com/firecrawl/firecrawl/pull/2078
• fix(search): get links and descriptions correctly by @mogery in https://github.com/firecrawl/firecrawl/pull/2076
• fix(api/crawler/sitemap): bump sitemap limit by @mogery in https://github.com/firecrawl/firecrawl/pull/2079
• fix(api/scrapeURL/index): re-sign expired screenshot URLs by @mogery in https://github.com/firecrawl/firecrawl/pull/2080
• fix(python-sdk): added missing get_queue_status in aio and added to t… by @rafaelsideguide in https://github.com/firecrawl/firecrawl/pull/2081
• Fix go-html-to-md on Windows (ENG-3398) by @amplitudesxd in https://github.com/firecrawl/firecrawl/pull/2082
• fix(js-sdk): zod-to-json-schema import by @rafaelsideguide in https://github.com/firecrawl/firecrawl/pull/2083
• Replace custom address validation functions with ipaddr.js (ENG-3404) by @amplitudesxd in https://github.com/firecrawl/firecrawl/pull/2084
• fix(api/native/pdf-parser): trim null chars out of pdf titles by @mogery in https://github.com/firecrawl/firecrawl/pull/2086
• Fix sitemap parsing (ENG-3361) by @amplitudesxd in https://github.com/firecrawl/firecrawl/pull/2085
• Implement webhook signatures (ENG-3018) by @amplitudesxd in https://github.com/firecrawl/firecrawl/pull/2087
• Format api and add pre-commit hooks (ENG-3408) by @amplitudesxd in https://github.com/firecrawl/firecrawl/pull/2088
• Fix pre-commit hook by @amplitudesxd in https://github.com/firecrawl/firecrawl/pull/2089

Full Changelog: https://github.com/firecrawl/firecrawl/compare/v2.1.0...v2.2.0