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

tavily-search

GitHub

提供网页搜索、内容提取、站点映射及爬取功能,用于获取训练数据之外的实时信息、验证事实或收集来源。

skills/core/tavily-search/SKILL.md tavily-ai/skills

触发场景

需要搜索网络信息 检查当前事实或新闻 查找并阅读URL内容 从网站收集多个页面

安装

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

非标准路径

npx skills add https://github.com/tavily-ai/skills/tree/main/skills/core/tavily-search -g -y

不安装直接使用

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

指定 Agent (Claude Code)

npx skills add tavily-ai/skills --skill tavily-search -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-search",
    "description": "Use this skill whenever a task needs the web: searching for information, checking current facts or news, finding sources, reading a URL, finding a page on a site, or collecting many pages from a site. Use it for anything past your training data or anything the user wants verified online.\n",
    "allowed-tools": "Bash(tvly *)"
}

Tavily search

Use the tavily_search, tavily_extract, tavily_map and tavily_crawl tools if your tool list has them (some clients add a prefix such as mcp__tavily__). Otherwise run tvly <command> --json directly; there's no need to check for it first. If neither works, follow setup.

Parameters are named as in the API (max_results). The CLI spells them as flags (--max-results) with comma-separated lists (--include-domains sec.gov,reuters.com). For exact parameters, read the tool schema, run tvly <command> --help, or see the API reference.

You have You need Use
A question or topic Sources, facts or news Search
URLs Their content Extract
A site, not the exact page The right page's URL Map
A site section Many of its pages Crawl

Search

Use advanced search. Set search_depth to advanced (--depth advanced in the CLI) for every search unless the user needs a fast answer to a simple lookup. It reaches more sources and ranks the passages that match your query.

Write queries for a search engine. Use the names and terms you expect on the page, not the user's whole request. Split a question with several parts into one focused search per part. For a long written report, search each part separately and extract the main sources for each before you write.

Follow your leads. When a result names a likely answer, test it right away: search that name with the other details you know, or extract its page. Keep a lead that fits most details until a source contradicts it; a detail you can't confirm doesn't rule it out. When a search misses, search the details again in their own words before adding names or filters you guessed, and build lists of candidates from results, not memory. When a detail keeps coming back empty, work out what it refers to, such as the role, event or term, and search for that.

Each result's content is already the passages that match your query; print it whole rather than cutting it short.

Batch independent searches. Issue the searches for one step together in one turn, one call each: separate tavily_search calls with MCP tools, or separate Bash calls with the CLI, each holding a single tvly command. MCP calls run in parallel; Bash calls run one after another but still use one turn. Don't add pipes, &, $(...) or other programs to a tvly call, which make the client ask for permission. Put the query in single quotes: tvly search 'Rust 2024 edition release date' --depth advanced --max-results 10 --json.

Ask for 10 results. Set max_results to 10 (--max-results 10). Narrow before you widen. Filters help more than raising max_results further. Use time_range or dates for recent events or a stated period. Use include_domains when the answer lives on an official or named site; it is a hard filter, so search again without it if it doesn't find the page.

Keep large results on disk. When a result is long, such as raw page content or a crawl, save it with -o <file> and read the parts you need with your file-reading tool instead of printing it all. To reuse a file, use the path you wrote; never look for it with a glob over temp folders, which can read another task's files. An MCP result lands straight in your context, so keep those calls small.

Read the results critically. Count independent sources, not results. Treat a generated answer as a summary to check, never as a source.

Extract

Extract returns up to 20 URLs per call as markdown, including pages built with JavaScript.

  • Extract only the few results worth reading. Snippets answer most facts.
  • Extract full pages by default. Pass query (--query) only to isolate one fact on a long page; if the passages come back cut off near what you need, extract again without it.
  • Rerun with extract_depth set to advanced (--extract-depth advanced) when a page is built with JavaScript, the content is in a table, or basic came back empty. Check failed_results every time and say which pages couldn't be read.
  • When you find a direct link to the data itself, such as a CSV or JSON file, download it if you can.

When to stop

  • Stop once two independent sources agree on a fact.
  • Before you answer, close any gap your draft would mark unconfirmed or fill from memory: run one targeted search or reread the saved page.
  • For releases, ownership, official figures and decisions by a named body, confirm on the official domain or repository. A secondary site or a generated answer is not enough.

Hand off the job

When the user wants an in-depth report that needs many sources gathered and weighed, such as an analysis, a comparison across several criteria or an in-depth investigation, use tavily-research instead of your own searches. If it isn't installed, run npx skills add tavily-ai/skills --skill tavily-research and read its SKILL.md first. A single fact or answer to find stays here.

版本历史

  • 00a131a 当前 2026-11-03 02:18

依赖关系

  • suggested tavily-ai/skills

同 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-map/SKILL.md
skills/tavily-research/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
版本
00a131a
Hash
ae2fd716
收录时间
2026-11-03 02:18

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