Agent Skills
› firecrawl/cli
› firecrawl-map
firecrawl-map
GitHub发现并列出网站中的所有URL，支持按关键词搜索过滤。适用于探索大型站点结构、定位特定页面或为后续爬取做准备。
Trigger Scenarios
用户希望查找大型网站上的特定页面
用户需要列出网站的所有URL
用户想查看网站结构
用户说'map the site'或'find the URL for'
Install
npx skills add firecrawl/cli --skill firecrawl-map -g -y
SKILL.md
Frontmatter
{
"name": "firecrawl-map",
"description": "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.\n",
"allowed-tools": [
"Bash(firecrawl *)",
"Bash(npx firecrawl-cli *)"
]
}
firecrawl 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.
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 + scrape → crawl → monitor → 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 --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)
Version History
-
253abde
Current 2026-08-19 19:06
修复了跨技能链接404问题，将文件夹重命名为与frontmatter一致；澄清了认证和API行为说明；修正了allowed-tools的npx模式和工作流链接。
- 6c50c5d 2026-07-24 11:49
