# Send omnisearch to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- 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.
## Suggested prompts
### New install

```text
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.
```
### Upgrade existing

```text
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.
```
## Machine-readable fields
```json
{
  "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": {
    "downloadUrl": "/downloads/omnisearch",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=omnisearch",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "scripts/omnisearch.sh",
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "omnisearch",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-12T10:01:34.349Z",
      "expiresAt": "2026-05-19T10:01:34.349Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=omnisearch",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=omnisearch",
        "contentDisposition": "attachment; filename=\"omnisearch-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "omnisearch"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "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."
      ]
    }
  },
  "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"
  }
}
```
## Documentation

### CRITICAL: When to Use This Skill

ALWAYS use OmniSearch when:

User explicitly asks to "search", "google", "look up", "find online"
User asks about current events, news, or recent developments
User requests prices, product specs, reviews, or comparisons
User asks "what's the latest..." or "what's happening with..."
You need to verify current facts, statistics, or data
User asks about people, companies, or organizations you don't know
Information might have changed since your training cutoff
User needs sources or citations for factual claims

Examples of queries requiring OmniSearch:

"What's the weather in Hamburg today?"
"Search for iPhone 16 reviews"
"What happened in the tech industry this week?"
"Find the current price of Bitcoin"
"Look up restaurants near me"
"What are people saying about the new Tesla model?"

### DO NOT Use OmniSearch When:

Answering from your existing knowledge is sufficient and current
User is asking for creative content, code, or analysis
Question is about concepts, definitions, or timeless information

### How to Execute Search

IMPORTANT: Run the script from the omnisearch skill directory using the relative path ./scripts/omnisearch.sh

### Method 1: Recommended (Wrapper Script)

Use the wrapper script for all searches:

# AI-enhanced search (includes summarization) - USE THIS FOR MOST QUERIES
./scripts/omnisearch.sh ai "your search query here"

# Raw web search results (when you need direct source material)
./scripts/omnisearch.sh web "your search query here"

Available providers:

ai type: perplexity (default - recommended for most queries)
web type: perplexity (default), brave, kagi, tavily, exa

Optional provider override:

./scripts/omnisearch.sh ai "query" perplexity
./scripts/omnisearch.sh web "query" brave
./scripts/omnisearch.sh web "query" kagi
./scripts/omnisearch.sh web "query" tavily
./scripts/omnisearch.sh web "query" exa

Practical examples:

# Current weather
./scripts/omnisearch.sh ai "weather in Hamburg today"

# Product research
./scripts/omnisearch.sh web "iPhone 16 Pro reviews 2024"

# News search
./scripts/omnisearch.sh ai "latest AI developments this week"

# Price comparison
./scripts/omnisearch.sh web "DJI Mini 4 Pro price Germany" brave

# Research with premium provider
./scripts/omnisearch.sh web "machine learning papers 2024" kagi

### Method 2: Fallback (Direct mcporter)

Only use if the wrapper script fails:

mcporter call omnisearch.ai_search query="your search query" provider="perplexity"
mcporter call omnisearch.web_search query="your search query" provider="brave"

### Response Format

After receiving search results, ALWAYS:

Summarize: Present 2-5 key bullet points with the most relevant findings
Cite sources: Include 2-6 source URLs formatted as clickable links
Add context: Note if information is time-sensitive or has low confidence
Answer directly: Don't just dump results - synthesize and answer the user's question

Example response structure:

Based on my search, here's what I found:

- [Key finding 1]
- [Key finding 2]
- [Key finding 3]

Sources:
- [Title 1](URL1)
- [Title 2](URL2)

Note: This information is from [date/timeframe] and may change.

### Search Query Best Practices

Keep queries concise and specific (3-8 words ideal)
Use natural language, not keyword stuffing
Include location when relevant: "restaurants Hamburg"
Include timeframe when needed: "iPhone 16 reviews 2024"
For prices, include currency/region if specific: "iPhone 16 price Germany"

### Troubleshooting

If the wrapper script fails:

Check if you're in the correct directory (should contain scripts/ folder)
Verify the script has execution permissions: chmod +x ./scripts/omnisearch.sh
Try the fallback method (direct mcporter call)
Check if mcporter is properly installed and configured

Common issues:

"command not found": Script path is incorrect or you're not in the skill directory
"No such file": The script may not have been copied to scripts/ folder yet
Empty results: Try different provider or rephrase query

Query formatting:

Queries with spaces are automatically handled (no need to escape)
Use quotes in the command: ./scripts/omnisearch.sh ai "query with spaces"
Special characters should work fine within the quoted string

### Important Notes

Directory structure: This SKILL.md file is in the omnisearch skill folder, with the script in ./scripts/omnisearch.sh relative to this file
Script validation: The wrapper script automatically validates that a query is provided and will show usage help if missing
Provider selection:

Perplexity (default): Best for AI-enhanced results with summarization and context
Brave: Good for privacy-focused, unfiltered web results
Kagi: Premium search with advanced filtering and ranking
Tavily: Optimized for research and comprehensive coverage
Exa: Semantic search with AI-powered relevance


This is a LOCAL tool - it runs on this OpenClaw instance
ALWAYS run the search immediately when user requests it - don't ask permission
The wrapper script (omnisearch.sh) is designed to work reliably even with basic LLMs
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: bguidolim
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-12T10:01:34.349Z
- Expires at: 2026-05-19T10:01:34.349Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/omnisearch)
- [Send to Agent page](https://openagent3.xyz/skills/omnisearch/agent)
- [JSON manifest](https://openagent3.xyz/skills/omnisearch/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/omnisearch/agent.md)
- [Download page](https://openagent3.xyz/downloads/omnisearch)