Via the Firecrawl MCP (preferred)
This plugin bundles the Firecrawl MCP server. When it's connected, prefer the native firecrawl_map tool over the CLI — it needs no local install and authenticates through the plugin's one-time browser sign-in. The firecrawl CLI commands below are the fallback for when the MCP isn't connected.
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
firecrawl map "" --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.
## See also
- [firecrawl-scrape](../firecrawl-scrape/SKILL.md) — scrape the URLs you discover
- [firecrawl-crawl](../firecrawl-crawl/SKILL.md) — bulk extract instead of map + scrape
- [firecrawl-download](../firecrawl-download/SKILL.md) — download entire site (uses map internally)