{
  "schemaVersion": "1.0",
  "item": {
    "slug": "omnisearch",
    "name": "omnisearch",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/bguidolim/omnisearch",
    "canonicalUrl": "https://clawhub.ai/bguidolim/omnisearch",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/omnisearch",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=omnisearch",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "scripts/omnisearch.sh",
      "SKILL.md"
    ],
    "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/omnisearch"
    },
    "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/omnisearch",
    "agentPageUrl": "https://openagent3.xyz/skills/omnisearch/agent",
    "manifestUrl": "https://openagent3.xyz/skills/omnisearch/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/omnisearch/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": "CRITICAL: When to Use This Skill",
        "body": "ALWAYS use OmniSearch when:\n\nUser explicitly asks to \"search\", \"google\", \"look up\", \"find online\"\nUser asks about current events, news, or recent developments\nUser requests prices, product specs, reviews, or comparisons\nUser asks \"what's the latest...\" or \"what's happening with...\"\nYou need to verify current facts, statistics, or data\nUser asks about people, companies, or organizations you don't know\nInformation might have changed since your training cutoff\nUser needs sources or citations for factual claims\n\nExamples of queries requiring OmniSearch:\n\n\"What's the weather in Hamburg today?\"\n\"Search for iPhone 16 reviews\"\n\"What happened in the tech industry this week?\"\n\"Find the current price of Bitcoin\"\n\"Look up restaurants near me\"\n\"What are people saying about the new Tesla model?\""
      },
      {
        "title": "DO NOT Use OmniSearch When:",
        "body": "Answering from your existing knowledge is sufficient and current\nUser is asking for creative content, code, or analysis\nQuestion is about concepts, definitions, or timeless information"
      },
      {
        "title": "How to Execute Search",
        "body": "IMPORTANT: Run the script from the omnisearch skill directory using the relative path ./scripts/omnisearch.sh"
      },
      {
        "title": "Method 1: Recommended (Wrapper Script)",
        "body": "Use the wrapper script for all searches:\n\n# AI-enhanced search (includes summarization) - USE THIS FOR MOST QUERIES\n./scripts/omnisearch.sh ai \"your search query here\"\n\n# Raw web search results (when you need direct source material)\n./scripts/omnisearch.sh web \"your search query here\"\n\nAvailable providers:\n\nai type: perplexity (default - recommended for most queries)\nweb type: perplexity (default), brave, kagi, tavily, exa\n\nOptional provider override:\n\n./scripts/omnisearch.sh ai \"query\" perplexity\n./scripts/omnisearch.sh web \"query\" brave\n./scripts/omnisearch.sh web \"query\" kagi\n./scripts/omnisearch.sh web \"query\" tavily\n./scripts/omnisearch.sh web \"query\" exa\n\nPractical examples:\n\n# Current weather\n./scripts/omnisearch.sh ai \"weather in Hamburg today\"\n\n# Product research\n./scripts/omnisearch.sh web \"iPhone 16 Pro reviews 2024\"\n\n# News search\n./scripts/omnisearch.sh ai \"latest AI developments this week\"\n\n# Price comparison\n./scripts/omnisearch.sh web \"DJI Mini 4 Pro price Germany\" brave\n\n# Research with premium provider\n./scripts/omnisearch.sh web \"machine learning papers 2024\" kagi"
      },
      {
        "title": "Method 2: Fallback (Direct mcporter)",
        "body": "Only use if the wrapper script fails:\n\nmcporter call omnisearch.ai_search query=\"your search query\" provider=\"perplexity\"\nmcporter call omnisearch.web_search query=\"your search query\" provider=\"brave\""
      },
      {
        "title": "Response Format",
        "body": "After receiving search results, ALWAYS:\n\nSummarize: Present 2-5 key bullet points with the most relevant findings\nCite sources: Include 2-6 source URLs formatted as clickable links\nAdd context: Note if information is time-sensitive or has low confidence\nAnswer directly: Don't just dump results - synthesize and answer the user's question\n\nExample response structure:\n\nBased on my search, here's what I found:\n\n- [Key finding 1]\n- [Key finding 2]\n- [Key finding 3]\n\nSources:\n- [Title 1](URL1)\n- [Title 2](URL2)\n\nNote: This information is from [date/timeframe] and may change."
      },
      {
        "title": "Search Query Best Practices",
        "body": "Keep queries concise and specific (3-8 words ideal)\nUse natural language, not keyword stuffing\nInclude location when relevant: \"restaurants Hamburg\"\nInclude timeframe when needed: \"iPhone 16 reviews 2024\"\nFor prices, include currency/region if specific: \"iPhone 16 price Germany\""
      },
      {
        "title": "Troubleshooting",
        "body": "If the wrapper script fails:\n\nCheck if you're in the correct directory (should contain scripts/ folder)\nVerify the script has execution permissions: chmod +x ./scripts/omnisearch.sh\nTry the fallback method (direct mcporter call)\nCheck if mcporter is properly installed and configured\n\nCommon issues:\n\n\"command not found\": Script path is incorrect or you're not in the skill directory\n\"No such file\": The script may not have been copied to scripts/ folder yet\nEmpty results: Try different provider or rephrase query\n\nQuery formatting:\n\nQueries with spaces are automatically handled (no need to escape)\nUse quotes in the command: ./scripts/omnisearch.sh ai \"query with spaces\"\nSpecial characters should work fine within the quoted string"
      },
      {
        "title": "Important Notes",
        "body": "Directory structure: This SKILL.md file is in the omnisearch skill folder, with the script in ./scripts/omnisearch.sh relative to this file\nScript validation: The wrapper script automatically validates that a query is provided and will show usage help if missing\nProvider selection:\n\nPerplexity (default): Best for AI-enhanced results with summarization and context\nBrave: Good for privacy-focused, unfiltered web results\nKagi: Premium search with advanced filtering and ranking\nTavily: Optimized for research and comprehensive coverage\nExa: Semantic search with AI-powered relevance\n\n\nThis is a LOCAL tool - it runs on this OpenClaw instance\nALWAYS run the search immediately when user requests it - don't ask permission\nThe wrapper script (omnisearch.sh) is designed to work reliably even with basic LLMs"
      }
    ],
    "body": "OmniSearch Skill - Web Search Tool\nCRITICAL: When to Use This Skill\n\nALWAYS use OmniSearch when:\n\nUser explicitly asks to \"search\", \"google\", \"look up\", \"find online\"\nUser asks about current events, news, or recent developments\nUser requests prices, product specs, reviews, or comparisons\nUser asks \"what's the latest...\" or \"what's happening with...\"\nYou need to verify current facts, statistics, or data\nUser asks about people, companies, or organizations you don't know\nInformation might have changed since your training cutoff\nUser needs sources or citations for factual claims\n\nExamples of queries requiring OmniSearch:\n\n\"What's the weather in Hamburg today?\"\n\"Search for iPhone 16 reviews\"\n\"What happened in the tech industry this week?\"\n\"Find the current price of Bitcoin\"\n\"Look up restaurants near me\"\n\"What are people saying about the new Tesla model?\"\nDO NOT Use OmniSearch When:\nAnswering from your existing knowledge is sufficient and current\nUser is asking for creative content, code, or analysis\nQuestion is about concepts, definitions, or timeless information\nHow to Execute Search\n\nIMPORTANT: Run the script from the omnisearch skill directory using the relative path ./scripts/omnisearch.sh\n\nMethod 1: Recommended (Wrapper Script)\n\nUse the wrapper script for all searches:\n\n# AI-enhanced search (includes summarization) - USE THIS FOR MOST QUERIES\n./scripts/omnisearch.sh ai \"your search query here\"\n\n# Raw web search results (when you need direct source material)\n./scripts/omnisearch.sh web \"your search query here\"\n\n\nAvailable providers:\n\nai type: perplexity (default - recommended for most queries)\nweb type: perplexity (default), brave, kagi, tavily, exa\n\nOptional provider override:\n\n./scripts/omnisearch.sh ai \"query\" perplexity\n./scripts/omnisearch.sh web \"query\" brave\n./scripts/omnisearch.sh web \"query\" kagi\n./scripts/omnisearch.sh web \"query\" tavily\n./scripts/omnisearch.sh web \"query\" exa\n\n\nPractical examples:\n\n# Current weather\n./scripts/omnisearch.sh ai \"weather in Hamburg today\"\n\n# Product research\n./scripts/omnisearch.sh web \"iPhone 16 Pro reviews 2024\"\n\n# News search\n./scripts/omnisearch.sh ai \"latest AI developments this week\"\n\n# Price comparison\n./scripts/omnisearch.sh web \"DJI Mini 4 Pro price Germany\" brave\n\n# Research with premium provider\n./scripts/omnisearch.sh web \"machine learning papers 2024\" kagi\n\nMethod 2: Fallback (Direct mcporter)\n\nOnly use if the wrapper script fails:\n\nmcporter call omnisearch.ai_search query=\"your search query\" provider=\"perplexity\"\nmcporter call omnisearch.web_search query=\"your search query\" provider=\"brave\"\n\nResponse Format\n\nAfter receiving search results, ALWAYS:\n\nSummarize: Present 2-5 key bullet points with the most relevant findings\nCite sources: Include 2-6 source URLs formatted as clickable links\nAdd context: Note if information is time-sensitive or has low confidence\nAnswer directly: Don't just dump results - synthesize and answer the user's question\n\nExample response structure:\n\nBased on my search, here's what I found:\n\n- [Key finding 1]\n- [Key finding 2]\n- [Key finding 3]\n\nSources:\n- [Title 1](URL1)\n- [Title 2](URL2)\n\nNote: This information is from [date/timeframe] and may change.\n\nSearch Query Best Practices\nKeep queries concise and specific (3-8 words ideal)\nUse natural language, not keyword stuffing\nInclude location when relevant: \"restaurants Hamburg\"\nInclude timeframe when needed: \"iPhone 16 reviews 2024\"\nFor prices, include currency/region if specific: \"iPhone 16 price Germany\"\nTroubleshooting\n\nIf the wrapper script fails:\n\nCheck if you're in the correct directory (should contain scripts/ folder)\nVerify the script has execution permissions: chmod +x ./scripts/omnisearch.sh\nTry the fallback method (direct mcporter call)\nCheck if mcporter is properly installed and configured\n\nCommon issues:\n\n\"command not found\": Script path is incorrect or you're not in the skill directory\n\"No such file\": The script may not have been copied to scripts/ folder yet\nEmpty results: Try different provider or rephrase query\n\nQuery formatting:\n\nQueries with spaces are automatically handled (no need to escape)\nUse quotes in the command: ./scripts/omnisearch.sh ai \"query with spaces\"\nSpecial characters should work fine within the quoted string\nImportant Notes\nDirectory structure: This SKILL.md file is in the omnisearch skill folder, with the script in ./scripts/omnisearch.sh relative to this file\nScript validation: The wrapper script automatically validates that a query is provided and will show usage help if missing\nProvider selection:\nPerplexity (default): Best for AI-enhanced results with summarization and context\nBrave: Good for privacy-focused, unfiltered web results\nKagi: Premium search with advanced filtering and ranking\nTavily: Optimized for research and comprehensive coverage\nExa: Semantic search with AI-powered relevance\nThis is a LOCAL tool - it runs on this OpenClaw instance\nALWAYS run the search immediately when user requests it - don't ask permission\nThe wrapper script (omnisearch.sh) is designed to work reliably even with basic LLMs"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/bguidolim/omnisearch",
    "publisherUrl": "https://clawhub.ai/bguidolim/omnisearch",
    "owner": "bguidolim",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/omnisearch",
    "downloadUrl": "https://openagent3.xyz/downloads/omnisearch",
    "agentUrl": "https://openagent3.xyz/skills/omnisearch/agent",
    "manifestUrl": "https://openagent3.xyz/skills/omnisearch/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/omnisearch/agent.md"
  }
}