web_search

npx skills add axoviq-ai/synthadoc --skill web_search --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

# Web Search Skill Accepts a natural language query, calls the Tavily AI search API, and returns the top matching URLs. Your agent receives those URLs and decides what to do with them — fetch each one, display them, pass them to another skill, etc. ## Setup **1. Install the dependency:** ```bash pip install tavily-python ``` **2. Set your Tavily API key** (free tier: 1,000 searches/month — sign up at https://tavily.com, no credit card required): ```bash # macOS / Linux export TAVILY_API_KEY="tvly-your-key-here" # Windows (Command Prompt) set TAVILY_API_KEY=tvly-your-key-here # Windows (PowerShell) $env:TAVILY_API_KEY = "tvly-your-key-here" ``` **3. Optional — cap the number of results** (default: 20): ```bash export SYNTHADOC_WEB_SEARCH_MAX_RESULTS=10 ``` ## Standalone usage ```python import asyncio from synthadoc.skills.web_search.scripts.main import WebSearchSkill skill = WebSearchSkill() async def main(): result = await skill.extract("search for: transformer architecture papers") urls = result.metadata["child_sources"] # list[str] — top matching URLs query = result.metadata["query"] # "transformer architecture papers" print(f"Found {len(urls)} URLs for '{query}':") for url in ur

pip install tavily-python
macOS / Linux
export TAVILY_API_KEY="tvly-your-key-here"
Windows (Command Prompt)
set TAVILY_API_KEY=tvly-your-key-here
Windows (PowerShell)
export SYNTHADOC_WEB_SEARCH_MAX_RESULTS=10