tavily-tools 是一个通过统一 Python CLI 执行的 Tavily AI 网页操作技能，用于在需要联网检索或抓取网页时调用 Tavily 的搜索、提取、爬取和站点映射能力。技能以命令行为入口，所有操作都通过同一个脚本 tavily.py 完成，并以 uv run 方式执行。
【主要能力】\n1. 搜索：使用 search 命令检索网络内容，必须提供 --query 参数。支持通过 --topic 指定主题（如 news），通过 --search-depth 设置搜索深度（如 advanced），通过 --max-results 控制返回结果数量（如 20）。\n2. 提取内容：使用 extract 命令从指定 URL 提取正文内容，必须提供 --urls 参数，可传入单个 URL 或逗号分隔的多个 URL，并可通过 --format 指定输出格式（如 text）。\n3. 爬取网站：使用 crawl 命令爬取站点，必须提供 --url 参数，可通过 --max-depth 控制最大深度（如 3），通过 --max-breadth 控制最大广度（如 50）。\n4. 映射站点结构：使用 map 命令生成站点结构映射，必须提供 --url 参数，可通过 --max-depth 限制深度（如 2），通过 --limit 限制返回数量（如 200）。\n\n【使用方式】\n所有命令均通过 uv run .claude/skills/tavily-tools/scripts/tavily.py 后接子命令及参数执行。示例包括：搜索 "Vite 7 new features"、搜索 "React 19" 且主题为 news、搜索 "Effect-TS" 且搜索深度为 advanced、最大结果数为 20；提取单个或逗号分隔的多个 URL 内容并指定 text 格式；爬取 docs.effect.website 或 nx.dev 并设置深度与广度；映射 nx.dev 或 effect.website 的站点结构并限制深度与数量。\n\n【输出格式】\n命令返回形如 {"status": "success|error", ...} 的 JSON。search 返回 {query, results[], images[], answer}；extract 返回 {urls[], results[], failed[]}；crawl 返回 {base_url, results[], urls_crawled}；map 返回 {base_url, urls[], total_mapped}。\n\n【认证与集成】\nAPI 密钥由 1Password 自动注入，无需手动配置。\n\n【适用场景与限制】\n适用于需要程序化搜索网络、批量提取网页正文、爬取文档站点或快速了解站点结构的场景。资料未提供关于收费、价格、平台支持范围、速率限制、错误处理细节或效果保证的信息，这些内容暂未提供。