1---
2name: firecrawl-map
3description: |
4  Discover and list all URLs on a website, with optional search filtering. Use this skill when the user wants to find a specific page on a large site, list all URLs, see the site structure, find where something is on a domain, or says "map the site", "find the URL for", "what pages are on", or "list all pages". Essential when the user knows which site but not which exact page.
5allowed-tools:
6  - Bash(firecrawl *)
7  - Bash(npx firecrawl *)
8---
9 
10# firecrawl map
11 
12Discover URLs on a site. Use `--search` to find a specific page within a large site.
13 
14## When to use
15 
16- You need to find a specific subpage on a large site
17- You want a list of all URLs on a site before scraping or crawling
18- Step 3 in the [workflow escalation pattern](firecrawl-cli): search → scrape → **map** → crawl → interact
19 
20## Quick start
21 
22```bash
23# Find a specific page on a large site
24firecrawl map "<url>" --search "authentication" -o .firecrawl/filtered.txt
25 
26# Get all URLs
27firecrawl map "<url>" --limit 500 --json -o .firecrawl/urls.json
28```
29 
30## Options
31 
32| Option                            | Description                  |
33| --------------------------------- | ---------------------------- |
34| `--limit <n>`                     | Max number of URLs to return |
35| `--search <query>`                | Filter URLs by search query  |
36| `--sitemap <include\|skip\|only>` | Sitemap handling strategy    |
37| `--include-subdomains`            | Include subdomain URLs       |
38| `--json`                          | Output as JSON               |
39| `-o, --output <path>`             | Output file path             |
40 
41## Tips
42 
43- **Map + scrape is a common pattern**: use `map --search` to find the right URL, then `scrape` it.
44- Example: `map https://docs.example.com --search "auth"` → found `/docs/api/authentication` → `scrape` that URL.
45 
46## See also
47 
48- [firecrawl-scrape](../firecrawl-scrape/SKILL.md) — scrape the URLs you discover
49- [firecrawl-crawl](../firecrawl-crawl/SKILL.md) — bulk extract instead of map + scrape
50- [firecrawl-download](../firecrawl-download/SKILL.md) — download entire site (uses map internally)
51