{
  "schemaVersion": "1.0",
  "item": {
    "slug": "tavily-search-pro",
    "name": "Tavily Search Pro",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/Shaharsha/tavily-search-pro",
    "canonicalUrl": "https://clawhub.ai/Shaharsha/tavily-search-pro",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/tavily-search-pro",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=tavily-search-pro",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "install.sh",
      "lib/tavily_search.py"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/tavily-search-pro"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/tavily-search-pro",
    "agentPageUrl": "https://openagent3.xyz/skills/tavily-search-pro/agent",
    "manifestUrl": "https://openagent3.xyz/skills/tavily-search-pro/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/tavily-search-pro/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Tavily Search 🔎",
        "body": "AI-powered web search platform with 5 modes: Search, Extract, Crawl, Map, and Research."
      },
      {
        "title": "Requirements",
        "body": "TAVILY_API_KEY environment variable"
      },
      {
        "title": "Configuration",
        "body": "Env VariableDefaultDescriptionTAVILY_API_KEY—Required. Tavily API key\n\nSet in OpenClaw config:\n\n{\n  \"env\": {\n    \"TAVILY_API_KEY\": \"tvly-...\"\n  }\n}"
      },
      {
        "title": "Script Location",
        "body": "python3 skills/tavily/lib/tavily_search.py <command> \"query\" [options]"
      },
      {
        "title": "search — Web Search (Default)",
        "body": "General-purpose web search with optional LLM-synthesized answer.\n\npython3 lib/tavily_search.py search \"query\" [options]\n\nExamples:\n\n# Basic search\npython3 lib/tavily_search.py search \"latest AI news\"\n\n# With LLM answer\npython3 lib/tavily_search.py search \"what is quantum computing\" --answer\n\n# Advanced depth (better results, 2 credits)\npython3 lib/tavily_search.py search \"climate change solutions\" --depth advanced\n\n# Time-filtered\npython3 lib/tavily_search.py search \"OpenAI announcements\" --time week\n\n# Domain filtering\npython3 lib/tavily_search.py search \"machine learning\" --include-domains arxiv.org,nature.com\n\n# Country boost\npython3 lib/tavily_search.py search \"tech startups\" --country US\n\n# With raw content and images\npython3 lib/tavily_search.py search \"solar energy\" --raw --images -n 10\n\n# JSON output\npython3 lib/tavily_search.py search \"bitcoin price\" --json\n\nOutput format (text):\n\nAnswer: <LLM-synthesized answer if --answer>\n\nResults:\n  1. Result Title\n     https://example.com/article\n     Content snippet from the page...\n\n  2. Another Result\n     https://example.com/other\n     Another snippet..."
      },
      {
        "title": "news — News Search",
        "body": "Search optimized for news articles. Sets topic=news.\n\npython3 lib/tavily_search.py news \"query\" [options]\n\nExamples:\n\npython3 lib/tavily_search.py news \"AI regulation\"\npython3 lib/tavily_search.py news \"Israel tech\" --time day --answer\npython3 lib/tavily_search.py news \"stock market\" --time week -n 10"
      },
      {
        "title": "finance — Finance Search",
        "body": "Search optimized for financial data and news. Sets topic=finance.\n\npython3 lib/tavily_search.py finance \"query\" [options]\n\nExamples:\n\npython3 lib/tavily_search.py finance \"NVIDIA stock analysis\"\npython3 lib/tavily_search.py finance \"cryptocurrency market trends\" --time month\npython3 lib/tavily_search.py finance \"S&P 500 forecast 2026\" --answer"
      },
      {
        "title": "extract — Extract Content from URLs",
        "body": "Extract readable content from one or more URLs.\n\npython3 lib/tavily_search.py extract URL [URL...] [options]\n\nParameters:\n\nurls: One or more URLs to extract (positional args)\n--depth basic|advanced: Extraction depth\n--format markdown|text: Output format (default: markdown)\n--query \"text\": Rerank extracted chunks by relevance to query\n\nExamples:\n\n# Extract single URL\npython3 lib/tavily_search.py extract \"https://example.com/article\"\n\n# Extract multiple URLs\npython3 lib/tavily_search.py extract \"https://url1.com\" \"https://url2.com\"\n\n# Advanced extraction with relevance reranking\npython3 lib/tavily_search.py extract \"https://arxiv.org/paper\" --depth advanced --query \"transformer architecture\"\n\n# Text format output\npython3 lib/tavily_search.py extract \"https://example.com\" --format text\n\nOutput format:\n\nURL: https://example.com/article\n─────────────────────────────────\n<Extracted content in markdown/text>\n\nURL: https://another.com/page\n─────────────────────────────────\n<Extracted content>"
      },
      {
        "title": "crawl — Crawl a Website",
        "body": "Crawl a website starting from a root URL, following links.\n\npython3 lib/tavily_search.py crawl URL [options]\n\nParameters:\n\nurl: Root URL to start crawling\n--depth basic|advanced: Crawl depth\n--max-depth N: Maximum link depth to follow (default: 2)\n--max-breadth N: Maximum pages per depth level (default: 10)\n--limit N: Maximum total pages (default: 10)\n--instructions \"text\": Natural language crawl instructions\n--select-paths p1,p2: Only crawl these path patterns\n--exclude-paths p1,p2: Skip these path patterns\n--format markdown|text: Output format\n\nExamples:\n\n# Basic crawl\npython3 lib/tavily_search.py crawl \"https://docs.example.com\"\n\n# Focused crawl with instructions\npython3 lib/tavily_search.py crawl \"https://docs.python.org\" --instructions \"Find all asyncio documentation\" --limit 20\n\n# Crawl specific paths only\npython3 lib/tavily_search.py crawl \"https://example.com\" --select-paths \"/blog,/docs\" --max-depth 3\n\nOutput format:\n\nCrawled 5 pages from https://docs.example.com\n\nPage 1: https://docs.example.com/intro\n─────────────────────────────────\n<Content>\n\nPage 2: https://docs.example.com/guide\n─────────────────────────────────\n<Content>"
      },
      {
        "title": "map — Sitemap Discovery",
        "body": "Discover all URLs on a website (sitemap).\n\npython3 lib/tavily_search.py map URL [options]\n\nParameters:\n\nurl: Root URL to map\n--max-depth N: Depth to follow (default: 2)\n--max-breadth N: Breadth per level (default: 20)\n--limit N: Maximum URLs (default: 50)\n\nExamples:\n\n# Map a site\npython3 lib/tavily_search.py map \"https://example.com\"\n\n# Deep map\npython3 lib/tavily_search.py map \"https://docs.python.org\" --max-depth 3 --limit 100\n\nOutput format:\n\nSitemap for https://example.com (42 URLs found):\n\n  1. https://example.com/\n  2. https://example.com/about\n  3. https://example.com/blog\n  ..."
      },
      {
        "title": "research — Deep Research",
        "body": "Comprehensive AI-powered research on a topic with citations.\n\npython3 lib/tavily_search.py research \"query\" [options]\n\nParameters:\n\nquery: Research question\n--model mini|pro|auto: Research model (default: auto)\n\nmini: Faster, cheaper\npro: More thorough\nauto: Let Tavily decide\n\n\n--json: JSON output (supports structured output schema)\n\nExamples:\n\n# Basic research\npython3 lib/tavily_search.py research \"Impact of AI on healthcare in 2026\"\n\n# Pro model for thorough research\npython3 lib/tavily_search.py research \"Comparison of quantum computing approaches\" --model pro\n\n# JSON output\npython3 lib/tavily_search.py research \"Electric vehicle market analysis\" --json\n\nOutput format:\n\nResearch: Impact of AI on healthcare in 2026\n\n<Comprehensive research report with citations>\n\nSources:\n  [1] https://source1.com\n  [2] https://source2.com\n  ..."
      },
      {
        "title": "Options Reference",
        "body": "OptionApplies ToDescriptionDefault--depth basic|advancedsearch, news, finance, extractSearch/extraction depthbasic--time day|week|month|yearsearch, news, financeTime range filternone-n NUMsearch, news, financeMax results (0-20)5--answersearch, news, financeInclude LLM answeroff--rawsearch, news, financeInclude raw page contentoff--imagessearch, news, financeInclude image URLsoff--include-domains d1,d2search, news, financeOnly these domainsnone--exclude-domains d1,d2search, news, financeExclude these domainsnone--country XXsearch, news, financeBoost country resultsnone--jsonallStructured JSON outputoff--format markdown|textextract, crawlContent formatmarkdown--query \"text\"extractRelevance reranking querynone--model mini|pro|autoresearchResearch modelauto--max-depth Ncrawl, mapMax link depth2--max-breadth Ncrawl, mapMax pages per level10/20--limit Ncrawl, mapMax total pages/URLs10/50--instructions \"text\"crawlNatural language instructionsnone--select-paths p1,p2crawlInclude path patternsnone--exclude-paths p1,p2crawlExclude path patternsnone"
      },
      {
        "title": "Error Handling",
        "body": "Missing API key: Clear error message with setup instructions.\n401 Unauthorized: Invalid API key.\n429 Rate Limit: Rate limit exceeded, try again later.\nNetwork errors: Descriptive error with cause.\nNo results: Clean \"No results found.\" message.\nTimeout: 30-second timeout on all HTTP requests."
      },
      {
        "title": "Credits & Pricing",
        "body": "APIBasicAdvancedSearch1 credit2 creditsExtract1 credit/URL2 credits/URLCrawl1 credit/page2 credits/pageMap1 credit1 creditResearchVaries by model-"
      },
      {
        "title": "Install",
        "body": "bash skills/tavily/install.sh"
      }
    ],
    "body": "Tavily Search 🔎\n\nAI-powered web search platform with 5 modes: Search, Extract, Crawl, Map, and Research.\n\nRequirements\nTAVILY_API_KEY environment variable\nConfiguration\nEnv Variable\tDefault\tDescription\nTAVILY_API_KEY\t—\tRequired. Tavily API key\n\nSet in OpenClaw config:\n\n{\n  \"env\": {\n    \"TAVILY_API_KEY\": \"tvly-...\"\n  }\n}\n\nScript Location\npython3 skills/tavily/lib/tavily_search.py <command> \"query\" [options]\n\nCommands\nsearch — Web Search (Default)\n\nGeneral-purpose web search with optional LLM-synthesized answer.\n\npython3 lib/tavily_search.py search \"query\" [options]\n\n\nExamples:\n\n# Basic search\npython3 lib/tavily_search.py search \"latest AI news\"\n\n# With LLM answer\npython3 lib/tavily_search.py search \"what is quantum computing\" --answer\n\n# Advanced depth (better results, 2 credits)\npython3 lib/tavily_search.py search \"climate change solutions\" --depth advanced\n\n# Time-filtered\npython3 lib/tavily_search.py search \"OpenAI announcements\" --time week\n\n# Domain filtering\npython3 lib/tavily_search.py search \"machine learning\" --include-domains arxiv.org,nature.com\n\n# Country boost\npython3 lib/tavily_search.py search \"tech startups\" --country US\n\n# With raw content and images\npython3 lib/tavily_search.py search \"solar energy\" --raw --images -n 10\n\n# JSON output\npython3 lib/tavily_search.py search \"bitcoin price\" --json\n\n\nOutput format (text):\n\nAnswer: <LLM-synthesized answer if --answer>\n\nResults:\n  1. Result Title\n     https://example.com/article\n     Content snippet from the page...\n\n  2. Another Result\n     https://example.com/other\n     Another snippet...\n\nnews — News Search\n\nSearch optimized for news articles. Sets topic=news.\n\npython3 lib/tavily_search.py news \"query\" [options]\n\n\nExamples:\n\npython3 lib/tavily_search.py news \"AI regulation\"\npython3 lib/tavily_search.py news \"Israel tech\" --time day --answer\npython3 lib/tavily_search.py news \"stock market\" --time week -n 10\n\nfinance — Finance Search\n\nSearch optimized for financial data and news. Sets topic=finance.\n\npython3 lib/tavily_search.py finance \"query\" [options]\n\n\nExamples:\n\npython3 lib/tavily_search.py finance \"NVIDIA stock analysis\"\npython3 lib/tavily_search.py finance \"cryptocurrency market trends\" --time month\npython3 lib/tavily_search.py finance \"S&P 500 forecast 2026\" --answer\n\nextract — Extract Content from URLs\n\nExtract readable content from one or more URLs.\n\npython3 lib/tavily_search.py extract URL [URL...] [options]\n\n\nParameters:\n\nurls: One or more URLs to extract (positional args)\n--depth basic|advanced: Extraction depth\n--format markdown|text: Output format (default: markdown)\n--query \"text\": Rerank extracted chunks by relevance to query\n\nExamples:\n\n# Extract single URL\npython3 lib/tavily_search.py extract \"https://example.com/article\"\n\n# Extract multiple URLs\npython3 lib/tavily_search.py extract \"https://url1.com\" \"https://url2.com\"\n\n# Advanced extraction with relevance reranking\npython3 lib/tavily_search.py extract \"https://arxiv.org/paper\" --depth advanced --query \"transformer architecture\"\n\n# Text format output\npython3 lib/tavily_search.py extract \"https://example.com\" --format text\n\n\nOutput format:\n\nURL: https://example.com/article\n─────────────────────────────────\n<Extracted content in markdown/text>\n\nURL: https://another.com/page\n─────────────────────────────────\n<Extracted content>\n\ncrawl — Crawl a Website\n\nCrawl a website starting from a root URL, following links.\n\npython3 lib/tavily_search.py crawl URL [options]\n\n\nParameters:\n\nurl: Root URL to start crawling\n--depth basic|advanced: Crawl depth\n--max-depth N: Maximum link depth to follow (default: 2)\n--max-breadth N: Maximum pages per depth level (default: 10)\n--limit N: Maximum total pages (default: 10)\n--instructions \"text\": Natural language crawl instructions\n--select-paths p1,p2: Only crawl these path patterns\n--exclude-paths p1,p2: Skip these path patterns\n--format markdown|text: Output format\n\nExamples:\n\n# Basic crawl\npython3 lib/tavily_search.py crawl \"https://docs.example.com\"\n\n# Focused crawl with instructions\npython3 lib/tavily_search.py crawl \"https://docs.python.org\" --instructions \"Find all asyncio documentation\" --limit 20\n\n# Crawl specific paths only\npython3 lib/tavily_search.py crawl \"https://example.com\" --select-paths \"/blog,/docs\" --max-depth 3\n\n\nOutput format:\n\nCrawled 5 pages from https://docs.example.com\n\nPage 1: https://docs.example.com/intro\n─────────────────────────────────\n<Content>\n\nPage 2: https://docs.example.com/guide\n─────────────────────────────────\n<Content>\n\nmap — Sitemap Discovery\n\nDiscover all URLs on a website (sitemap).\n\npython3 lib/tavily_search.py map URL [options]\n\n\nParameters:\n\nurl: Root URL to map\n--max-depth N: Depth to follow (default: 2)\n--max-breadth N: Breadth per level (default: 20)\n--limit N: Maximum URLs (default: 50)\n\nExamples:\n\n# Map a site\npython3 lib/tavily_search.py map \"https://example.com\"\n\n# Deep map\npython3 lib/tavily_search.py map \"https://docs.python.org\" --max-depth 3 --limit 100\n\n\nOutput format:\n\nSitemap for https://example.com (42 URLs found):\n\n  1. https://example.com/\n  2. https://example.com/about\n  3. https://example.com/blog\n  ...\n\nresearch — Deep Research\n\nComprehensive AI-powered research on a topic with citations.\n\npython3 lib/tavily_search.py research \"query\" [options]\n\n\nParameters:\n\nquery: Research question\n--model mini|pro|auto: Research model (default: auto)\nmini: Faster, cheaper\npro: More thorough\nauto: Let Tavily decide\n--json: JSON output (supports structured output schema)\n\nExamples:\n\n# Basic research\npython3 lib/tavily_search.py research \"Impact of AI on healthcare in 2026\"\n\n# Pro model for thorough research\npython3 lib/tavily_search.py research \"Comparison of quantum computing approaches\" --model pro\n\n# JSON output\npython3 lib/tavily_search.py research \"Electric vehicle market analysis\" --json\n\n\nOutput format:\n\nResearch: Impact of AI on healthcare in 2026\n\n<Comprehensive research report with citations>\n\nSources:\n  [1] https://source1.com\n  [2] https://source2.com\n  ...\n\nOptions Reference\nOption\tApplies To\tDescription\tDefault\n--depth basic|advanced\tsearch, news, finance, extract\tSearch/extraction depth\tbasic\n--time day|week|month|year\tsearch, news, finance\tTime range filter\tnone\n-n NUM\tsearch, news, finance\tMax results (0-20)\t5\n--answer\tsearch, news, finance\tInclude LLM answer\toff\n--raw\tsearch, news, finance\tInclude raw page content\toff\n--images\tsearch, news, finance\tInclude image URLs\toff\n--include-domains d1,d2\tsearch, news, finance\tOnly these domains\tnone\n--exclude-domains d1,d2\tsearch, news, finance\tExclude these domains\tnone\n--country XX\tsearch, news, finance\tBoost country results\tnone\n--json\tall\tStructured JSON output\toff\n--format markdown|text\textract, crawl\tContent format\tmarkdown\n--query \"text\"\textract\tRelevance reranking query\tnone\n--model mini|pro|auto\tresearch\tResearch model\tauto\n--max-depth N\tcrawl, map\tMax link depth\t2\n--max-breadth N\tcrawl, map\tMax pages per level\t10/20\n--limit N\tcrawl, map\tMax total pages/URLs\t10/50\n--instructions \"text\"\tcrawl\tNatural language instructions\tnone\n--select-paths p1,p2\tcrawl\tInclude path patterns\tnone\n--exclude-paths p1,p2\tcrawl\tExclude path patterns\tnone\nError Handling\nMissing API key: Clear error message with setup instructions.\n401 Unauthorized: Invalid API key.\n429 Rate Limit: Rate limit exceeded, try again later.\nNetwork errors: Descriptive error with cause.\nNo results: Clean \"No results found.\" message.\nTimeout: 30-second timeout on all HTTP requests.\nCredits & Pricing\nAPI\tBasic\tAdvanced\nSearch\t1 credit\t2 credits\nExtract\t1 credit/URL\t2 credits/URL\nCrawl\t1 credit/page\t2 credits/page\nMap\t1 credit\t1 credit\nResearch\tVaries by model\t-\nInstall\nbash skills/tavily/install.sh"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/Shaharsha/tavily-search-pro",
    "publisherUrl": "https://clawhub.ai/Shaharsha/tavily-search-pro",
    "owner": "Shaharsha",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/tavily-search-pro",
    "downloadUrl": "https://openagent3.xyz/downloads/tavily-search-pro",
    "agentUrl": "https://openagent3.xyz/skills/tavily-search-pro/agent",
    "manifestUrl": "https://openagent3.xyz/skills/tavily-search-pro/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/tavily-search-pro/agent.md"
  }
}