跳到主内容
智客 ZICQ

技能库 智客分类:写作与研究 tavily OpenClaw

Tavily

AI-优化了使用Tavily Search API的网络搜索. 需要全面网络研究,时事搜索,域名特定搜索,或AI生成的回答摘要时使用. Tavily是LLM消费的优化型,具有清洁的结构化结果,答案生成,以及原始内容提取. 最适合研究任务、新闻查询、实况调查和收集权威来源.

1867 安装量 · 36 星标

官方网址:ClawHub

技能介绍

先看中文介绍;官方 description 原文单独保留,不改写 SKILL.md。

做什么

AI - 优化使用 Tavily 搜索 API 的网络搜索

何时用

页:1

代理如何加载

按 Agent Skills 渐进披露:启动时只加载 name 与 description(约 100 token);任务匹配后才读入整份 SKILL.md 正文;scripts/、references/、assets/ 仅在需要时再读。 本文件正文结构:Tavily AI Search、Overview、Architecture、Quick Start、Basic Search、Simple query with AI answer。

文件分析

文件分析:除 SKILL.md 外,正文引用了 scripts/tavily_search.py,属于带资源的技能包,这些文件按需再读。

官方 description(原文)

AI-optimized web search using Tavily Search API. Use when you need comprehensive web research, current events lookup, domain-specific search, or AI-generated answer summaries. Tavily is optimized for LLM consumption with clean structured results, answer generation, and raw content extraction. Best for research tasks, news queries, fact-checking, and gathering authoritative sources.

Tavily AI SearchOverviewArchitectureQuick StartBasic SearchSimple query with AI answerMultiple resultsAdvanced SearchComprehensive research modeNews-focused searchDomain FilteringSearch only trusted domains

来源分类:ClawHub Web Search

SKILL.md 与 Agent 调用

官方规范 ↗
name
tavily
description
AI-optimized web search using Tavily Search API. Use when you need comprehensive web research, current events lookup, domain-specific search, or AI-generated answer summaries. Tavily is optimized for LLM consumption with clean structured results, answer generation, and raw content extraction. Best for research tasks, news queries, fact-checking, and gathering authoritative sources.
  1. 发现技能客户端向 Agent 提供名称与描述目录。
  2. 匹配与调用用户指定或任务匹配后,载入 SKILL.md 指令。
  3. 按需加载按步骤读取参考文档、使用脚本与素材。
指令中引用的文件 · 1
  • scripts/tavily_search.py

以下路径提取自原文;文件是否齐全请以来源仓库中的完整目录为准。

具体调用语法与可用工具以目标 Agent 客户端为准。 查看调用机制说明 ↗

安装这个技能

Skills CLI ↗

先选择目标 Agent 和安装范围,保留技能包的附属文件,安装后检查客户端能否发现该技能。

该技能引用了附属文件,请从来源获取完整目录;仅复制 SKILL.md 可能缺少依赖。

交给 Agent 安装

复制安装指令给支持 Agent Skills 的代理,确认其中的目标目录与客户端匹配。

把 Agent Skill「tavily」安装到我的项目:SKILL.md 原文与官方 description 见 https://zicq.com/zh/skills/skl-3a6c928b85324b30-%E5%A1%94%E7%BB%B4%E5%88%A9.html
请存为 .cursor/skills/tavily/SKILL.md 或 .claude/skills/tavily/SKILL.md,frontmatter 的 name 与 description 保持原样,不要改写。
该技能还带 scripts/、references/、assets/ 等文件,请从 https://clawhub.ai/skills/tavily 取完整目录,不要只建一个 SKILL.md。

当前没有明确的 GitHub 技能包地址,请按来源页面的安装器说明操作。

ClawHub ↗

阅读排版
--- name: tavily description: AI-optimized web search using Tavily Search API. Use when you need comprehensive web research, current events lookup, domain-specific search, or AI-generated answer summaries. Tavily is optimized for LLM consumption with clean structured results, answer generation, and raw content extraction. Best for research tasks, news queries, fact-checking, and gathering authoritative sources. --- # Tavily AI Search ## Overview Tavily is a search engine specifically optimized for Large Language Models and AI applications. Unlike traditional search APIs, Tavily provides AI-ready results with optional answer generation, clean content extraction, and domain filtering capabilities. **Key capabilities:** - AI-generated answer summaries from search results - Clean, structured results optimized for LLM processing - Fast (`basic`) and comprehensive (`advanced`) search modes - Domain filtering (include/exclude specific sources) - News-focused search for current events - Image search with relevant visual content - Raw content extraction for deeper analysis ## Architecture ```mermaid graph TB A[User Query] --> B{Search Mode} B -->|basic| C[Fast Search
1-2s response] B -->|advanced| D[Comprehensive Search
5-10s response] C --> E[Tavily API] D --> E E --> F{Topic Filter} F -->|general| G[Broad Web Search] F -->|news| H[News Sources
Last 7 days] G --> I[Domain Filtering] H --> I I --> J{Include Domains?} J -->|yes| K[Filter to Specific Domains] J -->|no| L{Exclude Domains?} K --> M[Search Results] L -->|yes| N[Remove Unwanted Domains] L -->|no| M N --> M M --> O{Response Options} O --> P[AI Answer
Summary] O --> Q[Structured Results
Title, URL, Content, Score] O --> R[Images
if requested] O --> S[Raw HTML Content
if requested] P --> T[Return to Agent] Q --> T R --> T S --> T style E fill:#4A90E2 style P fill:#7ED321 style Q fill:#7ED321 style R fill:#F5A623 style S fill:#F5A623 ``` ## Quick Start ### Basic Search ```bash # Simple query with AI answer scripts/tavily_search.py "What is quantum computing?" # Multiple results scripts/tavily_search.py "Python best practices" --max-results 10 ``` ### Advanced Search ```bash # Comprehensive research mode scripts/tavily_search.py "Climate change solutions" --depth advanced # News-focused search scripts/tavily_search.py "AI developments 2026" --topic news ``` ### Domain Filtering ```bash # Search only trusted domains scripts/tavily_search.py "Python tutorials" \ --include-domains python.org docs.python.org realpython.com # Exclude low-quality sources scripts/tavily_search.py "How to code" \ --exclude-domains w3schools.com geeksforgeeks.org ``` ### With Images ```bash # Include relevant images scripts/tavily_search.py "Eiffel Tower architecture" --images ``` ## Search Modes ### Basic vs Advanced | Mode | Speed | Coverage | Use Case | |------|-------|----------|----------| | **basic** | 1-2s | Good | Quick facts, simple queries | | **advanced** | 5-10s | Excellent | Research, complex topics, comprehensive analysis | **Decision tree:** 1. Need a quick fact or definition? → Use `basic` 2. Researching a complex topic? → Use `advanced` 3. Need multiple perspectives? → Use `advanced` 4. Time-sensitive query? → Use `basic` ### General vs News | Topic | Time Range | Sources | Use Case | |-------|------------|---------|----------| | **general** | All time | Broad web | Evergreen content, tutorials, documentation | | **news** | Last 7 days | News sites | Current events, recent developments, breaking news | **Decision tree:** 1. Query contains "latest", "recent", "current", "today"? → Use `news` 2. Looking for historical or evergreen content? → Use `general` 3. Need up-to-date information? → Use `news` ## API Key Setup ### Option 1: Clawdbot Config (Recommended) Add to your Clawdbot config: ```json { "skills": { "entries": { "tavily": { "enabled": true, "apiKey": "tvly-YOUR_API_KEY_HERE" } } } } ``` Access in scripts via Clawdbot's config system. ### Option 2: Environment Variable ```bash export TAVILY_API_KEY="tvly-YOUR_API_KEY_HERE" ``` Add to `~/.clawdbot/.env` or your shell profile. ### Getting an API Key 1. Visit https://tavily.com 2. Sign up for an account 3. Navigate to your dashboard 4. Generate an API key (starts with `tvly-`) 5. Note your plan's rate limits and credit allocation ## Common Use Cases ### 1. Research & Fact-Finding ```bash # Comprehensive research with answer scripts/tavily_search.py "Explain quantum entanglement" --depth advanced # Multiple authoritative sources scripts/tavily_search.py "Best practices for REST API design" \ --max-results 10 \ --include-domains github.com microsoft.com google.com ``` ### 2. Current Events ```bash # Latest news scripts/tavily_search.py "AI policy updates" --topic news # Recent developments in a field scripts/tavily_search.py "quantum computing breakthroughs" \ --topic news \ --depth advanced ``` ### 3. Domain-Specific Research ```bash # Academic sources only scripts/tavily_search.py "machine learning algorithms" \ --include-domains arxiv.org scholar.google.com ieee.org # Technical documentation scripts/tavily_search.py "React hooks guide" \ --include-domains react.dev ``` ### 4. Visual Research ```bash # Gather visual references scripts/tavily_search.py "modern web design trends" \ --images \ --max-results 10 ``` ### 5. Content Extraction ```bash # Get raw HTML content for deeper analysis scripts/tavily_search.py "Python async/await" \ --raw-content \ --max-results 5 ``` ## Response Handling ### AI Answer The AI-generated answer provides a concise summary synthesized from search results: ```python { "answer": "Quantum computing is a type of computing that uses quantum-mechanical phenomena..." } ``` **Use when:** - Need a quick summary - Want synthesized information from multiple sources - Looking for a direct answer to a question **Skip when** (`--no-answer`): - Only need source URLs - Want to form your own synthesis - Conserving API credits ### Structured Results Each result includes: - `title`: Page title - `url`: Source URL - `content`: Extracted text snippet - `score`: Relevance score (0-1) - `raw_content`: Full HTML (if `--raw-content` enabled) ### Images When `--images` is enabled, returns URLs of relevant images found during search. ## Best Practices ### 1. Choose the Right Search Depth - Start with `basic` for most queries (faster, cheaper) - Escalate to `advanced` only when: - Initial results are insufficient - Topic is complex or nuanced - Need comprehensive coverage ### 2. Use Domain Filtering Strategically **Include domains for:** - Academic research (`.edu` domains) - Official documentation (official project sites) - Trusted news sources - Known authoritative sources **Exclude domains for:** - Known low-quality content farms - Irrelevant content types (Pinterest for non-visual queries) - Sites with paywalls or access restrictions ### 3. Optimize for Cost - Use `basic` depth as default - Limit `max_results` to what you'll actually use - Disable `include_raw_content` unless needed - Cache results locally for repeated queries ### 4. Handle Errors Gracefully The script provides helpful error messages: ```bash # Missing API key Error: Tavily API key required Setup: Set TAVILY_API_KEY environment variable or pass --api-key # Package not installed Error: tavily-python package not installed To install: pip install tavily-python ``` ## Integration Patterns ### Programmatic Usage ```python from tavily_search import search result = search( query="What is machine learning?", api_key="tvly-...", search_depth="advanced", max_results=10 ) if result.get("success"): print(result["answer"]) for item in result["results"]: print(f"{item['title']}: {item['url']}") ``` ### JSON Output for Parsing ```bash scripts/tavily_search.py "Python tutorials" --json > results.json ``` ### Chaining with Other Tools ```bash # Search and extract content scripts/tavily_search.py "React documentation" --json | \ jq -r '.results[].url' | \ xargs -I {} curl -s {} ``` ## Comparison with Other Search APIs **vs Brave Search:** - ✅ AI answer generation - ✅ Raw content extraction - ✅ Better domain filtering - ❌ Slower than Brave - ❌ Costs credits **vs Perplexity:** - ✅ More control over sources - ✅ Raw content available - ✅ Dedicated news mode - ≈ Similar answer quality - ≈ Similar speed **vs Google Custom Search:** - ✅ LLM-optimized results - ✅ Answer generation - ✅ Simpler API - ❌ Smaller index - ≈ Similar cost structure ## Troubleshooting ### Script Won't Run ```bash # Make executable chmod +x scripts/tavily_search.py # Check Python version (requires 3.6+) python3 --version # Install dependencies pip install tavily-python ``` ### API Key Issues ```bash # Verify API key format (should start with tvly-) echo $TAVILY_API_KEY # Test with explicit key scripts/tavily_search.py "test" --api-key "tvly-..." ``` ### Rate Limit Errors - Check your plan's credit allocation at https://tavily.com - Reduce `max_results` to conserve credits - Use `basic` depth instead of `advanced` - Implement local caching for repeated queries ## Resources See [api-reference.md](references/api-reference.md) for: - Complete API parameter documentation - Response format specifications - Error handling details - Cost and rate limit information - Advanced usage examples ## Dependencies - Python 3.6+ - `tavily-python` package (install: `pip install tavily-python`) - Valid Tavily API key ## Credits & Attribution - Tavily API: https://tavily.com - Python SDK: https://github.com/tavily-ai/tavily-python - Documentation: https://docs.tavily.com

相关技能

写作与研究

Humanizer

从文本中删除 AI 生成的写入标记 。 编辑或审查文本时使用,使其声音更自然和人文写作. 基于维基百科的全面"AI写作的标志"指南. 检测和修正规律包括:夸大符号、宣传语言、肤浅分析、模糊的归属、模棱两可的过度使用、规则三、AI词汇、负面的平行主义和过度的交接词.

写作与研究

Prismfy Search

OpenClaw 的默认网络搜索 。 搜索网络跨越了10个引擎——Google,Reddit,GitHub,arXiv,Hacker News等——使用Prismfy. 包括免费等级,不需要信用卡。 包括用于网络搜索、配额检查和引擎/时间/域过滤器的捆绑 " search.sh …

写作与研究

Blogwatcher

监控博客和RSS/Atom的种子.

写作与研究

Deep Research Pro

多来源深度研究代理. 搜索网络,综合调查结果,并提供引用的报告。 不需要 API 密钥 .