Agent skill

Web Search Plus

by CraftOS-dev in CraftOS-dev/CraftBot

Unified search skill with Intelligent Auto-Routing. An agent skill from CraftOS-dev/CraftBot.

MITAuto-check: notesProductivity & Automation

Install Web Search Plus

skills CLI
$ npx skills add CraftOS-dev/CraftBot --skill web-search-plus -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install CraftOS-dev/CraftBot web-search-plus --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/CraftOS-dev/CraftBot.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/web-search-plus .claude/skills/web-search-plus && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
web-search-plus
GitHub stars
392
Used in
1 other repo
Token cost
~2.4k tokens
SKILL.md length
709 words
Files
12 (incl. scripts)
Skills in repo
89
Repo updated
First seen
Licence
MIT

At a glance

Unified search skill with Intelligent Auto-Routing. An agent skill from CraftOS-dev/CraftBot.

  • Tasks that involve Web search
  • SKILL.md covers ✨ What Makes This Different?, 🚀 Quick Start, 🔑 API Keys and 🎯 When to Use Which Provider, plus 11 more sections
  • Runs Python and Shell scripts from its folder; calls python3 and docker; reaches stripe.com; needs SERPER_API_KEY and TAVILY_API_KEY

What it does

Web Search Plus is an agent skill from CraftOS-dev/CraftBot. Unified search skill with Intelligent Auto-Routing. Uses multi-signal analysis to automatically select between Serper (Google), Tavily (Research), Exa (Neural), Perplexity (AI Answers), You.com (RAG/Real-time), and SearXNG (Privacy/Self-hosted) with confidence scoring.

Its SKILL.md is about 2.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 13 other files, including scripts (for example `.clawhub/origin.json`, `CHANGELOG.md` and `FAQ.md`).

It sits in Productivity & Automation, covering Web search. It works with Tavily and Perplexity. The repository describes itself as: One agent. Every kind of work. The licence is MIT.

When your agent uses it

  • Tasks that involve Web search

Example prompts

  • “/web-search-plus”

Requirements

  • Python 3
  • A Bash shell
  • Docker
  • A credential in SERPER_API_KEY
  • A credential in TAVILY_API_KEY

What it can do on your machine

Read from SKILL.md and the folder at commit b50970c. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 2 files in scripts/ (Python and Shell), which the agent can run.

    Shell commands in SKILL.md call:

    • python3
    • docker

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • stripe.com

    Also links to:

    • serper.dev
    • tavily.com
    • exa.ai
    • kilo.ai
    • api.you.com
    • docs.searxng.org
    • perplexity.ai

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • SERPER_API_KEY
    • TAVILY_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Web Search Plus loads about 2.4k tokens when it runs. Until then it costs about 71 tokens; SKILL.md has 709 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~71
When it runs · the whole SKILL.md, loaded when a task matches
~2.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:57
    # Option A: .env file (recommended)
  • NoteMentions a .env fileSKILL.md:225
    s skill's scripts — keys auto-load from `.env`

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from CraftOS-dev/CraftBot at commit b50970c, republished under its MIT licence (© CraftOS-dev). 709 words, ~2,357 tokens.

Download SKILL.mdSave it as .claude/skills/web-search-plus/SKILL.md (or your agent's skills folder). This skill also uses 11 other files; get the full folder from GitHub.
name
web-search-plus
description
Unified search skill with Intelligent Auto-Routing. Uses multi-signal analysis to automatically select between Serper (Google), Tavily (Research), Exa (Neural), Perplexity (AI Answers), You.com (RAG/Real-time), and SearXNG (Privacy/Self-hosted) with confidence scoring.
version
2.8.1
tags
search, web-search, serper, tavily, exa, perplexity, you, searxng, google, research, semantic-search, auto-routing, multi-provider, shopping, rag, free-tier…

Web Search Plus

Stop choosing search providers. Let the skill do it for you.

This skill connects you to 6 search providers (Serper, Tavily, 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.


✨ What Makes This Different?

  • Just search — No need to think about which provider to use
  • Smart routing — Analyzes your query and picks the best provider automatically
  • 6 providers, 1 interface — Google results, research engines, neural search, AI answers with citations, RAG-optimized, and privacy-first all in one
  • Works with just 1 key — Start with any single provider, add more later
  • Free options available — SearXNG is completely free (self-hosted)

🚀 Quick Start

bash
# Interactive setup (recommended for first run)
python3 scripts/setup.py

# Or manual: copy config and add your keys
cp config.example.json config.json

The wizard explains each provider, collects API keys, and configures defaults.


🔑 API Keys

You only need ONE key to get started. Add more providers later for better coverage.

ProviderFree TierBest ForSign Up
Serper2,500/moShopping, prices, local, newsserper.dev
Tavily1,000/moResearch, explanations, academictavily.com
Exa1,000/mo"Similar to X", startups, papersexa.ai
PerplexityVia KiloDirect answers with citationskilo.ai
You.comLimitedReal-time info, AI/RAG contextapi.you.com
SearXNGFREE ✅Privacy, multi-source, $0 costSelf-hosted

Setting your keys:

bash
# Option A: .env file (recommended)
export SERPER_API_KEY="your-key"
export TAVILY_API_KEY="your-key"

# Option B: config.json
{ "serper": { "api_key": "your-key" } }

🎯 When to Use Which Provider

I want to...ProviderExample Query
Find 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"
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

Pro tip: Just search normally! Auto-routing handles most queries correctly. Override with -p provider when needed.


🧠 How Auto-Routing Works

The skill looks at your query and picks the best provider:

bash
"iPhone 16 price"              → Serper (shopping keywords)
"how does quantum computing work" → Tavily (research question)
"companies like stripe.com"    → Exa (URL detected, similarity)
"events in Graz this weekend"  → Perplexity (local + direct answer)
"latest news on AI"            → You.com (real-time intent)
"search privately"             → SearXNG (privacy keywords)

What if it picks wrong? Override it: python3 scripts/search.py -p tavily -q "your query"

Debug routing: python3 scripts/search.py --explain-routing -q "your query"


📖 Usage Examples

bash
python3 scripts/search.py -q "Tesla Model 3 price"
python3 scripts/search.py -q "explain machine learning"
python3 scripts/search.py -q "startups like Figma"
Force a Specific Provider
bash
python3 scripts/search.py -p serper -q "weather Berlin"
python3 scripts/search.py -p tavily -q "quantum computing" --depth advanced
python3 scripts/search.py -p exa --similar-url "https://stripe.com" --category company
python3 scripts/search.py -p you -q "breaking tech news" --include-news
python3 scripts/search.py -p searxng -q "linux distros" --engines "google,bing"

⚙ Configuration

json
{
  "auto_routing": {
    "enabled": true,
    "fallback_provider": "serper",
    "confidence_threshold": 0.3,
    "disabled_providers": []
  },
  "serper": {"country": "us", "language": "en"},
  "tavily": {"depth": "advanced"},
  "exa": {"type": "neural"},
  "you": {"country": "US", "include_news": true},
  "searxng": {"instance_url": "https://your-instance.example.com"}
}

📊 Provider Comparison

FeatureSerperTavilyExaPerplexityYou.comSearXNG
Speed⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡⚡
Direct Answers✗✗✗✓✓✗✗
Citations✗✗✗✓✗✗
Factual Accuracy⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐
Semantic Understanding⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐⭐
Full Page Content✗✓✓✓✓✗
Shopping/Local✓✗✗✗✗✓
Find Similar Pages✗✗✓✗✗✗
RAG-Optimized✗✓✗✗✓✓✗
Privacy-First✗✗✗✗✗✓✓
API Cost$$$$$$Via Kilo$FREE

❓ Common Questions

Do I need API keys for all providers?

No. You only need keys for providers you want to use. Start with one (Serper recommended), add more later.

Show full SKILL.md (276 more words)Show less
Which provider should I start with?

Serper — fastest, cheapest, largest free tier (2,500 queries/month), and handles most queries well.

What if I run out of free queries?

The skill automatically falls back to your other configured providers. Or switch to SearXNG (unlimited, self-hosted).

How much does this cost?
  • Free tiers: 2,500 (Serper) + 1,000 (Tavily) + 1,000 (Exa) = 4,500+ free searches/month
  • SearXNG: Completely free (just ~$5/mo if you self-host on a VPS)
  • Paid plans: Start around $10-50/month depending on provider
Is SearXNG really private?

Yes, if self-hosted. You control the server, no tracking, no profiling. Public instances depend on the operator's policy.

How do I set up SearXNG?
bash
# Docker (5 minutes)
docker run -d -p 8080:8080 searxng/searxng

Then enable JSON API in settings.yml. See docs.searxng.org.

Why did it route my query to the "wrong" provider?

Sometimes queries are ambiguous. Use --explain-routing to see why, then override with -p provider if needed.


🔄 Automatic Fallback

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.


📤 Output Format

json
{
  "provider": "serper",
  "query": "iPhone 16 price",
  "results": [{"title": "...", "url": "...", "snippet": "...", "score": 0.95}],
  "routing": {
    "auto_routed": true,
    "provider": "serper",
    "confidence": 0.78,
    "confidence_level": "high"
  }
}

⚠ Important Note

Tavily, Serper, and Exa are NOT core OpenClaw providers.

❌ Don't modify ~/.openclaw/openclaw.json for these
✅ Use this skill's scripts — keys auto-load from .env


🔒 Security

SearXNG SSRF Protection: The SearXNG instance URL is validated with defense-in-depth:

  • Enforces http/https schemes only
  • Blocks cloud metadata endpoints (169.254.169.254, metadata.google.internal)
  • Resolves hostnames and blocks private/internal IPs (loopback, RFC1918, link-local, reserved)
  • Operators who intentionally self-host on private networks can set SEARXNG_ALLOW_PRIVATE=1

📚 More Documentation


© CraftOS-dev, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 11 other files (scripts) in skills/web-search-plus of CraftOS-dev/CraftBot.

  • SKILL.md
  • .clawhub/origin.json
  • CHANGELOG.md
  • FAQ.md
  • README.md
  • TROUBLESHOOTING.md
  • _meta.json
  • config.example.json
  • package.json
  • scripts/search.py
  • scripts/setup.py
  • test-auto-routing.sh

Open the folder on GitHubat commit b50970c

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in CraftOS-dev/CraftBot, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Web Search Plus next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Web Search Plus compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Web Search Plus this skillCraftOS-dev/CraftBot3921 repos~2.4kAutomated safety check: NotesMIT
Web SearchEXboys/skilllite1703 repos~1kAutomated safety check: PassMIT
Keirouter Web Searchmydisha/keirouter147—~771Automated safety check: PassMIT
Web SearchOpenMinis/MinisSkills440—~984Automated safety check: PassMIT
9Router Web Searchdecolua/9router30k—~1kAutomated safety check: PassMIT
Mysearchskernelx/MySearch-Proxy159—~3kAutomated safety check: NotesNone

Similar skills

  • Web Search

    EXboys/skilllite

    Web search and content extraction with Tavily and Exa via inference.sh CLI.

    170 GitHub starsUsed in 3 repos~1k tokens
    Productivity & AutomationAuto-check passed
  • Keirouter Web Search

    mydisha/keirouter

    Web search via KeiRouter /v1/search using Tavily / Exa / Brave / Serper / SearXNG / Google PSE / Perplexity.

    147 GitHub stars~771 tokensUpdated 26 days ago
    Productivity & AutomationAuto-check passed
  • Web Search

    OpenMinis/MinisSkills

    General web search skill that uses browser automation with multiple search engines and selects the priority chain based on search intent.

    440 GitHub stars~984 tokensUpdated 2 days ago
    Productivity & AutomationAuto-check passed
  • 9Router Web Search

    decolua/9router

    Runs web, news and public X searches through a 9Router gateway's search endpoint, choosing among providers such as Tavily, Exa, Brave and Perplexity.

    30k GitHub stars~1k tokensUpdated 6 days ago
    Productivity & AutomationAuto-check passed
  • Mysearch

    skernelx/MySearch-Proxy

    Install, verify, debug, and use MySearch MCP/Skill. An agent skill from skernelx/MySearch-Proxy.

    159 GitHub stars~3k tokensUpdated 6 mo ago
    Productivity & AutomationAuto-check: notes
  • Perplexity Improver

    ThomasHoussin/Claude-Book

    Improve chapter perplexity score by rewriting AI-suspect sentences.

    120 GitHub stars~959 tokensUpdated 8 mo ago
    Productivity & AutomationAuto-check passed

More from CraftOS-dev/CraftBot

All 89 skills in this repo
  • Self Improvement

    CraftOS-dev/CraftBot

    Captures learnings, errors, and corrections to enable continuous improvement.

    392 GitHub starsUsed in 5 repos~4.9k tokens
    Auto-check passed
  • Bbc News

    CraftOS-dev/CraftBot

    Fetch and display BBC News stories from various sections and regions via RSS feeds.

    392 GitHub starsUsed in 2 repos~555 tokens
    Auto-check passed
  • Outlook

    CraftOS-dev/CraftBot

    Read, search, and manage Outlook emails and calendar via Microsoft Graph API.

    392 GitHub starsUsed in 2 repos~1.8k tokens
    Auto-check passed
  • Nano Banana Pro

    CraftOS-dev/CraftBot

    Generate/edit images with Nano Banana Pro (Gemini 3 Pro Image).

    392 GitHub starsUsed in 6 repos~1.4k tokens
    Auto-check passed
  • Airweave

    CraftOS-dev/CraftBot

    Context retrieval layer for AI agents across users' applications.

    392 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Telegram Bot Manager

    CraftOS-dev/CraftBot

    Manage and configure Telegram bots for OpenClaw. An agent skill from CraftOS-dev/CraftBot.

    392 GitHub stars~836 tokensUpdated today
    Auto-check passed

Questions about Web Search Plus

What does Web Search Plus do?

Unified search skill with Intelligent Auto-Routing. An agent skill from CraftOS-dev/CraftBot. Web Search Plus is an agent skill from CraftOS-dev/CraftBot. Unified search skill with Intelligent Auto-Routing.

When should I use Web Search Plus?

Web Search Plus fits situations like: tasks that involve Web search.

How do I install Web Search Plus in Claude Code?

Run `npx skills add CraftOS-dev/CraftBot --skill web-search-plus -a claude-code`. Or copy the skill folder (skills/web-search-plus in CraftOS-dev/CraftBot) into .claude/skills/web-search-plus in your project. Claude Code loads it when a task matches its description.

How do I install Web Search Plus in Codex?

Run `npx skills add CraftOS-dev/CraftBot --skill web-search-plus -a codex`. Or copy the skill folder (skills/web-search-plus in CraftOS-dev/CraftBot) into .agents/skills/web-search-plus in your project. Codex loads it when a task matches its description.

Can I use Web Search Plus in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add CraftOS-dev/CraftBot --skill web-search-plus -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/web-search-plus, .gemini/skills/web-search-plus, .github/skills/web-search-plus and .opencode/skills/web-search-plus in your project.

What does Web Search Plus need to run?

Going by SKILL.md and its folder, Web Search Plus needs Python and a shell for the scripts in its folder, the command-line tools its instructions call (python3 and docker) and credentials named SERPER_API_KEY and TAVILY_API_KEY. Our summary lists: Python 3; A Bash shell; Docker; A credential in SERPER_API_KEY; A credential in TAVILY_API_KEY.

Does Web Search Plus access the network?

SKILL.md names 8 domains. In commands or code: stripe.com; the agent is likely to contact it when it follows the instructions. As links in the text: serper.dev, tavily.com, exa.ai, kilo.ai, api.you.com, docs.searxng.org and perplexity.ai. This is read from the text; nothing was executed.

Is Web Search Plus safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Web Search Plus use?

Web Search Plus is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Web Search Plus use?

About 2.4k tokens (SKILL.md is roughly 9.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Web Search Plus?

Skills that share tags, products or a category with Web Search Plus: Web Search (EXboys/skilllite, 170 stars), Keirouter Web Search (mydisha/keirouter, 147 stars), Web Search (OpenMinis/MinisSkills, 440 stars) and 9Router Web Search (decolua/9router, 30k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Web Search Plus?

CraftOS-dev (a GitHub user) maintains it in CraftOS-dev/CraftBot, which has 392 GitHub stars. The repository holds 89 skills in this directory. The repository was last updated on October 7, 2026.

Source: CraftOS-dev/CraftBot on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.