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
Firecrawl SDKs ship agent_hints: Python 4.45.0 / JS 4.42.0 preserve deterministic next-step guidance for agents
🖼️Official Media
Click to view high-res
🧭

Turn your technical choice into a development budget

Compare 40 dev plans & simulate token costs vs $20/mo subscriptions

🔬

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.

Action HubReady to adopt this in production?

Benchmark side-by-side against alternatives, or calculate monthly token cost vs subscription break-even.

Up NextFactory launches Droid 1.0: programmatic tool calling by default, hundreds of tool calls per model request, leads native harnesses on its own Terminal-Bench 4 runs
Read Now→