Firecrawl published firecrawl-py 4.45.0 and @mendable/firecrawl-js 4.42.0 on 2026-09-28, shipping agent_hints preservation from #4641: with X-Firecrawl-Agent-Hints: true, Search/Scrape/Parse/Map responses can include deterministic next-step suggestions. Also includes Hangar browser/interact migration and exchange.onTermsRequired fields.

Key Takeaways

  • ✓Shipped firecrawl-py 4.45.0 + JS 4.42.0 with agent_hints preservation
  • ✓Opt-in via X-Firecrawl-Agent-Hints: true (off by default)
  • ✓Deterministic next-step rules for Search/Scrape/Parse/Map
  • ✓MCP pin still on 4.40.0 — bump needed for full hint survival
🧭

Finished reading? Explore benchmark rankings & pricing

Real-world SWE-bench scores & $20/mo vs API cost break-even calculator

🏆 Leaderboard→💰 Compare Plans↗
🔗

Project Links & Resources

Direct Access
Direct access to official project resources and documentation
🐙
PR #4786 SDK bump for agent hints
github.com/firecrawl/firecrawl/pull/4786
↗
🐙
PR #4641 agent_hints API feature
github.com/firecrawl/firecrawl/pull/4641
↗
🐙
firecrawl/firecrawl repository
github.com/firecrawl/firecrawl
↗
📖
Firecrawl Search docs
docs.firecrawl.dev/features/search
↗
🌐
PyPI firecrawl-py 4.45.0
pypi.org/project/firecrawl-py/4.45.0/
↗
🌐
npm @mendable/firecrawl-js
www.npmjs.com/package/@mendable/firecrawl-js
↗
📖
Python SDK 文档
docs.firecrawl.dev/sdks/python
↗
🔬

In-Depth Technical Analysis

Core Background & Industry Pain Points

Agents that Search/Scrape the web often stall without machine-readable next steps—empty results, same-origin URL clusters, 401 pages, and truncated PDFs need deterministic follow-ups, not fragile prompts.

Architecture Highlights & Internals

#4641 adds optional agent_hints: string[] on v2 Search/Scrape/Parse/Map when X-Firecrawl-Agent-Hints: true is set. #4786 publishes that preservation in firecrawl-py 4.45.0 and JS 4.42.0, plus Hangar browser/interact and onTermsRequired.

Authoritative Benchmarks & Measured Scores

No new first-party table ships with this SDK bump. Docs cite a third-party Agentic Search Benchmark Agent Score mean 14.58 (rank 2/8, n=100)—validate hint firing and MCP pin versions on your agents.

Developer Hands-on Guide

Upgrade with pip install -U firecrawl-py==4.45.0 or npm i @mendable/[email protected], enable the agent-hints header on agent/MCP paths, and bump MCP pins past 4.40.0. See Search docs.