Agent skill

Firecrawl Agent

by firecrawl in firecrawl/skills

Autonomously navigate websites and extract structured data across pages.

ISCAuto-check passedData & Analytics

Install Firecrawl Agent

skills CLI
$ npx skills add firecrawl/skills --skill firecrawl-agent -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install firecrawl/skills firecrawl-agent --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/firecrawl/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/core/firecrawl-agent .claude/skills/firecrawl-agent && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
firecrawl-agent
GitHub stars
115
Token cost
~1.2k tokens
SKILL.md length
482 words
Files
1
Skills in repo
29
Repo updated
First seen
Licence
ISC

At a glance

Autonomously navigate websites and extract structured data across pages.

  • The task requires navigation
  • SKILL.md covers Quick start, Alexandria providers, Job IDs and Tips, plus 2 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • No suitable ready-made workflow

What it does

Firecrawl Agent is an agent skill from firecrawl/skills. Autonomously navigate websites and extract structured data across pages. Use when the task requires navigation or no suitable ready-made workflow or data provider covers it.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Data & Analytics, covering Web scraping and Schema markup. It works with Firecrawl. The licence is ISC.

When your agent uses it

  • The task requires navigation
  • No suitable ready-made workflow
  • Data provider covers it

Example prompts

  • “/firecrawl-agent”

Requirements

  • Node.js
  • Pre-approved tools (allowed-tools): Bash(firecrawl *), Bash(npx firecrawl-cli *)

What it can do on your machine

Read from SKILL.md and the folder at commit d0ffd7c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash(firecrawl *)
    • Bash(npx firecrawl-cli *)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Firecrawl Agent loads about 1.2k tokens when it runs. Until then it costs about 47 tokens; SKILL.md has 482 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~47
When it runs · the whole SKILL.md, loaded when a task matches
~1.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from firecrawl/skills at commit d0ffd7c, republished under its ISC licence (© firecrawl). 482 words, ~1,229 tokens.

Download SKILL.mdSave it as .claude/skills/firecrawl-agent/SKILL.md (or your agent's skills folder).
name
firecrawl-agent
description
Autonomously navigate websites and extract structured data across pages. Use when the task requires navigation or no suitable ready-made workflow or data provider covers it.
allowed-tools
Bash(firecrawl *), Bash(npx firecrawl-cli *)

firecrawl agent

AI-powered autonomous extraction. The agent navigates sites and extracts structured data (takes 2-5 minutes).

Before starting autonomous extraction for structured records or listings, check firecrawl search alexandria '<data you need>' for a ready-made workflow or data provider. Inspect a matching contract with firecrawl list <provider> <capability> --pretty and execute with firecrawl scrape --alexandria <provider>/<capability> --options '<input JSON>' if it covers the task. Use the exact provider, capability, and input fields from that contract. Continue with Agent when no suitable tool exists or the task requires autonomous navigation.

Quick start

bash
# Extract structured data
firecrawl agent "extract all pricing tiers" --wait --json -o .firecrawl/pricing.json

# With a JSON schema for structured output
firecrawl agent "extract products" --schema '{"type":"object","properties":{"name":{"type":"string"},"price":{"type":"number"}}}' --wait --json -o .firecrawl/products.json

# Focus on specific pages
firecrawl agent "get feature list" --urls "<url>" --wait --json -o .firecrawl/features.json

Run firecrawl agent --help for the full option list.

Done when: the output file contains valid JSON answering the request — or a job ID was intentionally returned for later polling.

Alexandria providers

A run uses connected Alexandria data providers only when it starts with an Alexandria flag: --alexandria, --toolkits <slugs> (up to 5), --max-calls <n>, --require-approval, or --on-terms-required skip|ask. Follow-ups on its thread keep those settings.

bash
firecrawl agent "find the head of sales at <company>" --toolkits apollo,crunchbase --wait --json -o .firecrawl/contacts.json

With --require-approval (needs --mode chat), a run can end on a pendingApproval instead of making a paid call. Ask the user, then answer it on the same thread with firecrawl agent "<follow-up prompt>" --thread <threadId> --mode chat --approve <approvalId> (or --decline <approvalId>). A terms approval only continues once the provider's terms are accepted for the organization, either in the dashboard or by showing the user firecrawl alexandria terms show <provider> and, only after they explicitly agree, running firecrawl alexandria terms accept <provider> --terms-version <version> --digest <digest> --confirm with the version and digest it returned. Approving does not accept them.

Job IDs

Omitting --wait returns a job ID. A UUID positional argument is auto-detected as a status check:

bash
# Check once (equivalent to adding --status)
firecrawl agent "<job-id>"

# Wait on an existing job, polling every 10 seconds for up to 5 minutes
firecrawl agent "<job-id>" --wait --poll-interval 10 --timeout 300

# Cancel an active job
firecrawl agent "<job-id>" --cancel
Show full SKILL.md (208 more words)Show less

Tips

  • Use --wait for inline results; omit it only when you want a job ID to poll later (see Job IDs).
  • Use --schema for predictable, structured output — otherwise the agent returns freeform data.
  • Agent runs consume more credits than simple scrapes. Use --max-credits to cap spending.
  • For simple single-page extraction, prefer scrape — it's faster and cheaper.

See also

Alexandria session feedback

To report an Alexandria session outcome or a provider/capability gap, use firecrawl alexandria feedback --rating good|partial|bad --url <website> --requested-functionality '<what was needed>' --objective '<the underlying goal of the task>' --rationale '<what happened>' --json. Use observed results in the rationale. No job ID is needed; send it within 20 minutes of your last Alexandria search, discovery, or execution, or it is rejected. Each submission refunds 1 credit, up to 10 per website and 100 per team each UTC day. Optional --provider-feedback and --capability-feedback JSON arrays describe specific gaps; inspect firecrawl alexandria feedback --help for their fields. Use the capability issue missing_capability when a provider exists but lacks the needed capability, and new_capability_request (with requestedFunctionality) to ask for one.

© firecrawl, ISC. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/core/firecrawl-agent of firecrawl/skills.

Open the folder on GitHubat commit d0ffd7c

Compare with similar skills

Firecrawl Agent next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Firecrawl Agent compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Firecrawl Agent this skillfirecrawl/skills115—~1.2kAutomated safety check: PassISC
SEO Firecrawlseranking/seo-skills160—~2.3kAutomated safety check: PassMIT
Web Scrapersandbaseai/sandbase-skills201—~746Automated safety check: PassApache-2.0
Axyusukebe/ax7191 repos~918Automated safety check: PassMIT
Meowhub Browserzhaojiaqi/MeowHub111—~1.6kAutomated safety check: PassGPL-3.0
Chatgpt SearchSeifBenayed/cloclo114—~1.7kAutomated safety check: NotesMIT

Similar skills

  • SEO Firecrawl

    seranking/seo-skills

    Ad-hoc web scraping, site mapping, and full-site crawling via Firecrawl MCP.

    160 GitHub stars~2.3k tokensUpdated 3 mo ago
    Data & AnalyticsAuto-check passed
  • Web Scraper

    sandbaseai/sandbase-skills

    Scrape web pages, crawl sites, extract structured data, and capture screenshots through SandBase.

    201 GitHub stars~746 tokensUpdated 11 days ago
    Data & AnalyticsAuto-check passed
  • Ax

    yusukebe/ax

    Use the ax CLI instead of curl + throwaway parsing scripts whenever you fetch a URL, explore an unknown web page, or extract structured data from HTML.

    719 GitHub starsUsed in 1 repo~918 tokens
    Data & AnalyticsAuto-check passed
  • Meowhub Browser

    zhaojiaqi/MeowHub

    Browse the web using Browserless.io cloud browser service. An agent skill from zhaojiaqi/MeowHub.

    111 GitHub stars~1.6k tokensUpdated 4 mo ago
    Data & AnalyticsAuto-check passed
  • Chatgpt Search

    SeifBenayed/cloclo

    Search ChatGPT and extract the full response + hydration JSON that powers the UI.

    114 GitHub stars~1.7k tokensUpdated 6 mo ago
    Data & AnalyticsAuto-check: notes
  • Agent Readiness Audit

    indranilbanerjee/digital-marketing-pro

    Audit whether AI agents and AI crawlers can actually use a site — robots.txt rules per AI crawler token (OpenAI, Anthropic and Perplexity bots, Google-Extended, Applebot-Extended)…

    854 GitHub starsUsed in 1 repo~3.9k tokens
    Data & AnalyticsAuto-check passed

More from firecrawl/skills

All 29 skills in this repo
  • Firecrawl Scrape

    firecrawl/skills

    Read a known webpage or execute a discovered workflow or data-provider capability.

    115 GitHub stars~1.8k tokensUpdated today
    Auto-check passed
  • Extract structured company lists from directories with Firecrawl.

    115 GitHub stars~557 tokensUpdated today
    Auto-check passed
  • Monitor competitor pricing, features, changelogs, dashboards, and product changes with Firecrawl.

    115 GitHub stars~604 tokensUpdated today
    Auto-check passed
  • Firecrawl Crawl

    firecrawl/skills

    Bulk-extract many pages from one site or section. An agent skill from firecrawl/skills.

    115 GitHub stars~467 tokensUpdated today
    Auto-check passed
  • Pull metrics from analytics dashboards and internal web tools with Firecrawl browser.

    115 GitHub stars~590 tokensUpdated today
    Auto-check passed
  • Firecrawl Deep Research

    firecrawl/skills

    Produce an intensive, cited analytical report: executive summary, multi-angle findings, contrarian views, open questions, and full sources.

    115 GitHub stars~1.4k tokensUpdated today
    Auto-check passed

Works with

Questions about Firecrawl Agent

What does Firecrawl Agent do?

Autonomously navigate websites and extract structured data across pages. Firecrawl Agent is an agent skill from firecrawl/skills. Autonomously navigate websites and extract structured data across pages.

When should I use Firecrawl Agent?

Firecrawl Agent fits situations like: the task requires navigation; no suitable ready-made workflow; data provider covers it.

How do I install Firecrawl Agent in Claude Code?

Run `npx skills add firecrawl/skills --skill firecrawl-agent -a claude-code`. Or copy the skill folder (skills/core/firecrawl-agent in firecrawl/skills) into .claude/skills/firecrawl-agent in your project. Claude Code loads it when a task matches its description.

How do I install Firecrawl Agent in Codex?

Run `npx skills add firecrawl/skills --skill firecrawl-agent -a codex`. Or copy the skill folder (skills/core/firecrawl-agent in firecrawl/skills) into .agents/skills/firecrawl-agent in your project. Codex loads it when a task matches its description.

Can I use Firecrawl Agent in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add firecrawl/skills --skill firecrawl-agent -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/firecrawl-agent, .gemini/skills/firecrawl-agent, .github/skills/firecrawl-agent and .opencode/skills/firecrawl-agent in your project.

What does Firecrawl Agent need to run?

SKILL.md names no scripts, command-line tools or credentials: Firecrawl Agent is instructions for the agent only. Our summary lists: Node.js. Its frontmatter pre-approves these tools: Bash(firecrawl *), Bash(npx firecrawl-cli *).

Does Firecrawl Agent access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Firecrawl Agent safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Firecrawl Agent use?

Firecrawl Agent is published under the ISC licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Firecrawl Agent use?

About 1.2k tokens (SKILL.md is roughly 4.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Firecrawl Agent?

Skills that share tags, products or a category with Firecrawl Agent: SEO Firecrawl (seranking/seo-skills, 160 stars), Web Scraper (sandbaseai/sandbase-skills, 201 stars), Ax (yusukebe/ax, 719 stars) and Meowhub Browser (zhaojiaqi/MeowHub, 111 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Firecrawl Agent?

firecrawl (a GitHub organization) maintains it in firecrawl/skills, which has 115 GitHub stars. The repository holds 29 skills in this directory. The repository was last updated on October 6, 2026.

Source: firecrawl/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.