Claude WebSearch Skill

Use the bundled script to search the web via Claude Code CLI (primary) or Codex CLI (fallback). Both CLIs expose a native WebSearch tool — no third-party search API key needed.

When to Use

• Tavily / Brave / Exa quota is exhausted
• User says "websearch搜一下X", "search for X", "查一下X"
• Any web search need where no API key is configured

Quick Usage

# Primary (Claude Code CLI — fast, recommended)
scripts/websearch.sh "your query"

# With result count
scripts/websearch.sh "your query" --max 3

# Explicit backend
scripts/websearch.sh "your query" --backend codex

Or use the global alias (if installed):

ccws "your query"

How It Works

| Backend | CLI flag | Notes | |---------|----------|-------| | claude (default) | --allowedTools "WebSearch" | Fast (~5s), clean output | | codex | --search + reasoning_effort=low | Slower (~30-60s), use as fallback |

The script auto-detects which CLI is available; claude is preferred when both exist.

Setup (one-time)

Install the global alias ccws for quick access:

ln -sf "$(pwd)/scripts/websearch.sh" ~/.local/bin/ccws

Troubleshooting

| Problem | Fix | |---------|-----| | claude: command not found | Install Claude Code CLI: npm install -g @anthropic-ai/claude-code | | codex: command not found | Install Codex CLI: npm install -g @openai/codex | | Claude returns empty output | Check claude auth status; re-login if expired | | Codex times out | Normal — use --backend claude instead | | Not inside a trusted directory (Codex) | Script handles this by running from a temp dir |