← Back to Skills Marketplace
253
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install claudecode-websearch
Description
Free web search using Claude Code CLI or Codex CLI's built-in WebSearch tool — no Tavily, Brave, or Exa API key required. Activate when the user says "websea...
README (SKILL.md)
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 |
Usage Guidance
Summary of risks and recommendations before installing:
- The skill itself is a small wrapper script and is consistent with its description. It does not exfiltrate files or request unrelated credentials.
- The script invokes your installed Claude Code or Codex CLI; those CLIs will perform network requests and use any authentication already configured on your machine. Ensure you trust the installed CLIs and that they were obtained from official sources.
- The README suggests creating a symlink (~/.local/bin/ccws). Creating such an alias can shadow existing commands in your PATH — only do it if you’re comfortable.
- If you want extra caution: inspect the local claude/codex binaries you have installed, avoid creating the symlink, or run the script manually instead of giving it automatic invocation. Also verify the skill's source (the registry metadata owner/slug) if provenance matters to you.
Capability Analysis
Type: OpenClaw Skill
Name: claudecode-websearch
Version: 1.0.0
The skill is a legitimate utility designed to provide web search capabilities by leveraging the 'WebSearch' tools built into the Claude Code and Codex CLIs. The primary script (scripts/websearch.sh) handles user queries by passing them as quoted arguments to the respective binaries, avoiding shell injection vulnerabilities. The documentation and setup instructions (SKILL.md and README.md) describe standard practices, such as creating a symlink for a global alias, and do not contain malicious instructions or evidence of data exfiltration.
Capability Assessment
Purpose & Capability
The name/description ask for a free web search via Claude Code or Codex CLI and the skill only requires those CLIs (anyBins: claude or codex). There are no unrelated credentials, binaries, or config paths requested.
Instruction Scope
SKILL.md and the included scripts confine themselves to invoking the detected CLI with a search prompt, optional alias creation, and (for Codex) running from a temp directory. The instructions do not read arbitrary files, environment variables, or post data to third-party endpoints beyond the CLIs' normal network activity.
Install Mechanism
No install spec (instruction-only) and the included script is small and readable. The README suggests installing the CLIs via npm and creating a symlink in ~/.local/bin for an alias — both are normal but users should be aware a symlink can shadow existing commands in PATH.
Credentials
The skill requests no environment variables or secrets. It does rely on whatever authentication the installed Claude/Codex CLIs already have configured — that is expected for this purpose but means those CLIs (not the skill) will use any stored tokens.
Persistence & Privilege
The skill is not always-enabled, does not request elevated privileges, and does not modify other skills or system-wide agent settings. The only persistent change it suggests is an optional symlink in the user's home directory.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install claudecode-websearch - After installation, invoke the skill by name or use
/claudecode-websearch - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: free web search via Claude Code CLI or Codex CLI WebSearch tool
Metadata
Frequently Asked Questions
What is Claude Code WebSearch?
Free web search using Claude Code CLI or Codex CLI's built-in WebSearch tool — no Tavily, Brave, or Exa API key required. Activate when the user says "websea... It is an AI Agent Skill for Claude Code / OpenClaw, with 253 downloads so far.
How do I install Claude Code WebSearch?
Run "/install claudecode-websearch" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Claude Code WebSearch free?
Yes, Claude Code WebSearch is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Claude Code WebSearch support?
Claude Code WebSearch is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Claude Code WebSearch?
It is built and maintained by jinghan23 (@jinghan23); the current version is v1.0.0.
More Skills