firecrawl-map Skill: Find the Right URL on a Large Site

Makes your coding assistant list the URLs on a website, or find one page by keyword, with the Firecrawl command line tool.

Installs: 80.5K; on skills.sh
Stars: 676; on GitHub
Updated: Oct 2026; last repo commit

firecrawl-map teaches your assistant to run firecrawl map <url>. It lists the URLs on a site, and with --search it filters them to find a page such as the authentication docs. A common pattern is map to find the URL, then scrape it.

You must install the Firecrawl CLI and sign in, because map has no keyless free tier.

Good for

Developers hunting for the docs page that covers one topic on a big site
SEO and content teams who want a site's URL structure
Anyone planning a crawl who wants to pick pages first

Install firecrawl-map

Claude Code

Copy this prompt.

Install the firecrawl-map skill in Claude Code. Run this command:

npm install -g firecrawl-cli@latest
firecrawl login --browser
npx skills add https://github.com/firecrawl/cli --skill firecrawl-map -a claude-code

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js, A Firecrawl account (or the keyless free tier).

The skill only gives your assistant instructions. The Firecrawl command line tool does the work, so install it and sign in first. Map needs an account: the skill says there is no keyless free tier, and without credentials the CLI prompts for a login. The one-command route installs the CLI, signs you in through the browser and adds the core and workflow skills for every editor it detects, not just this skill.

From the vendor's docs. Source.

What's in the skill

When it loads

Discover and list a site's URLs, with search filtering. Use for "map the site" or "find the URL for" requests — when the user knows the site but not the exact page, or wants site structure.

Sections in SKILL.md

Quick start
Tips
See also

Key facts

Author: firecrawl org
Repo: firecrawl/cli
Installs on skills.sh: 80,530 as of 2026-11-02
GitHub stars: 676 for the whole firecrawl/cli repo, 2026-11-02
License: ISC (package.json of the CLI repo)
Last commit to the repo: 2026-10-28
What is inside: 1 file (SKILL.md)
Needs: The Firecrawl CLI (npm package firecrawl-cli), Node.js and a Firecrawl account. The SKILL.md says map has no keyless free tier.
Related skills: firecrawl-scrape, firecrawl-crawl, firecrawl-download
skills.sh audits: Gen Agent Trust Hub pass, Socket pass, Snyk warn (2026-11-02)

What it includes

Finds a specific page on a large site
Saves the filtered URLs to a text file under .firecrawl/.
Try: “Map docs.example.com and find the page about authentication.”
Runs code · firecrawl map "<url>" --search "<keyword>"
Lists up to 500 URLs as JSON
For site structure. The full option list covers sitemap handling and subdomains.
Runs code · firecrawl map "<url>" --limit 500 --json
Finds a URL first, then reads that page
The skill's example: map with --search "auth" finds /docs/api/authentication, then scrape reads it.
Runs code · Map then scrape

From the official docs

Permissions

Low risk

This skill sends site URLs to Firecrawl and saves URL lists as files. Treat anything fetched from the web as untrusted text.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

Web pages can try to steer your assistant
The skill's own security note calls fetched web content untrusted and says it may contain prompt injection. Do not let the assistant follow instructions it finds on a page. github.com
Setup installs a global npm package
The CLI is installed with npm install -g. The one-command setup also adds skills to every coding editor it detects, so use the single-skill route if you want only this one. github.com
The CLI sends anonymous usage data
The README says it collects the CLI version, OS, Node.js version and which dev tools it detects during sign-in. Set FIRECRAWL_NO_TELEMETRY=1 to turn it off. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Turning on read-only	No read-only mode. The skill runs CLI commands that spend credits and write files.
Talks to	Firecrawl's API, or your own server if you set --api-url. Web pages the CLI fetches. Page content the assistant reads goes to your AI provider as part of the chat
Sign-in and keys	Browser sign-in stores credentials in the CLI. You can set FIRECRAWL_API_KEY instead.
Scopes	Runs firecrawl commands in your shell (the skill allows Bash(firecrawl ) and Bash(npx firecrawl-cli ))

Questions

What does firecrawl-map do?

It makes your assistant list the URLs on a site with the Firecrawl CLI. With --search it finds one page by keyword on a large site.

How do I install firecrawl-map?

Use the install box at the top of this page. You need the Firecrawl CLI and a sign-in as well as the skill. The one-command route installs the whole core skill set.

Do I need a Firecrawl account?

Yes. The SKILL.md says map needs authentication, has no keyless free tier, and prompts an interactive login without credentials.

Is firecrawl-map safe to use?

It sends the site URL to Firecrawl and saves a URL list under .firecrawl/. The SKILL.md does not state a credit cost for map, so the cost is unknown from this page. Keep --limit modest and review the saved list before scraping.

firecrawl-map or firecrawl-crawl?

Map returns only URLs. The SKILL.md points to firecrawl-crawl when you want the content of many pages, and to firecrawl-scrape for the pages you pick.

Skill or Firecrawl MCP server?

They are two routes to Firecrawl. firecrawl-map is a SKILL.md that tells the assistant to run the Firecrawl CLI in your shell. The skill only allows Bash(firecrawl *) and Bash(npx firecrawl-cli *), so it needs an assistant that can run shell commands. The Firecrawl MCP server and the local Firecrawl MCP server give your client Firecrawl as tools it calls directly, with no skill involved. The README describes firecrawl setup mcp for adding the MCP server to your editors. You can use either route, or both.

Information

updated Nov 2, 2026

Repository: firecrawl/cli
Folder: skills/firecrawl-map

firecrawl/cli skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 5

Firecrawl CLI install rules · github.com
firecrawl/cli README · github.com
skills CLI commands · github.com
firecrawl-map SKILL.md · github.com
Firecrawl security rules · github.com