{"skill":{"slug":"moochmaniac-tavily-search","displayName":"Tavily Web Search","summary":"Real-time web search using Tavily API optimized for AI agents. Use when you need current information, recent news, factual research, competitive analysis, or...","description":"---\nname: tavily-search\ndescription: Real-time web search using Tavily API optimized for AI agents. Use when you need current information, recent news, factual research, competitive analysis, or any data not in your training cutoff. Searches return structured results with URLs, content snippets, relevance scores, and optional AI-generated answers.\n---\n\n# Tavily Search\n\nWeb search powered by Tavily API, optimized for AI agent consumption with structured, relevant results.\n\n## When to Use\n\n- User asks for current/recent information beyond training cutoff\n- Research tasks requiring multiple sources\n- Fact-checking or verification\n- Competitor analysis, market research\n- News and updates on specific topics\n- Finding documentation or resources\n\n## Quick Start\n\nBasic search (5 results):\n```bash\npython3 scripts/search.py \"your query here\"\n```\n\nWith options:\n```bash\n# Fewer results\npython3 scripts/search.py \"AI agents\" --max-results 3\n\n# AI-generated answer\npython3 scripts/search.py \"what is OpenClaw\" --answer\n\n# Advanced search (deeper crawling)\npython3 scripts/search.py \"casino bonuses\" --depth advanced\n\n# Include images\npython3 scripts/search.py \"WordPress themes\" --images\n\n# Raw JSON output\npython3 scripts/search.py \"n8n automation\" --json\n```\n\n## Parameters\n\n- **query** (required): Search query string\n- `--max-results N`: Number of results (1-10, default 5)\n- `--depth`: Search depth\n  - `basic` (default): Fast, good for most queries\n  - `advanced`: Deeper crawling, more comprehensive\n- `--answer`: Include AI-generated answer summary\n- `--images`: Include relevant image URLs\n- `--json`: Output raw JSON instead of formatted text\n\n## Output Structure\n\nFormatted output includes:\n- Query and response time\n- AI-generated answer (if requested)\n- Search results with:\n  - Title and URL\n  - Relevance score (0-1)\n  - Content snippet (truncated to 300 chars)\n- Images (if requested)\n\nJSON output provides full Tavily API response for programmatic use.\n\n## API Key Setup\n\nThe script looks for the Tavily API key in:\n1. `workspace/secrets/tavily_api_key` (OpenClaw workspace)\n2. `secrets/tavily_api_key` (relative to current directory)\n3. `TAVILY_API_KEY` environment variable\n\nCurrent key is stored at: `workspace/secrets/tavily_api_key`\n\n## Examples\n\n**Research task:**\n```bash\npython3 scripts/search.py \"WordPress plugin security best practices 2026\" --max-results 5 --answer\n```\n\n**Quick fact check:**\n```bash\npython3 scripts/search.py \"OpenClaw GitHub repository\" --max-results 3\n```\n\n**Competitive analysis:**\n```bash\npython3 scripts/search.py \"top casino affiliate sites\" --depth advanced --max-results 10\n```\n\n**News monitoring:**\n```bash\npython3 scripts/search.py \"AI agent frameworks January 2026\" --answer\n```\n\n## Tips\n\n- Use specific queries for better results\n- `--answer` is useful for summarization tasks\n- `--depth advanced` for comprehensive research (uses more API credits)\n- Relevance scores help identify best sources\n- `--json` output is useful for parsing and processing results programmatically\n","tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":4498,"installsAllTime":4,"installsCurrent":4,"stars":8,"versions":1},"createdAt":1772852500367,"updatedAt":1778491757870},"latestVersion":{"version":"1.0.0","createdAt":1772852500367,"changelog":"Initial release: Real-time web search via Tavily API with structured results, relevance scores, and AI-generated answers","license":null},"metadata":null,"owner":{"handle":"moochmaniac","userId":"s173w21d6ckhtzphx9dsmcbgyx844p70","displayName":"Patrick","image":"https://avatars.githubusercontent.com/u/102004231?v=4"},"moderation":null}