Skip to content

fix: use Firecrawl v2 scrape endpoint in remaining examples - #16

Open
memosr wants to merge 1 commit into
sapiom:mainfrom
memosr:fix/firecrawl-v2-endpoints
Open

fix: use Firecrawl v2 scrape endpoint in remaining examples#16
memosr wants to merge 1 commit into
sapiom:mainfrom
memosr:fix/firecrawl-v2-endpoints

Conversation

@memosr

@memosr memosr commented Aug 19, 2026

Copy link
Copy Markdown

What the skill does

Fixes three code examples that still call the legacy Firecrawl /v1/scrape endpoint while the rest of the repo already uses /v2/scrape.

Why it's useful

The repo has an inconsistent Firecrawl version across skills:

File Before
skills/sapiom-agent-builder/templates/basic-cron.js /v1/scrape
skills/sapiom-agent-builder/references/capabilities.md /v1/scrape
skills/sapiom-deploy/references/patterns.md /v1/scrape

Meanwhile references/web-scraping.md, references/scraping.md and templates/llm-agent.js already use /v2/scrape.

Two problems this causes:

  1. A single skill contradicts itself. In sapiom-agent-builder, references/web-scraping.md documents /v2/scrape but references/capabilities.md and templates/basic-cron.js show /v1/scrape. An agent loading that skill gets conflicting guidance for the same call.
  2. basic-cron.js is a template users copy and deploy. It is running code, not just prose, so the stale path ships into user projects.

Firecrawl v2 is the current API and the v2 scrape endpoint is significantly faster thanks to caching. This aligns the stragglers with both upstream Firecrawl and the rest of this repo, and matches the CONTRIBUTING guidance that code examples should work and volatile details should not be left stale.

How you tested it

  • Grepped every Firecrawl endpoint reference in skills/ and confirmed /v1/scrape now returns zero matches.
  • Verified each of the three request bodies was already v2-compatible (url plus optional formats), so only the path changed. No body, response-shape, or parameter changes were needed. Response access (data.data.markdown, data.data.metadata.title) is unchanged and valid on v2.
  • Diff is exactly 3 lines across 3 files.

Not a behaviour change for anything else in the repo.

Three code examples still called /v1/scrape while the rest of the
repo had already migrated to /v2/scrape. Request bodies were already
v2-compatible, so only the path changed.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant