docs: fix verified SDK, CLI, and MCP drift

Merged
DA
3mo ago
+101-14

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 crawlUrlAndWatch guidance with the v2 watcher(jobId, options) API.
  • Show Python v2 metadata as source_url after SDK normalization.
  • Make the CLI links-to-jq example request JSON explicitly.
  • Clarify that firecrawl_crawl waits 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 --json returns a links array.
  • 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 validate reports the same 17 pre-existing missing-import warnings as clean current main; this change introduces no validation warning.
  • git diff --check passes.

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.