firecrawl

# Firecrawl Firecrawl turns the live web into agent-ready markdown over a plain REST API (`https://api.firecrawl.dev/v2`, `Authorization: Bearer $FIRECRAWL_API_KEY`). Two calls cover most web work: `/search` to discover pages by query, `/scrape` to extract clean content from a URL you already have. Use it whenever a task needs current web information or the content of a specific page. ## Before you start If the user's message only invokes this skill (e.g. "use firecrawl skill") without a concrete task, ask what they want to search or scrape. When the task is concrete, check the credential first: ```bash [ -n "$FIRECRAWL_API_KEY" ] && echo ok || echo missing ``` If missing (also visible in your Vault Keys section), ask the user to add `FIRECRAWL_API_KEY` to this agent's **key vault** — gear icon on the agent card → settings → key vault tab; keys come from the Firecrawl dashboard (https://www.firecrawl.dev/signin). Vault values reach your shell environment on the next task. Only fall back to the keyless tier (below) when the user cannot provide a key right now. ## Search ```bash curl -sS -X POST https://api.firecrawl.dev/v2/search \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" -H "content-type: application/json" \ -d '{"query": "<what you are looking for>", "limit": 5}' \ | jq '[.data.web[] | {url, title, description}]' ``` - Results live in `.data.web[]`, each with `url` / `title` / `description`; `limit` defaults to 10 (per source). - Adding `"scrapeOptions": {...