docs: fix verified SDK, CLI, and MCP drift
Merged
DA
3mo ago+101+101+012345678901234567890123456789-14-14-01234567890123456789
Why
The initial documentation reconciliation identified 26 candidates across API, SDK, CLI, and MCP surfaces. This narrowed change fixes the six highest-confidence documentation mismatches that can land independently, while leaving automation and new dependencies for separate review.
Summary
- Require Node.js 22 or newer in the Node.js quickstart, matching the published JavaScript SDK.
- Replace v1-only
crawlUrlAndWatchguidance with the v2watcher(jobId, options)API. - Show Python v2 metadata as
source_urlafter SDK normalization. - Make the CLI links-to-
jqexample request JSON explicitly. - Clarify that
firecrawl_crawlwaits for a terminal result. - Show MCP Extract data as JSON serialized inside
content[0].text. - Add the initial 26-candidate drift report, with the remaining findings kept open or decision-dependent.
This PR adds no workflow, schedule, package dependency, or repository-secret requirement. The static reconciler and Doc Detective are deferred to separately reviewed follow-ups.
Test plan
- Verified the Node.js claims against published
@mendable/firecrawl-js@4.32.0. - Verified Python metadata normalization against published
firecrawl-py==4.34.0. - Verified and locally executed the relevant formatter from published
firecrawl-cli@1.19.29; single-format links are newline-delimited and--jsonreturns alinksarray. - Verified MCP crawl completion and text serialization against published
firecrawl-mcp@3.23.4. - Rendered all six edited routes at 1440×900 and 390×844; corrected text and main content are visible, with no horizontal overflow or browser errors.
mint validatereports the same 17 pre-existing missing-import warnings as clean currentmain; this change introduces no validation warning.git diff --checkpasses.
Known limitations
- The report is a point-in-time inventory; the six fixed findings were reverified against published packages, while the other 20 candidates remain open or decision-dependent.
- Base English/source pages only; localized pages were not edited.
- No live API request was needed because published package source and local formatter execution establish the changed claims.