Agent skill

Firecrawl

by Prism-Shadow in Prism-Shadow/penguin-harness

Search the web and scrape pages into clean markdown with the Firecrawl API — query-based discovery, single-URL extraction including public PDFs, driven by curl with a vault-stored API key.

Apache-2.0Auto-check passedData & Analytics

Install Firecrawl

skills CLI
$ npx skills add Prism-Shadow/penguin-harness --skill firecrawl -a claude-code

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

GitHub CLI
$ gh skill install Prism-Shadow/penguin-harness firecrawl --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/Prism-Shadow/penguin-harness.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/use-firecrawl/skills/firecrawl .claude/skills/firecrawl && 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
GitHub stars
2.5k
Token cost
~902 tokens
SKILL.md length
392 words
Files
1
Skills in repo
31
Repo updated
First seen
Licence
Apache-2.0

At a glance

Search the web and scrape pages into clean markdown with the Firecrawl API — query-based discovery, single-URL extraction including public PDFs, driven by curl with a vault-stored API key.

  • Tasks that involve Web scraping
  • SKILL.md covers Before you start, Search, Scrape and Workflow and context economy, plus 2 more sections
  • Calls curl, jq and npx; reaches api.firecrawl.dev and docs.firecrawl.dev; needs FIRECRAWL_API_KEY

What it does

Firecrawl is an agent skill from Prism-Shadow/penguin-harness. Search the web and scrape pages into clean markdown with the Firecrawl API — query-based discovery, single-URL extraction including public PDFs, driven by curl with a vault-stored API key.

Its SKILL.md is about 900 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. It works with Firecrawl. The repository describes itself as: 🐧 Unified and Stable RSI Platform. The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Web scraping

Example prompts

  • “/firecrawl”

Requirements

  • Node.js
  • A credential in FIRECRAWL_API_KEY

What it can do on your machine

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

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl
    • jq
    • npx

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • api.firecrawl.dev
    • docs.firecrawl.dev

    Also links to:

    • firecrawl.dev

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

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • FIRECRAWL_API_KEY

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

Context cost

Firecrawl loads about 902 tokens when it runs. Until then it costs about 50 tokens; SKILL.md has 392 words of instructions outside code blocks.

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

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 Prism-Shadow/penguin-harness at commit d56d9ce, republished under its Apache-2.0 licence (© Prism-Shadow). 392 words, ~902 tokens.

Download SKILL.mdSave it as .claude/skills/firecrawl/SKILL.md (or your agent's skills folder).
name
firecrawl
description
Search the web and scrape pages into clean markdown with the Firecrawl API — query-based discovery, single-URL extraction including public PDFs, driven by curl with a vault-stored API key.

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.

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": {"formats": ["markdown"]} returns each result's page content inline — prefer the two-step search → scrape flow instead when only a hit or two matters; content-included search costs far more credits and context.
  • Useful filters: "sources": [{"type": "news"}] (or images), "includeDomains": ["docs.example.com"], "categories": ["github"] (or research / pdf), "tbs" for time-bounded queries.
Show full SKILL.md (169 more words)Show less

Scrape

bash
curl -sS -X POST https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" -H "content-type: application/json" \
  -d '{"url": "<page url>"}' \
  | jq -r '.data.markdown' > <topic>.md
  • Markdown is the default format; the page's main content only (onlyMainContent defaults to true). Metadata sits in .data.metadata (title, sourceURL, statusCode).
  • Public document URLs (PDF, DOCX, …) scrape to markdown the same way.
  • JS-heavy pages that come back empty: retry with "waitFor": 2000.

Workflow and context economy

Search first for discovery, scrape once you have the URL. Never dump full page markdown into your context or reply: pipe it to a file (as above) and read the relevant parts with shell (grep/sed), then cite metadata.sourceURL for every claim you take from a page.

No key available

The keyless free tier only works through official Firecrawl clients and is rate-limited:

bash
npx -y firecrawl-cli@latest search "<query>"
npx -y firecrawl-cli@latest scrape <url> -o page.md

Use it as a stopgap and tell the user to add a real key to the vault — accounts unlock the full API and higher limits.

Errors

  • 401 — missing/invalid key: re-check the vault entry name FIRECRAWL_API_KEY.
  • 402 / 429 — out of credits or rate-limited: report to the user; do not retry-loop.
  • Anything else: https://docs.firecrawl.dev is the source of truth for request/response schemas.

© Prism-Shadow, Apache-2.0. 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 plugins/use-firecrawl/skills/firecrawl of Prism-Shadow/penguin-harness.

Open the folder on GitHubat commit d56d9ce

Compare with similar skills

Firecrawl 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 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Firecrawl this skillPrism-Shadow/penguin-harness2.5k—~902Automated safety check: PassApache-2.0
Firecrawl Scrapefirecrawl/skills116—~1.8kAutomated safety check: PassISC
Firecrawl Agentfirecrawl/skills116—~1.2kAutomated safety check: PassISC
Firecrawl Company Directoriesfirecrawl/skills116—~557Automated safety check: PassISC
Firecrawl Competitive Intelfirecrawl/skills116—~604Automated safety check: PassISC
SEO Firecrawlseranking/seo-skills160—~2.3kAutomated safety check: PassMIT

Similar skills

  • Firecrawl Scrape

    firecrawl/skills

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

    116 GitHub stars~1.8k tokensUpdated yesterday
    Data & AnalyticsAuto-check passed
  • Firecrawl Agent

    firecrawl/skills

    Autonomously navigate websites and extract structured data across pages.

    116 GitHub stars~1.2k tokensUpdated yesterday
    Data & AnalyticsAuto-check passed
  • Extract structured company lists from directories with Firecrawl.

    116 GitHub stars~557 tokensUpdated yesterday
    Data & AnalyticsAuto-check passed
  • Monitor competitor pricing, features, changelogs, dashboards, and product changes with Firecrawl.

    116 GitHub stars~604 tokensUpdated yesterday
    Data & AnalyticsAuto-check passed
  • 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
  • Firecrawl Crawl

    firecrawl/skills

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

    116 GitHub stars~467 tokensUpdated yesterday
    Data & AnalyticsAuto-check passed

More from Prism-Shadow/penguin-harness

All 31 skills in this repo
  • A2ui

    Prism-Shadow/penguin-harness

    Make a reply easier to read and act on with rich blocks inside ordinary Markdown — a choice the user picks from, a form that collects several answers, a procedure as steps with warnings in place, a…

    2.5k GitHub stars~3k tokensUpdated today
    Auto-check passed
  • Penguin Harness Dev

    Prism-Shadow/penguin-harness

    A skill your agent uses when developing PenguinHarness itself — changing packages/{core,server,web,cli,desktop,landing,docs,skills}, the built-in model catalog, the installers or the release…

    2.5k GitHub stars~3.4k tokensUpdated today
    Auto-check passed
  • Bento Slides

    Prism-Shadow/penguin-harness

    Create and edit Bento presentations — self-contained .bento.html decks whose document is JSON.

    2.5k GitHub stars~1.6k tokensUpdated today
    Auto-check passed
  • Penguin Harness Manual Test

    Prism-Shadow/penguin-harness

    A skill your agent uses when standing PenguinHarness up to try a change by hand — launching the Web App, the desktop shell, the landing page, the docs site or the component gallery to click through…

    2.5k GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • Penguin Harness Frontend

    Prism-Shadow/penguin-harness

    A skill your agent uses when changing the PenguinHarness Web App (packages/web) or the shared UI package — adding or restyling any UI, picking a status colour, adding an icon, laying out a row or a…

    2.5k GitHub stars~6.4k tokensUpdated today
    Auto-check passed
  • Browser Automation

    Prism-Shadow/penguin-harness

    Drive the PenguinHarness agent browser — the desktop app's built-in browser or the user's own Chrome — from the shell with penguin browser: open pages, read them as simplified HTML or text, act with…

    2.5k GitHub stars~2.9k tokensUpdated today
    Auto-check: warnings

Works with

Questions about Firecrawl

What does Firecrawl do?

Search the web and scrape pages into clean markdown with the Firecrawl API — query-based discovery, single-URL extraction including public PDFs, driven by curl with a vault-stored API key. Firecrawl is an agent skill from Prism-Shadow/penguin-harness. Search the web and scrape pages into clean markdown with the Firecrawl API — query-based discovery, single-URL extraction including public PDFs, driven by curl with a vault-stored API key.

When should I use Firecrawl?

Firecrawl fits situations like: tasks that involve Web scraping.

How do I install Firecrawl in Claude Code?

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

How do I install Firecrawl in Codex?

Run `npx skills add Prism-Shadow/penguin-harness --skill firecrawl -a codex`. Or copy the skill folder (plugins/use-firecrawl/skills/firecrawl in Prism-Shadow/penguin-harness) into .agents/skills/firecrawl in your project. Codex loads it when a task matches its description.

Can I use Firecrawl 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 Prism-Shadow/penguin-harness --skill firecrawl -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, .gemini/skills/firecrawl, .github/skills/firecrawl and .opencode/skills/firecrawl in your project.

What does Firecrawl need to run?

Going by SKILL.md and its folder, Firecrawl needs the command-line tools its instructions call (curl, jq and npx) and credentials named FIRECRAWL_API_KEY. Our summary lists: Node.js; A credential in FIRECRAWL_API_KEY.

Does Firecrawl access the network?

SKILL.md names 3 domains. In commands or code: api.firecrawl.dev and docs.firecrawl.dev; the agent is likely to contact these when it follows the instructions. As links in the text: firecrawl.dev. This is read from the text; nothing was executed.

Is Firecrawl 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 use?

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

How many tokens does Firecrawl use?

About 902 tokens (SKILL.md is roughly 3.6k 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?

Skills that share tags, products or a category with Firecrawl: Firecrawl Scrape (firecrawl/skills, 116 stars), Firecrawl Agent (firecrawl/skills, 116 stars), Firecrawl Company Directories (firecrawl/skills, 116 stars) and Firecrawl Competitive Intel (firecrawl/skills, 116 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Firecrawl?

Prism-Shadow (a GitHub organization) maintains it in Prism-Shadow/penguin-harness, which has 2,455 GitHub stars. The repository holds 31 skills in this directory. The repository was last updated on October 7, 2026.

Source: Prism-Shadow/penguin-harness on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.