About firecrawl-map
firecrawl-map is a Firecrawl CLI skill that discovers URLs on a website and saves the URL list. Search terms can narrow results on large sites, and the discovered URLs can then be scraped or crawled.
Key features
- 01Discover URLs on a site
- 02Search within large sites
- 03Save URL lists as text or JSON
- 04Set a result limit
- 05Support sitemap and subdomain options
Use cases
- 01Find a specific page on a large site
- 02Collect URLs before scraping pages
- 03Prepare a URL list for crawling
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ firecrawl/ firecrawl-claude-plugin --skill firecrawl-mapAfter installing, type/firecrawl-mapin Claude Code to confirm it loaded.
Details
From the project READMEfirecrawl map
Discover URLs on a site. Use --search to find a specific page within a large site.
Prerequisite: map requires authentication (no keyless free tier); without credentials the CLI prompts an interactive login.
Quick start
# Find a specific page on a large site
firecrawl map "<url>" --search "authentication" -o .firecrawl/filtered.txt
# Get all URLs
firecrawl map "<url>" --limit 500 --json -o .firecrawl/urls.json
Run firecrawl map --help for the full option list (sitemap handling, subdomains, etc.).
Done when: the URL list is saved under .firecrawl/ and you have selected the URLs to scrape or crawl next.
Tips
- Map + scrape is a common pattern: use
map --searchto find the right URL, thenscrapeit. - Example:
map https://docs.example.com --search "auth"→ found/docs/api/authentication→scrapethat URL.
See also
- firecrawl-scrape — scrape the URLs you discover
- firecrawl-crawl — bulk extract instead of map + scrape
- firecrawl-download — download entire site (uses map internally)
- firecrawl-build-search — building URL discovery into an app instead of running it here
Comments
Markdown supported