{"id":5643,"plugin_id":"plugin_asdk_app_69f271663a288191ac98f46bed7cb032","kind":"skill","collection_source":null,"comparison_source":null,"observed_at":"2026-09-30T22:45:44.717Z","digest":"488349a91c1e4cfd402aefcea667fd5fd926dfd00bb80c98c513b89b8fe4b266","against":null,"payload":{"name":"tavily-map","description":"Discover and list all URLs on a website without extracting content, via the Tavily CLI. 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\", \"list all pages\", or \"site structure\". Faster than crawling — returns URLs only. Essential when you know the site but not the exact page. Combine with extract for targeted content retrieval.\n","included_files":[],"skill_md_contents":"---\nname: tavily-map\ndescription: |\n  Discover and list all URLs on a website without extracting content, via the Tavily CLI. 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\", \"list all pages\", or \"site structure\". Faster than crawling — returns URLs only. Essential when you know the site but not the exact page. Combine with extract for targeted content retrieval.\nallowed-tools: Bash(tvly *)\n---\n\n# tavily map\n\nDiscover URLs on a website without extracting content. Faster than crawling.\n\n## Before running\n\nMap requires authentication. Run the requested command directly when `tvly`\nis already authenticated; do not add a status check to every invocation.\n\nIf `tvly` is missing, follow the [tavily-cli setup](../tavily-cli/SKILL.md#setup).\nIf an installed CLI reports an authentication error, use `tvly login` for\nauthentication only, or `tvly init --skip-skills` when guided verification is\nalso useful. Browser-based OAuth is preferred when an interactive user can\ncomplete it. `--no-browser` prints the sign-in link instead of opening it, but\nstill waits for a localhost callback. In an unattended agent or CI environment,\nleave authentication to the user or use a securely provided `TAVILY_API_KEY`.\nDo not start a second login immediately after guided setup has completed.\n\n## When to use\n\n- You need to find a specific subpage on a large site\n- You want a list of all URLs before deciding what to extract or crawl\n- Step 3 in the [workflow](../tavily-cli/SKILL.md): search → extract → **map** → crawl → research\n\n## Quick start\n\n```bash\n# Discover all URLs\ntvly map \"https://docs.example.com\" --json\n\n# With natural language filtering\ntvly map \"https://docs.example.com\" --instructions \"Find API docs and guides\" --json\n\n# Filter by path\ntvly map \"https://example.com\" --select-paths \"/blog/.*\" --limit 500 --json\n\n# Deep map\ntvly map \"https://example.com\" --max-depth 3 --limit 200 --json\n```\n\n## Options\n\n| Option | Description |\n|--------|-------------|\n| `--max-depth` | Levels deep (1-5, default: 1) |\n| `--max-breadth` | Links per page (default: 20) |\n| `--limit` | Max URLs to discover (default: 50) |\n| `--instructions` | Natural language guidance for URL filtering |\n| `--select-paths` | Comma-separated regex patterns to include |\n| `--exclude-paths` | Comma-separated regex patterns to exclude |\n| `--select-domains` | Comma-separated regex for domains to include |\n| `--exclude-domains` | Comma-separated regex for domains to exclude |\n| `--allow-external / --no-external` | Include external links |\n| `--timeout` | Max wait (10-150 seconds) |\n| `-o, --output` | Save the JSON response to a file |\n| `--json` | Structured JSON output |\n\n## Map + Extract pattern\n\nUse `map` to find the right page, then `extract` it. This is often more efficient than crawling an entire site:\n\n```bash\n# Step 1: Find the authentication docs\ntvly map \"https://docs.example.com\" --instructions \"authentication\" --json\n\n# Step 2: Extract the specific page you found\ntvly extract \"https://docs.example.com/api/authentication\" --json\n```\n\n## Tips\n\n- **Map is URL discovery only** — no content extraction. Use `extract` or `crawl` for content.\n- **Map + extract beats crawl** when you only need a few specific pages from a large site.\n- **Use `--instructions`** for semantic filtering when path patterns aren't enough.\n\n## See also\n\n- [tavily-extract](../tavily-extract/SKILL.md) — extract content from URLs you discover\n- [tavily-crawl](../tavily-crawl/SKILL.md) — bulk extract when you need many pages\n"},"changes":[],"summary":"First saved snapshot. No earlier version is available for comparison.","summary_kind":"deterministic","summary_metadata":{}}