Tool: Firecrawl
Thin wrapper for the Firecrawl API — turn a URL into clean markdown, or discover a site's URLs. Other skills call this instead of re-describing the API.
Requirements
curljq.envcredentials listed below
Auth
.env:
FIRECRAWL_API_KEY=fc-...
Header: Authorization: Bearer $FIRECRAWL_API_KEY. Base: https://api.firecrawl.dev/v1.
Endpoints
| Action | Endpoint | Use |
|---|---|---|
| Scrape | POST /scrape |
One URL → markdown/html |
| Map | POST /map |
Discover URLs on a domain (sitemap-like) |
Scripts
# Scrape one URL to markdown (prints markdown to stdout)
bash .agents/skills/tool-firecrawl/scripts/scrape.sh https://example.com
# Map a site's URLs (prints JSON array of links)
bash .agents/skills/tool-firecrawl/scripts/map.sh https://example.com
Request shape (scrape)
{ "url": "https://example.com", "formats": ["markdown"], "onlyMainContent": true }
Rules
- Key comes from
.envonly — never inline it or ask for it in chat. - Truncate very large pages (~15000 chars) before feeding to an LLM.
- Handle non-200 / timeouts gracefully; report and let the calling skill degrade.
- Respect target sites' robots and rate limits.
Used by
marketing-company-profile, marketing-service,
intel-competitor-monitoring,
marketing-service-page.