tavily-map

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

tavily map

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

发现网站上的URL，无需提取内容。比爬虫速度更快。

Prerequisites

前提条件

Requires the Tavily CLI. See tavily-cli for install and auth setup.

Quick install:

curl -fsSL https://cli.tavily.com/install.sh | bash && tvly login

需要安装Tavily CLI。请查看tavily-cli了解安装和身份验证设置。

快速安装命令：

curl -fsSL https://cli.tavily.com/install.sh | bash && tvly login

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

你需要在大型网站上找到特定子页面
你想先获取所有URL列表，再决定要提取或爬取哪些内容
作为工作流的第三步：搜索 → 提取 → 映射 → 爬取 → 调研

Quick start

快速开始

bash

undefined

bash

undefined

Discover all URLs

发现所有URL

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

undefined

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

undefined

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 output to file
`--json`	Structured JSON output

参数	说明
`--max-depth`	遍历深度（1-5，默认值：1）
`--max-breadth`	每页提取的链接数（默认值：20）
`--limit`	最多发现的URL数量（默认值：50）
`--instructions`	用于URL过滤的自然语言指导
`--select-paths`	要包含的路径正则表达式，用逗号分隔
`--exclude-paths`	要排除的路径正则表达式，用逗号分隔
`--select-domains`	要包含的域名正则表达式，用逗号分隔
`--exclude-domains`	要排除的域名正则表达式，用逗号分隔
`--allow-external / --no-external`	是否包含外部链接
`--timeout`	最长等待时间（10-150秒）
`-o, --output`	将结果保存到文件
`--json`	输出结构化JSON格式

Map + Extract pattern

Map + Extract 组合使用模式

Use

map

to find the right page, then

extract

it. This is often more efficient than crawling an entire site:

bash

undefined

先使用

map

找到目标页面，再用

extract

提取内容。这种方式通常比爬取整个网站更高效：

bash

undefined

Step 1: Find the authentication docs

步骤1：找到身份验证相关文档

tvly map "https://docs.example.com" --instructions "authentication" --json

Step 2: Extract the specific page you found

步骤2：提取你找到的特定页面内容

tvly extract "https://docs.example.com/api/authentication" --json

undefined

tvly extract "https://docs.example.com/api/authentication" --json

undefined

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.

Map仅用于URL发现 —— 不提取内容。如需提取内容，请使用
```
extract
```
或
```
crawl
```
功能。
当你只需要从大型网站获取少量特定页面时，Map + Extract的组合比直接爬取更高效。
当路径模式无法满足需求时，使用
```
--instructions
```
进行语义过滤。

tavily-map

Original

Translation

tavily map

tavily map

Prerequisites

前提条件

When to use

使用场景

Quick start

快速开始

Discover all URLs

发现所有URL

With natural language filtering

结合自然语言过滤

Filter by path

按路径过滤

Deep map

深度映射

Options

可选参数

Map + Extract pattern

Map + Extract 组合使用模式

Step 1: Find the authentication docs

步骤1：找到身份验证相关文档

Step 2: Extract the specific page you found

步骤2：提取你找到的特定页面内容

Tips

小贴士

See also

相关链接