{
  "schemaVersion": "1.0",
  "item": {
    "slug": "hybrid-deep-search",
    "name": "Hybrid Deep Search",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/scsun1978/hybrid-deep-search",
    "canonicalUrl": "https://clawhub.ai/scsun1978/hybrid-deep-search",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/hybrid-deep-search",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=hybrid-deep-search",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "SKILL_CN.md",
      "_meta.json",
      "scripts/deep_search.py",
      "scripts/router.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. 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-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-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/hybrid-deep-search"
    },
    "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/hybrid-deep-search",
    "agentPageUrl": "https://openagent3.xyz/skills/hybrid-deep-search/agent",
    "manifestUrl": "https://openagent3.xyz/skills/hybrid-deep-search/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/hybrid-deep-search/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": "Hybrid Deep Search 🚀",
        "body": "Intelligent three-tier search system that automatically routes queries between Brave API and OpenAI Codex for optimal cost and quality."
      },
      {
        "title": "Architecture",
        "body": "User Query\n   ↓\nQuery Analyzer (router.py)\n   ↓\n   ├─→ Simple Questions → Brave API (web_search)     Fast, Free\n   ├─→ Complex Questions → OpenAI Codex (gpt-5-codex)  Deep Analysis, Paid\n   └─→ Manual Mode → User Specified"
      },
      {
        "title": "1. Install Dependencies",
        "body": "pip install openai python-dotenv requests"
      },
      {
        "title": "2. Configure API Keys",
        "body": "Brave API (Already Built-in)\n\nNo extra configuration needed. Uses OpenClaw's built-in web_search tool.\n\nOpenAI Codex API (Optional for Deep Search)\n\n# Get API Key from: https://platform.openai.com/api-keys\n\nexport OPENAI_API_KEY=\"sk-your-openai-api-key\"\nexport OPENAI_BASE_URL=\"https://api.openai.com/v1\"  # Optional"
      },
      {
        "title": "Auto Mode (Recommended)",
        "body": "python3 scripts/deep_search.py \"your query\"\n# System automatically analyzes complexity and chooses:\n# - Simple questions → Brave API\n# - Complex questions → OpenAI Codex"
      },
      {
        "title": "Manual Mode",
        "body": "# Quick Search (Brave API)\npython3 scripts/deep_search.py \"what is OpenClaw?\" --mode quick\n\n# Deep Search (OpenAI Codex)\npython3 scripts/deep_search.py \"compare LangChain vs LlamaIndex\" --mode codex"
      },
      {
        "title": "Focus Modes",
        "body": "# Academic Search\npython3 scripts/deep_search.py \"AI agent frameworks research\" --mode codex --focus academic\n\n# News Search\npython3 scripts/deep_search.py \"latest AI news\" --mode quick --focus news\n\n# General Web Search\npython3 scripts/deep_search.py \"OpenClaw documentation\" --mode quick --focus web"
      },
      {
        "title": "Parameters",
        "body": "ParameterDescriptionOptionsDefaultquerySearch queryAny text---modeSearch modequick, codex, autoauto--focusSearch focusweb, academic, news, youtubeweb--max-resultsMax results1-2010--verboseVerbose output-false"
      },
      {
        "title": "Complexity Routing Rules",
        "body": "Auto mode routes based on query analysis:"
      },
      {
        "title": "→ Brave API (quick)",
        "body": "Simple factual queries (what/who/when/where)\nDefinition lookups\nQuick fact-finding\nSingle-topic searches\n\nExamples:\n\n\"what is OpenClaw?\"\n\"who created Python?\"\n\"latest AI news today\""
      },
      {
        "title": "→ OpenAI Codex (codex)",
        "body": "Comparison analysis\nDeep reasoning\nMulti-source synthesis\nComplex questions\nRequires inference/summarization\n\nExamples:\n\n\"compare LangChain vs LlamaIndex in detail\"\n\"analyze impact of AI on job market\"\n\"explain quantum computing applications in healthcare\""
      },
      {
        "title": "Brave API",
        "body": "✅ Completely free\n⚡ Fast response (<2s)\n📊 Controllable result count"
      },
      {
        "title": "OpenAI Codex (gpt-5-codex)",
        "body": "💰 Usage-based pricing\n🧠 Deep reasoning capabilities\n⏱️ Slower response (5-30s)\n💡 Free tier available for new users\n\nRecommendation: Use auto mode to let the system optimize costs for you."
      },
      {
        "title": "Query Analyzer (router.py)",
        "body": "Analyzes query complexity using NLP rules:\n\nKeyword detection (compare/analyze/explain...)\nSentence length\nComplexity scoring\nAutomatic routing decisions"
      },
      {
        "title": "Brave API Integration",
        "body": "Uses OpenClaw's built-in web_search tool:\n\nCalled via Bash tool\nHandles requests automatically\nNo extra authentication needed"
      },
      {
        "title": "OpenAI Codex Integration",
        "body": "Uses gpt-5-codex model\nBuilt-in web search tool\nOpenAI Chat Completions API format"
      },
      {
        "title": "Case 1: Quick Fact Lookup",
        "body": "python3 scripts/deep_search.py \"OpenClaw version 2026\"\n# → Auto-uses Brave API\n# → Result: Fast return, free"
      },
      {
        "title": "Case 2: Deep Analysis",
        "body": "python3 scripts/deep_search.py \"comprehensive analysis of AI agent architectures\"\n# → Auto-uses OpenAI Codex\n# → Result: Deep analysis, multi-source synthesis"
      },
      {
        "title": "Case 3: Academic Research",
        "body": "python3 scripts/deep_search.py \"recent papers on multi-agent systems\" --mode codex --focus academic\n# → Uses OpenAI Codex\n# → Result: Focused on academic literature"
      },
      {
        "title": "Batch Search",
        "body": "# Create queries.txt\necho \"query 1\" >> queries.txt\necho \"query 2\" >> queries.txt\n\n# Batch execute\nfor query in $(cat queries.txt); do\n  python3 scripts/deep_search.py \"$query\" --mode auto\ndone"
      },
      {
        "title": "Format Output",
        "body": "# JSON output\npython3 scripts/deep_search.py \"query\" --format json\n\n# Markdown output (default)\npython3 scripts/deep_search.py \"query\" --format markdown\n\n# Plain text output\npython3 scripts/deep_search.py \"query\" --format text"
      },
      {
        "title": "Brave API Not Responding",
        "body": "# Check OpenClaw web_search tool\n# No extra configuration needed"
      },
      {
        "title": "OpenAI Codex Authentication Failed",
        "body": "# Check environment variable\necho $OPENAI_API_KEY\n\n# Reset\nexport OPENAI_API_KEY=\"sk-...\""
      },
      {
        "title": "Python Dependencies",
        "body": "pip install --upgrade openai python-dotenv requests"
      },
      {
        "title": "Scoring Factors (0-10 total)",
        "body": "Keyword Matching (+6)\n\ncompare/analyze/explain/why/how...\n\n\n\nQuery Length (+2)\n\n\n\n15 words = +2\n\n\n\n\n8 words = +1\n\n\n\n\n\nQuestion Pattern (+1)\n\nComplex wh-questions\n\n\n\nTechnical Terms (+1)\n\nAPI/framework/architecture...\n\n\n\nSimple Keyword Penalty (-2)\n\nwhat is/who is/list of..."
      },
      {
        "title": "Decision Thresholds",
        "body": "0-2 score: Brave API (quick)\n3+ score: OpenAI Codex (codex)"
      },
      {
        "title": "Config File",
        "body": "cp config.json.example config.json\n# Edit config.json with your settings\n\nExample config.json:\n\n{\n  \"search_settings\": {\n    \"default_mode\": \"auto\",\n    \"default_focus\": \"web\",\n    \"max_results\": 10,\n    \"router_threshold\": 3,\n    \"verbose\": false\n  },\n\n  \"openai_codex\": {\n    \"enabled\": true,\n    \"api_key\": \"YOUR_OPENAI_API_KEY_HERE\",\n    \"base_url\": \"https://api.openai.com/v1\",\n    \"model\": \"gpt-5-codex\",\n    \"max_tokens\": 4096,\n    \"temperature\": 0.7\n  }\n}"
      },
      {
        "title": "Credits",
        "body": "Built by Office_bot\nPowered by OpenClaw"
      },
      {
        "title": "References",
        "body": "Brave Search API\nOpenAI GPT-5-Codex\nOpenAI API Docs"
      }
    ],
    "body": "Hybrid Deep Search 🚀\n\nIntelligent three-tier search system that automatically routes queries between Brave API and OpenAI Codex for optimal cost and quality.\n\nArchitecture\nUser Query\n   ↓\nQuery Analyzer (router.py)\n   ↓\n   ├─→ Simple Questions → Brave API (web_search)     Fast, Free\n   ├─→ Complex Questions → OpenAI Codex (gpt-5-codex)  Deep Analysis, Paid\n   └─→ Manual Mode → User Specified\n\nQuick Start\n1. Install Dependencies\npip install openai python-dotenv requests\n\n2. Configure API Keys\nBrave API (Already Built-in)\n\nNo extra configuration needed. Uses OpenClaw's built-in web_search tool.\n\nOpenAI Codex API (Optional for Deep Search)\n# Get API Key from: https://platform.openai.com/api-keys\n\nexport OPENAI_API_KEY=\"sk-your-openai-api-key\"\nexport OPENAI_BASE_URL=\"https://api.openai.com/v1\"  # Optional\n\nUsage\nAuto Mode (Recommended)\npython3 scripts/deep_search.py \"your query\"\n# System automatically analyzes complexity and chooses:\n# - Simple questions → Brave API\n# - Complex questions → OpenAI Codex\n\nManual Mode\n# Quick Search (Brave API)\npython3 scripts/deep_search.py \"what is OpenClaw?\" --mode quick\n\n# Deep Search (OpenAI Codex)\npython3 scripts/deep_search.py \"compare LangChain vs LlamaIndex\" --mode codex\n\nFocus Modes\n# Academic Search\npython3 scripts/deep_search.py \"AI agent frameworks research\" --mode codex --focus academic\n\n# News Search\npython3 scripts/deep_search.py \"latest AI news\" --mode quick --focus news\n\n# General Web Search\npython3 scripts/deep_search.py \"OpenClaw documentation\" --mode quick --focus web\n\nParameters\nParameter\tDescription\tOptions\tDefault\nquery\tSearch query\tAny text\t-\n--mode\tSearch mode\tquick, codex, auto\tauto\n--focus\tSearch focus\tweb, academic, news, youtube\tweb\n--max-results\tMax results\t1-20\t10\n--verbose\tVerbose output\t-\tfalse\nComplexity Routing Rules\n\nAuto mode routes based on query analysis:\n\n→ Brave API (quick)\nSimple factual queries (what/who/when/where)\nDefinition lookups\nQuick fact-finding\nSingle-topic searches\n\nExamples:\n\n\"what is OpenClaw?\"\n\"who created Python?\"\n\"latest AI news today\"\n→ OpenAI Codex (codex)\nComparison analysis\nDeep reasoning\nMulti-source synthesis\nComplex questions\nRequires inference/summarization\n\nExamples:\n\n\"compare LangChain vs LlamaIndex in detail\"\n\"analyze impact of AI on job market\"\n\"explain quantum computing applications in healthcare\"\nCost Optimization\nBrave API\n✅ Completely free\n⚡ Fast response (<2s)\n📊 Controllable result count\nOpenAI Codex (gpt-5-codex)\n💰 Usage-based pricing\n🧠 Deep reasoning capabilities\n⏱️ Slower response (5-30s)\n💡 Free tier available for new users\n\nRecommendation: Use auto mode to let the system optimize costs for you.\n\nTechnical Details\nQuery Analyzer (router.py)\n\nAnalyzes query complexity using NLP rules:\n\nKeyword detection (compare/analyze/explain...)\nSentence length\nComplexity scoring\nAutomatic routing decisions\nBrave API Integration\n\nUses OpenClaw's built-in web_search tool:\n\nCalled via Bash tool\nHandles requests automatically\nNo extra authentication needed\nOpenAI Codex Integration\nUses gpt-5-codex model\nBuilt-in web search tool\nOpenAI Chat Completions API format\nExample Use Cases\nCase 1: Quick Fact Lookup\npython3 scripts/deep_search.py \"OpenClaw version 2026\"\n# → Auto-uses Brave API\n# → Result: Fast return, free\n\nCase 2: Deep Analysis\npython3 scripts/deep_search.py \"comprehensive analysis of AI agent architectures\"\n# → Auto-uses OpenAI Codex\n# → Result: Deep analysis, multi-source synthesis\n\nCase 3: Academic Research\npython3 scripts/deep_search.py \"recent papers on multi-agent systems\" --mode codex --focus academic\n# → Uses OpenAI Codex\n# → Result: Focused on academic literature\n\nAdvanced Usage\nBatch Search\n# Create queries.txt\necho \"query 1\" >> queries.txt\necho \"query 2\" >> queries.txt\n\n# Batch execute\nfor query in $(cat queries.txt); do\n  python3 scripts/deep_search.py \"$query\" --mode auto\ndone\n\nFormat Output\n# JSON output\npython3 scripts/deep_search.py \"query\" --format json\n\n# Markdown output (default)\npython3 scripts/deep_search.py \"query\" --format markdown\n\n# Plain text output\npython3 scripts/deep_search.py \"query\" --format text\n\nTroubleshooting\nBrave API Not Responding\n# Check OpenClaw web_search tool\n# No extra configuration needed\n\nOpenAI Codex Authentication Failed\n# Check environment variable\necho $OPENAI_API_KEY\n\n# Reset\nexport OPENAI_API_KEY=\"sk-...\"\n\nPython Dependencies\npip install --upgrade openai python-dotenv requests\n\nComplexity Scoring System\nScoring Factors (0-10 total)\n\nKeyword Matching (+6)\n\ncompare/analyze/explain/why/how...\n\nQuery Length (+2)\n\n15 words = +2\n\n8 words = +1\n\nQuestion Pattern (+1)\n\nComplex wh-questions\n\nTechnical Terms (+1)\n\nAPI/framework/architecture...\n\nSimple Keyword Penalty (-2)\n\nwhat is/who is/list of...\nDecision Thresholds\n0-2 score: Brave API (quick)\n3+ score: OpenAI Codex (codex)\nConfiguration\nConfig File\ncp config.json.example config.json\n# Edit config.json with your settings\n\n\nExample config.json:\n\n{\n  \"search_settings\": {\n    \"default_mode\": \"auto\",\n    \"default_focus\": \"web\",\n    \"max_results\": 10,\n    \"router_threshold\": 3,\n    \"verbose\": false\n  },\n\n  \"openai_codex\": {\n    \"enabled\": true,\n    \"api_key\": \"YOUR_OPENAI_API_KEY_HERE\",\n    \"base_url\": \"https://api.openai.com/v1\",\n    \"model\": \"gpt-5-codex\",\n    \"max_tokens\": 4096,\n    \"temperature\": 0.7\n  }\n}\n\nCredits\nBuilt by Office_bot\nPowered by OpenClaw\nReferences\nBrave Search API\nOpenAI GPT-5-Codex\nOpenAI API Docs"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/scsun1978/hybrid-deep-search",
    "publisherUrl": "https://clawhub.ai/scsun1978/hybrid-deep-search",
    "owner": "scsun1978",
    "version": "1.0.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/hybrid-deep-search",
    "downloadUrl": "https://openagent3.xyz/downloads/hybrid-deep-search",
    "agentUrl": "https://openagent3.xyz/skills/hybrid-deep-search/agent",
    "manifestUrl": "https://openagent3.xyz/skills/hybrid-deep-search/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/hybrid-deep-search/agent.md"
  }
}