firecrawl-map - SKILL.md Agent Skill

name: firecrawl-map description: Use when discovering URLs on a site through Firecrawl CLI, especially when the site is known but the exact page is unknown, or before scraping/crawling a site section.

Firecrawl Map

Use Firecrawl Map as a CLI-backed web_map provider when ArkSpace needs URL discovery on a known site.

Before Use

Resolve the installed ArkSpace package root before running commands. Replace <installed-arkspace-path> with the directory two levels above this loaded SKILL.md, such as /Users/<user>/.claude/plugins/cache/ark-space/ark-space/0.1.2. Use the installed package path, not a repository-relative command.

Check configuration:

python3 <installed-arkspace-path>/scripts/arkspace.py provider check firecrawl --capability web_map

Set up Firecrawl:

python3 <installed-arkspace-path>/scripts/arkspace.py provider setup firecrawl --wizard

Missing Configuration Recovery

If the provider check reports missing configuration, ask whether to start setup with python3 <installed-arkspace-path>/scripts/arkspace.py provider setup firecrawl --wizard. Do not map with Firecrawl until the provider check succeeds.

Helper Script

Find URLs matching a topic:

python3 <installed-arkspace-path>/scripts/arkspace.py site map --provider firecrawl "https://docs.example.com" \
  --search "authentication" \
  --limit 50 \
  --output json

Routing Notes

Use registry/web-map-providers.yaml before execution.
Use map before scrape when the site is known but the exact URL is unknown.
Use crawl instead when many pages from a section are required.