{
  "schemaVersion": "1.0",
  "item": {
    "slug": "web-search-plus",
    "name": "Web Search Plus",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/robbyczgw-cla/web-search-plus",
    "canonicalUrl": "https://clawhub.ai/robbyczgw-cla/web-search-plus",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/web-search-plus",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=web-search-plus",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "CHANGELOG.md",
      "FAQ.md",
      "README.md",
      "SKILL.md",
      "TROUBLESHOOTING.md",
      "config.example.json"
    ],
    "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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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/web-search-plus"
    },
    "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/web-search-plus",
    "agentPageUrl": "https://openagent3.xyz/skills/web-search-plus/agent",
    "manifestUrl": "https://openagent3.xyz/skills/web-search-plus/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/web-search-plus/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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Web Search Plus",
        "body": "Stop choosing search providers. Let the skill do it for you.\n\nThis skill connects you to 7 search providers (Serper, Tavily, Querit, Exa, Perplexity, You.com, SearXNG) and automatically picks the best one for each query. Shopping question? → Google results. Research question? → Deep research engine. Need a direct answer? → AI-synthesized with citations. Want privacy? → Self-hosted option."
      },
      {
        "title": "✨ What Makes This Different?",
        "body": "Just search — No need to think about which provider to use\nSmart routing — Analyzes your query and picks the best provider automatically\n7 providers, 1 interface — Google results, research engines, neural search, AI answers with citations, RAG-optimized, and privacy-first all in one\nWorks with just 1 key — Start with any single provider, add more later\nFree options available — SearXNG is completely free (self-hosted)"
      },
      {
        "title": "🚀 Quick Start",
        "body": "# Interactive setup (recommended for first run)\npython3 scripts/setup.py\n\n# Or manual: copy config and add your keys\ncp config.example.json config.json\n\nThe wizard explains each provider, collects API keys, and configures defaults."
      },
      {
        "title": "🔑 API Keys",
        "body": "You only need ONE key to get started. Add more providers later for better coverage.\n\nProviderFree TierBest ForSign UpSerper2,500/moShopping, prices, local, newsserper.devTavily1,000/moResearch, explanations, academictavily.comQueritContact sales/free tier variesMultilingual AI search, international updatesquerit.aiExa1,000/mo\"Similar to X\", startups, papersexa.aiPerplexityVia KiloDirect answers with citationskilo.aiYou.comLimitedReal-time info, AI/RAG contextapi.you.comSearXNGFREE ✅Privacy, multi-source, $0 costSelf-hosted\n\nSetting your keys:\n\n# Option A: .env file (recommended)\nexport SERPER_API_KEY=\"your-key\"\nexport TAVILY_API_KEY=\"your-key\"\nexport QUERIT_API_KEY=\"your-key\"\n\n# Option B: config.json\n{ \"serper\": { \"api_key\": \"your-key\" } }"
      },
      {
        "title": "🎯 When to Use Which Provider",
        "body": "I want to...ProviderExample QueryFind product pricesSerper\"iPhone 16 Pro Max price\"Find restaurants/stores nearbySerper\"best pizza near me\"Understand how something worksTavily\"how does HTTPS encryption work\"Do deep researchTavily\"climate change research 2024\"Search across languages / international updatesQuerit\"latest AI policy updates in Germany\"Find companies like XExa\"startups similar to Notion\"Find research papersExa\"transformer architecture papers\"Get a direct answer with sourcesPerplexity\"events in Berlin this weekend\"Know the current status of somethingPerplexity\"what is the status of Ethereum upgrades\"Get real-time infoYou.com\"latest AI regulation news\"Search without being trackedSearXNGanything, privately\n\nPro tip: Just search normally! Auto-routing handles most queries correctly. Override with -p provider when needed."
      },
      {
        "title": "🧠 How Auto-Routing Works",
        "body": "The skill looks at your query and picks the best provider:\n\n\"iPhone 16 price\"              → Serper (shopping keywords)\n\"how does quantum computing work\" → Tavily (research question)\n\"latest AI policy updates in Germany\" → Querit (multilingual + recency)\n\"companies like stripe.com\"    → Exa (URL detected, similarity)\n\"events in Graz this weekend\"  → Perplexity (local + direct answer)\n\"latest news on AI\"            → You.com (real-time intent)\n\"search privately\"             → SearXNG (privacy keywords)\n\nWhat if it picks wrong? Override it: python3 scripts/search.py -p tavily -q \"your query\"\n\nDebug routing: python3 scripts/search.py --explain-routing -q \"your query\""
      },
      {
        "title": "Let Auto-Routing Choose (Recommended)",
        "body": "python3 scripts/search.py -q \"Tesla Model 3 price\"\npython3 scripts/search.py -q \"explain machine learning\"\npython3 scripts/search.py -q \"latest AI policy updates in Germany\"\npython3 scripts/search.py -q \"startups like Figma\""
      },
      {
        "title": "Force a Specific Provider",
        "body": "python3 scripts/search.py -p serper -q \"weather Berlin\"\npython3 scripts/search.py -p tavily -q \"quantum computing\" --depth advanced\npython3 scripts/search.py -p querit -q \"latest AI policy updates in Germany\"\npython3 scripts/search.py -p exa --similar-url \"https://stripe.com\" --category company\npython3 scripts/search.py -p you -q \"breaking tech news\" --include-news\npython3 scripts/search.py -p searxng -q \"linux distros\" --engines \"google,bing\""
      },
      {
        "title": "⚙ Configuration",
        "body": "{\n  \"auto_routing\": {\n    \"enabled\": true,\n    \"fallback_provider\": \"serper\",\n    \"confidence_threshold\": 0.3,\n    \"disabled_providers\": []\n  },\n  \"serper\": {\"country\": \"us\", \"language\": \"en\"},\n  \"tavily\": {\"depth\": \"advanced\"},\n  \"exa\": {\"type\": \"neural\"},\n  \"you\": {\"country\": \"US\", \"include_news\": true},\n  \"searxng\": {\"instance_url\": \"https://your-instance.example.com\"}\n}"
      },
      {
        "title": "📊 Provider Comparison",
        "body": "FeatureSerperTavilyExaPerplexityYou.comSearXNGSpeed⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡Direct Answers✗✗✗✓✓✗✗Citations✗✗✗✓✗✗Factual Accuracy⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐Semantic Understanding⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐Full Page Content✗✓✓✓✓✗Shopping/Local✓✗✗✗✗✓Find Similar Pages✗✗✓✗✗✗RAG-Optimized✗✓✗✗✓✓✗Privacy-First✗✗✗✗✗✓✓API Cost$$$$$$Via Kilo$FREE"
      },
      {
        "title": "Do I need API keys for all providers?",
        "body": "No. You only need keys for providers you want to use. Start with one (Serper recommended), add more later."
      },
      {
        "title": "Which provider should I start with?",
        "body": "Serper — fastest, cheapest, largest free tier (2,500 queries/month), and handles most queries well."
      },
      {
        "title": "What if I run out of free queries?",
        "body": "The skill automatically falls back to your other configured providers. Or switch to SearXNG (unlimited, self-hosted)."
      },
      {
        "title": "How much does this cost?",
        "body": "Free tiers: 2,500 (Serper) + 1,000 (Tavily) + 1,000 (Exa) = 4,500+ free searches/month\nSearXNG: Completely free (just ~$5/mo if you self-host on a VPS)\nPaid plans: Start around $10-50/month depending on provider"
      },
      {
        "title": "Is SearXNG really private?",
        "body": "Yes, if self-hosted. You control the server, no tracking, no profiling. Public instances depend on the operator's policy."
      },
      {
        "title": "How do I set up SearXNG?",
        "body": "# Docker (5 minutes)\ndocker run -d -p 8080:8080 searxng/searxng\n\nThen enable JSON API in settings.yml. See docs.searxng.org."
      },
      {
        "title": "Why did it route my query to the \"wrong\" provider?",
        "body": "Sometimes queries are ambiguous. Use --explain-routing to see why, then override with -p provider if needed."
      },
      {
        "title": "🔄 Automatic Fallback",
        "body": "If one provider fails (rate limit, timeout, error), the skill automatically tries the next provider. You'll see routing.fallback_used: true in the response when this happens."
      },
      {
        "title": "📤 Output Format",
        "body": "{\n  \"provider\": \"serper\",\n  \"query\": \"iPhone 16 price\",\n  \"results\": [{\"title\": \"...\", \"url\": \"...\", \"snippet\": \"...\", \"score\": 0.95}],\n  \"routing\": {\n    \"auto_routed\": true,\n    \"provider\": \"serper\",\n    \"confidence\": 0.78,\n    \"confidence_level\": \"high\"\n  }\n}"
      },
      {
        "title": "⚠ Important Note",
        "body": "Tavily, Serper, and Exa are NOT core OpenClaw providers.\n\n❌ Don't modify ~/.openclaw/openclaw.json for these\n✅ Use this skill's scripts — keys auto-load from .env"
      },
      {
        "title": "🔒 Security",
        "body": "SearXNG SSRF Protection: The SearXNG instance URL is validated with defense-in-depth:\n\nEnforces http/https schemes only\nBlocks cloud metadata endpoints (169.254.169.254, metadata.google.internal)\nResolves hostnames and blocks private/internal IPs (loopback, RFC1918, link-local, reserved)\nOperators who intentionally self-host on private networks can set SEARXNG_ALLOW_PRIVATE=1"
      },
      {
        "title": "📚 More Documentation",
        "body": "FAQ.md — Detailed answers to more questions\nTROUBLESHOOTING.md — Fix common errors\nREADME.md — Full technical reference"
      },
      {
        "title": "🔗 Quick Links",
        "body": "Serper — Google Search API\nTavily — AI Research Search\nExa — Neural Search\nPerplexity — AI-Synthesized Answers (via Kilo Gateway)\nYou.com — RAG/Real-time Search\nSearXNG — Privacy-First Meta-Search"
      }
    ],
    "body": "Web Search Plus\n\nStop choosing search providers. Let the skill do it for you.\n\nThis skill connects you to 7 search providers (Serper, Tavily, Querit, Exa, Perplexity, You.com, SearXNG) and automatically picks the best one for each query. Shopping question? → Google results. Research question? → Deep research engine. Need a direct answer? → AI-synthesized with citations. Want privacy? → Self-hosted option.\n\n✨ What Makes This Different?\nJust search — No need to think about which provider to use\nSmart routing — Analyzes your query and picks the best provider automatically\n7 providers, 1 interface — Google results, research engines, neural search, AI answers with citations, RAG-optimized, and privacy-first all in one\nWorks with just 1 key — Start with any single provider, add more later\nFree options available — SearXNG is completely free (self-hosted)\n🚀 Quick Start\n# Interactive setup (recommended for first run)\npython3 scripts/setup.py\n\n# Or manual: copy config and add your keys\ncp config.example.json config.json\n\n\nThe wizard explains each provider, collects API keys, and configures defaults.\n\n🔑 API Keys\n\nYou only need ONE key to get started. Add more providers later for better coverage.\n\nProvider\tFree Tier\tBest For\tSign Up\nSerper\t2,500/mo\tShopping, prices, local, news\tserper.dev\nTavily\t1,000/mo\tResearch, explanations, academic\ttavily.com\nQuerit\tContact sales/free tier varies\tMultilingual AI search, international updates\tquerit.ai\nExa\t1,000/mo\t\"Similar to X\", startups, papers\texa.ai\nPerplexity\tVia Kilo\tDirect answers with citations\tkilo.ai\nYou.com\tLimited\tReal-time info, AI/RAG context\tapi.you.com\nSearXNG\tFREE ✅\tPrivacy, multi-source, $0 cost\tSelf-hosted\n\nSetting your keys:\n\n# Option A: .env file (recommended)\nexport SERPER_API_KEY=\"your-key\"\nexport TAVILY_API_KEY=\"your-key\"\nexport QUERIT_API_KEY=\"your-key\"\n\n# Option B: config.json\n{ \"serper\": { \"api_key\": \"your-key\" } }\n\n🎯 When to Use Which Provider\nI want to...\tProvider\tExample Query\nFind product prices\tSerper\t\"iPhone 16 Pro Max price\"\nFind restaurants/stores nearby\tSerper\t\"best pizza near me\"\nUnderstand how something works\tTavily\t\"how does HTTPS encryption work\"\nDo deep research\tTavily\t\"climate change research 2024\"\nSearch across languages / international updates\tQuerit\t\"latest AI policy updates in Germany\"\nFind companies like X\tExa\t\"startups similar to Notion\"\nFind research papers\tExa\t\"transformer architecture papers\"\nGet a direct answer with sources\tPerplexity\t\"events in Berlin this weekend\"\nKnow the current status of something\tPerplexity\t\"what is the status of Ethereum upgrades\"\nGet real-time info\tYou.com\t\"latest AI regulation news\"\nSearch without being tracked\tSearXNG\tanything, privately\n\nPro tip: Just search normally! Auto-routing handles most queries correctly. Override with -p provider when needed.\n\n🧠 How Auto-Routing Works\n\nThe skill looks at your query and picks the best provider:\n\n\"iPhone 16 price\"              → Serper (shopping keywords)\n\"how does quantum computing work\" → Tavily (research question)\n\"latest AI policy updates in Germany\" → Querit (multilingual + recency)\n\"companies like stripe.com\"    → Exa (URL detected, similarity)\n\"events in Graz this weekend\"  → Perplexity (local + direct answer)\n\"latest news on AI\"            → You.com (real-time intent)\n\"search privately\"             → SearXNG (privacy keywords)\n\n\nWhat if it picks wrong? Override it: python3 scripts/search.py -p tavily -q \"your query\"\n\nDebug routing: python3 scripts/search.py --explain-routing -q \"your query\"\n\n📖 Usage Examples\nLet Auto-Routing Choose (Recommended)\npython3 scripts/search.py -q \"Tesla Model 3 price\"\npython3 scripts/search.py -q \"explain machine learning\"\npython3 scripts/search.py -q \"latest AI policy updates in Germany\"\npython3 scripts/search.py -q \"startups like Figma\"\n\nForce a Specific Provider\npython3 scripts/search.py -p serper -q \"weather Berlin\"\npython3 scripts/search.py -p tavily -q \"quantum computing\" --depth advanced\npython3 scripts/search.py -p querit -q \"latest AI policy updates in Germany\"\npython3 scripts/search.py -p exa --similar-url \"https://stripe.com\" --category company\npython3 scripts/search.py -p you -q \"breaking tech news\" --include-news\npython3 scripts/search.py -p searxng -q \"linux distros\" --engines \"google,bing\"\n\n⚙ Configuration\n{\n  \"auto_routing\": {\n    \"enabled\": true,\n    \"fallback_provider\": \"serper\",\n    \"confidence_threshold\": 0.3,\n    \"disabled_providers\": []\n  },\n  \"serper\": {\"country\": \"us\", \"language\": \"en\"},\n  \"tavily\": {\"depth\": \"advanced\"},\n  \"exa\": {\"type\": \"neural\"},\n  \"you\": {\"country\": \"US\", \"include_news\": true},\n  \"searxng\": {\"instance_url\": \"https://your-instance.example.com\"}\n}\n\n📊 Provider Comparison\nFeature\tSerper\tTavily\tExa\tPerplexity\tYou.com\tSearXNG\nSpeed\t⚡⚡⚡\t⚡⚡\t⚡⚡\t⚡⚡\t⚡⚡⚡\t⚡⚡\nDirect Answers\t✗\t✗\t✗\t✓✓\t✗\t✗\nCitations\t✗\t✗\t✗\t✓\t✗\t✗\nFactual Accuracy\t⭐⭐⭐\t⭐⭐⭐\t⭐⭐\t⭐⭐⭐\t⭐⭐⭐\t⭐⭐⭐\nSemantic Understanding\t⭐\t⭐⭐\t⭐⭐⭐\t⭐⭐⭐\t⭐⭐\t⭐\nFull Page Content\t✗\t✓\t✓\t✓\t✓\t✗\nShopping/Local\t✓\t✗\t✗\t✗\t✗\t✓\nFind Similar Pages\t✗\t✗\t✓\t✗\t✗\t✗\nRAG-Optimized\t✗\t✓\t✗\t✗\t✓✓\t✗\nPrivacy-First\t✗\t✗\t✗\t✗\t✗\t✓✓\nAPI Cost\t$$\t$$\t$$\tVia Kilo\t$\tFREE\n❓ Common Questions\nDo I need API keys for all providers?\n\nNo. You only need keys for providers you want to use. Start with one (Serper recommended), add more later.\n\nWhich provider should I start with?\n\nSerper — fastest, cheapest, largest free tier (2,500 queries/month), and handles most queries well.\n\nWhat if I run out of free queries?\n\nThe skill automatically falls back to your other configured providers. Or switch to SearXNG (unlimited, self-hosted).\n\nHow much does this cost?\nFree tiers: 2,500 (Serper) + 1,000 (Tavily) + 1,000 (Exa) = 4,500+ free searches/month\nSearXNG: Completely free (just ~$5/mo if you self-host on a VPS)\nPaid plans: Start around $10-50/month depending on provider\nIs SearXNG really private?\n\nYes, if self-hosted. You control the server, no tracking, no profiling. Public instances depend on the operator's policy.\n\nHow do I set up SearXNG?\n# Docker (5 minutes)\ndocker run -d -p 8080:8080 searxng/searxng\n\n\nThen enable JSON API in settings.yml. See docs.searxng.org.\n\nWhy did it route my query to the \"wrong\" provider?\n\nSometimes queries are ambiguous. Use --explain-routing to see why, then override with -p provider if needed.\n\n🔄 Automatic Fallback\n\nIf one provider fails (rate limit, timeout, error), the skill automatically tries the next provider. You'll see routing.fallback_used: true in the response when this happens.\n\n📤 Output Format\n{\n  \"provider\": \"serper\",\n  \"query\": \"iPhone 16 price\",\n  \"results\": [{\"title\": \"...\", \"url\": \"...\", \"snippet\": \"...\", \"score\": 0.95}],\n  \"routing\": {\n    \"auto_routed\": true,\n    \"provider\": \"serper\",\n    \"confidence\": 0.78,\n    \"confidence_level\": \"high\"\n  }\n}\n\n⚠ Important Note\n\nTavily, Serper, and Exa are NOT core OpenClaw providers.\n\n❌ Don't modify ~/.openclaw/openclaw.json for these\n✅ Use this skill's scripts — keys auto-load from .env\n\n🔒 Security\n\nSearXNG SSRF Protection: The SearXNG instance URL is validated with defense-in-depth:\n\nEnforces http/https schemes only\nBlocks cloud metadata endpoints (169.254.169.254, metadata.google.internal)\nResolves hostnames and blocks private/internal IPs (loopback, RFC1918, link-local, reserved)\nOperators who intentionally self-host on private networks can set SEARXNG_ALLOW_PRIVATE=1\n📚 More Documentation\nFAQ.md — Detailed answers to more questions\nTROUBLESHOOTING.md — Fix common errors\nREADME.md — Full technical reference\n🔗 Quick Links\nSerper — Google Search API\nTavily — AI Research Search\nExa — Neural Search\nPerplexity — AI-Synthesized Answers (via Kilo Gateway)\nYou.com — RAG/Real-time Search\nSearXNG — Privacy-First Meta-Search"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/robbyczgw-cla/web-search-plus",
    "publisherUrl": "https://clawhub.ai/robbyczgw-cla/web-search-plus",
    "owner": "robbyczgw-cla",
    "version": "2.9.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/web-search-plus",
    "downloadUrl": "https://openagent3.xyz/downloads/web-search-plus",
    "agentUrl": "https://openagent3.xyz/skills/web-search-plus/agent",
    "manifestUrl": "https://openagent3.xyz/skills/web-search-plus/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/web-search-plus/agent.md"
  }
}