Agent Skills › tavily-ai/skills › tavily-map

tavily-map

GitHub

通过Tavily CLI发现网站URL结构,支持自然语言过滤和路径筛选。适用于快速定位特定页面、列出站点URL或探索网站架构,为内容提取提供目标指引。

skills/tavily-map/SKILL.md tavily-ai/skills

触发场景

用户需要查找大型网站上的特定子页面 用户希望列出所有URL以决定后续提取或爬取策略 用户询问'映射站点'、'查找URL'或'列出所有页面'

安装

npx skills add tavily-ai/skills --skill tavily-map -g -y
更多选项

不安装直接使用

npx skills use tavily-ai/skills@tavily-map

指定 Agent (Claude Code)

npx skills add tavily-ai/skills --skill tavily-map -a claude-code -g -y

安装 repo 全部 skill

npx skills add tavily-ai/skills --all -g -y

预览 repo 内 skill

npx skills add tavily-ai/skills --list

SKILL.md

Frontmatter
{
    "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",
    "allowed-tools": "Bash(tvly *)"
}

tavily map

Discover URLs on a website without extracting content. Faster than crawling.

Before running

Map requires authentication. Run the requested command directly when tvly is already authenticated; do not add a status check to every invocation.

If tvly is missing, follow the tavily-cli setup. If an installed CLI reports an authentication error, use tvly login for authentication only, or tvly init --skip-skills when guided verification is also useful. Browser-based OAuth is preferred when an interactive user can complete it. --no-browser prints the sign-in link instead of opening it, but still waits for a localhost callback. In an unattended agent or CI environment, leave authentication to the user or use a securely provided TAVILY_API_KEY. Do not start a second login immediately after guided setup has completed.

When to use

  • You need to find a specific subpage on a large site
  • You want a list of all URLs before deciding what to extract or crawl
  • Step 3 in the workflow: search → extract → map → crawl → research

Quick start

# Discover all URLs
tvly map "https://docs.example.com" --json

# With natural language filtering
tvly map "https://docs.example.com" --instructions "Find API docs and guides" --json

# Filter by path
tvly map "https://example.com" --select-paths "/blog/.*" --limit 500 --json

# Deep map
tvly map "https://example.com" --max-depth 3 --limit 200 --json

Options

Option Description
--max-depth Levels deep (1-5, default: 1)
--max-breadth Links per page (default: 20)
--limit Max URLs to discover (default: 50)
--instructions Natural language guidance for URL filtering
--select-paths Comma-separated regex patterns to include
--exclude-paths Comma-separated regex patterns to exclude
--select-domains Comma-separated regex for domains to include
--exclude-domains Comma-separated regex for domains to exclude
--allow-external / --no-external Include external links
--timeout Max wait (10-150 seconds)
-o, --output Save the JSON response to a file
--json Structured JSON output

Map + Extract pattern

Use map to find the right page, then extract it. This is often more efficient than crawling an entire site:

# Step 1: Find the authentication docs
tvly map "https://docs.example.com" --instructions "authentication" --json

# Step 2: Extract the specific page you found
tvly extract "https://docs.example.com/api/authentication" --json

Tips

  • Map is URL discovery only — no content extraction. Use extract or crawl for content.
  • Map + extract beats crawl when you only need a few specific pages from a large site.
  • Use --instructions for semantic filtering when path patterns aren't enough.

See also

版本历史

  • 778122e 当前 2026-09-09 08:45

    优化了认证指引,明确交互式 OAuth 流程及无头环境处理;强化了 Agent Skill 工作流规范,对齐引导式 CLI 设置说明。

  • ea5e820 2026-07-25 07:40

同 Skill 集合

skills/tasks/tavily-entity/SKILL.md
skills/tavily-best-practices/SKILL.md
skills/tavily-cli/SKILL.md
skills/tavily-dynamic-search/SKILL.md
skills/tavily-extract/SKILL.md
skills/tavily-research/SKILL.md
skills/core/tavily-search/SKILL.md
skills/tasks/tavily-list/SKILL.md
skills/tasks/tavily-monitor/SKILL.md
skills/tasks/tavily-research/SKILL.md
skills/tavily-crawl/SKILL.md
skills/tavily-search/SKILL.md

元信息

文件数
0
版本
778122e
Hash
ecab5075
收录时间
2026-07-25 07:40

首页 - Wiki
Copyright © 2011-2026 iteam. Current version is 2.156.0. UTC+08:00, 2026-11-18 15:27
浙ICP备14020137号-1