用途：为智能体提供实时网页搜索与内容提取，无需浏览器。适合需要最新信息（新闻、文档、价格、事实）、需要带 URL 的引用来源，或需要将某个 URL 正文转为可读 Markdown 的场景。若页面已在上下文中、答案属于静态训练数据，或需要登录/点击等交互，则不应使用本技能（交互场景应改用浏览器类 MCP）。
主要能力：搜索返回摘要式答案与结果列表，支持控制结果数量、搜索深度、主题（general/news）、时间范围、域名包含/排除，以及是否附带原始正文；另可对单个 URL 执行提取，返回去除导航、广告和模板后的 Markdown 正文。输出默认人类可读，也可用 --json 输出机器可读格式。
使用方式：先获取 API 密钥（https://app.tavily.com），然后导出环境变量：export TAVILY_API_KEY="tvly-YOUR_KEY_HERE"，可写入 ~/.zshrc 或 ~/.bashrc 持久化，切勿提交密钥。首次运行会通过 uv 自动安装依赖：command -v uv || curl -LsSf https://astral.sh/uv/install.sh | sh。搜索示例：uv run ~/.claude/skills/lich-skills/skills/tavily-search/scripts/search.py "your query"；常用参数包括 --max-results（默认 5，范围 1–20）、--depth {basic,advanced}、--topic {general,news}、--days N、--raw-content、--include-domains、--exclude-domains、--json。提取示例：uv run .../search.py --extract https://example.com/article。
限制与注意：密钥查找顺序为 --api-key 参数、$TAVILY_API_KEY、$TAVILY_KEY；默认超时 30 秒。常见错误包括未设置密钥、401 未授权（密钥错误、被撤销或超配额）、429 限流、无结果（可放宽查询、改用 advanced 深度或去掉域名过滤）。应避免硬编码密钥、在共享终端命令行传密钥（会泄漏到 shell 历史），以及每次都用 --raw-content 搭配 --max-results 20（消耗大量 token）。免费额度、价格与具体平台支持等细节以官方资料为准，本文暂未提供。