Map

List every URL on a domain.

marmot map <url> [flags…]

Providers

firecrawl, tavily.

ProviderReturns
FirecrawlURLs with optional title + description
TavilyURLs only

Flags

FlagDescription
--provider <slug>firecrawl or tavily. Falls back to defaults.map.provider.
--api-key <key>Override the env var.
--search <query>Optional relevance ordering query (Firecrawl).
--limit <n>Max URLs returned.
--rawEmit the provider's native response under raw.
--jsonEmit the structured envelope (default).
--no-cacheBypass the response cache for this call. Skip read and skip write.
--refreshSkip cache read but write the fresh response, overwriting any cached entry.
--retries <n>Retry retryable provider errors up to N times with exponential backoff. Default 0, max 10.
--timeout <seconds>Per-attempt request timeout. Default 120.

Cache flags only apply when caching is enabled for this provider via providers.<slug>.cache.enabled. See Caching.

Presets

map-mode presets accept url, search, limit, cache, refresh, output, raw, retries, timeout, session. The positional URL is now optional when the preset supplies it. New negation flags: --cache, --no-refresh, --no-raw. See Presets — Merge rules.

marmot preset create site-map --mode map --provider firecrawl \
  --url https://example.com --limit 200
marmot @site-map                  # uses preset url
marmot @site-map https://other.com   # runtime overrides

Config keys

{ "defaults": { "map": { "provider": "tavily" } } }