firecrawl-map

by firecrawl

Discover and filter URLs on a website, with optional search to locate specific pages. Supports filtering by search query to find pages matching keywords within large sites Includes sitemap handling strategies (include, skip, or use only) and optional subdomain inclusion Outputs results as plain text or JSON with configurable URL limits Commonly paired with firecrawl-scrape: use map with search to find the target URL, then scrape it

npx skills add https://github.com/firecrawl/cli --skill firecrawl-map

Download ZIP GitHub

586

firecrawl map

Discover URLs on a site. Use --search to find a specific page within a large site.

When to use

You need to find a specific subpage on a large site
You want a list of all URLs on a site before scraping or crawling
Step 3 in the workflow escalation pattern: search → scrape → map → crawl → interact

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

Options

Option	Description
`--limit <n>`	Max number of URLs to return
`--search <query>`	Filter URLs by search query
`--sitemap <include\|skip\|only>`	Sitemap handling strategy
`--include-subdomains`	Include subdomain URLs
`--json`	Output as JSON
`-o, --output <path>`	Output file path

Tips

Map + scrape is a common pattern: use map --search to find the right URL, then scrape it.
Example: map https://docs.example.com --search "auth" → found /docs/api/authentication → scrape that URL.