- 01
/plugin marketplace add firecrawl/skills - 02
/plugin install firecrawl@firecrawl-skills
Give it the address of a page and your app gets the contents back in a form code can work with — clean text, the raw HTML, the links on it, or a picture of it.
WHEN TO USE
USE FOR
- Pull a company or product page into the app to enrich an existing record.
- Turn a documentation page into markdown for a knowledge base or search index.
- Track a pricing or changelog page over time to catch when it updates.
- Check a page periodically to confirm its content still matches expectations.
NOT FOR
- Don't use this before you have the URL; start with firecrawl-build-search instead.
- Don't use this when content only appears after clicks or navigation; escalate to firecrawl-build-interact.
This is a saved copy of the skill's SKILL.md instructions. It may differ from the upstream file or the version you install.
Firecrawl Build Scrape
Use this when the application already has the URL and needs content from one page.
Use This When
- the feature starts from a known URL
- you need page content for retrieval, summarization, enrichment, or monitoring
- you want the default extraction primitive before considering
/interact
Default Recommendations
- Return
markdownunless the feature truly needs another format. - Use
onlyMainContentfor article-like pages where nav and chrome add noise. - Add waits or other rendering options only when the page needs them.
Freshness and Liveness
- Firecrawl reuses recently indexed content, which is what makes repeat reads of the same URL fast. Set
maxAge(milliseconds) to bound how old a reused copy may be, ormaxAge: 0to skip index reuse for a freshness-critical read. - Read
metadata.cacheStateandmetadata.cachedAtto see what you actually got. - A successful scrape reports what the page returned. Whether the thing the page describes is still active is a source-specific judgment your code makes.
- See references/freshness-and-liveness.md for the tradeoff, the metadata, and the decision rule.
Common Product Patterns
- knowledge ingestion from known URLs
- enrichment from a company, product, or docs page
- pricing, changelog, and documentation extraction
- page-level quality checks or monitoring
Escalation Rules
- If you do not have the URL yet, start with firecrawl-build-search.
- If content requires clicks, typing, or multi-step navigation, escalate to firecrawl-build-interact.
Implementation Notes
- Keep the integration narrow: one feature, one URL, one extraction contract.
- Treat
/scrapeas the default primitive for downstream LLM or indexing pipelines. - Request richer formats only when the consumer needs them, such as links, screenshots, or branding data.
Docs (Source of Truth)
Read the source-of-truth page for your project language before writing integration code:
- Node / TypeScript: docs.firecrawl.dev/agent-source-of-truth/node
- Python: docs.firecrawl.dev/agent-source-of-truth/python
- Rust: docs.firecrawl.dev/agent-source-of-truth/rust
- Java: docs.firecrawl.dev/agent-source-of-truth/java
- Elixir: docs.firecrawl.dev/agent-source-of-truth/elixir
- cURL / REST: docs.firecrawl.dev/agent-source-of-truth/curl
See Also
Account or credentials required
- 01
You set:
FIRECRAWL_API_KEY
- Listed as free
- Connected services may require an account or charge fees.
- Installation
- 2 commands — the skill arrives with its plugin.
This skill ships inside the Firecrawl Skills plugin. Listed package contents include an MCP server. Installed components and skill versions may vary by AI tool.
Install as a Claude Code plugin
Typed inside the agent's own prompt, not in a terminal. This skill uses files kept elsewhere in its plugin, so install the whole plugin — on its own the skill would be missing them.
The repository is licensed under ISC — use, modification, and redistribution are allowed under that license’s terms.
View the repository’s license file on GitHub →