{"skill":{"slug":"liang-tavily-search","displayName":"Tavily Search","summary":"Web search using Tavily's LLM-optimized API. Returns relevant results with content snippets, scores, and metadata.","description":"---\nname: tavily-search\ndescription: Web search using Tavily's LLM-optimized API. Returns relevant results with content snippets, scores, and metadata.\nhomepage: https://tavily.com\nmetadata: {\"openclaw\":{\"emoji\":\"🔍\",\"requires\":{\"bins\":[\"node\"],\"env\":[\"TAVILY_API_KEY\"]},\"primaryEnv\":\"TAVILY_API_KEY\"}}\n---\n\n# Tavily Search\n\nSearch the web and get relevant results optimized for LLM consumption.\n\n## Authentication\n\nGet your API key at https://tavily.com and add to your OpenClaw config:\n\n```json\n{\n  \"skills\": {\n    \"entries\": {\n      \"tavily-search\": {\n        \"enabled\": true,\n        \"apiKey\": \"tvly-YOUR_API_KEY_HERE\"\n      }\n    }\n  }\n}\n```\n\nOr set the environment variable:\n```bash\nexport TAVILY_API_KEY=\"tvly-YOUR_API_KEY_HERE\"\n```\n\n## Quick Start\n\n### Using the Script\n\n```bash\nnode {baseDir}/scripts/search.mjs \"query\"\nnode {baseDir}/scripts/search.mjs \"query\" -n 10\nnode {baseDir}/scripts/search.mjs \"query\" --deep\nnode {baseDir}/scripts/search.mjs \"query\" --topic news\n```\n\n### Examples\n\n```bash\n# Basic search\nnode {baseDir}/scripts/search.mjs \"python async patterns\"\n\n# With more results\nnode {baseDir}/scripts/search.mjs \"React hooks tutorial\" -n 10\n\n# Advanced search\nnode {baseDir}/scripts/search.mjs \"machine learning\" --deep\n\n# News search\nnode {baseDir}/scripts/search.mjs \"AI news\" --topic news\n\n# Domain-filtered search\nnode {baseDir}/scripts/search.mjs \"Python docs\" --include-domains docs.python.org\n```\n\n## Options\n\n| Option | Description | Default |\n|--------|-------------|---------|\n| `-n <count>` | Number of results (1-20) | 10 |\n| `--depth <mode>` | Search depth: `ultra-fast`, `fast`, `basic`, `advanced` | `basic` |\n| `--topic <topic>` | Topic: `general` or `news` | `general` |\n| `--time-range <range>` | Time range: `day`, `week`, `month`, `year` | - |\n| `--include-domains <domains>` | Comma-separated domains to include | - |\n| `--exclude-domains <domains>` | Comma-separated domains to exclude | - |\n| `--raw-content` | Include full page content | false |\n| `--json` | Output raw JSON | false |\n\n## Search Depth\n\n| Depth | Latency | Relevance | Use Case |\n|-------|---------|-----------|----------|\n| `ultra-fast` | Lowest | Lower | Real-time chat, autocomplete |\n| `fast` | Low | Good | Need chunks but latency matters |\n| `basic` | Medium | High | General-purpose, balanced |\n| `advanced` | Higher | Highest | Precision matters, research |\n\n## Tips\n\n- **Keep queries under 400 characters** - Think search query, not prompt\n- **Break complex queries into sub-queries** - Better results than one massive query\n- **Use `--include-domains`** to focus on trusted sources\n- **Use `--time-range`** for recent information\n- **Filter by `score`** (0-1) to get highest relevance results","tags":{"latest":"1.0.1"},"stats":{"comments":0,"downloads":45555,"installsAllTime":316,"installsCurrent":316,"stars":117,"versions":1},"createdAt":1772418920934,"updatedAt":1778491684551},"latestVersion":{"version":"1.0.1","createdAt":1772418920934,"changelog":"- Initial release of Tavily Search skill.\n- Enables web search through Tavily’s API, optimized for LLMs.\n- Supports result snippets, scores, metadata, and domain/topic filtering.\n- Provides flexible search depth options and time range filtering.\n- Authentication via environment variable or config file.\n- Includes command-line usage examples and documentation.","license":null},"metadata":{"setup":[{"key":"TAVILY_API_KEY","required":true}],"os":null,"systems":null},"owner":{"handle":"matthew77","userId":"s173wv4gdgnxtget34hxdg8efd8843ep","displayName":"Liang","image":"https://avatars.githubusercontent.com/u/156555?v=4"},"moderation":null}