Cc Websearch
Claude Code plugin providing DuckDuckGo-powered WebSearch and WebFetch skills as a drop-in replacement for built-in tools, with no API keys required.
Djarvur · AI review on file
Installation
Read the source and dependencies before running a command. Copying does not install or execute anything.
npx skills add Djarvur/cc-websearchAbout this skill
cc-websearch
A Claude Code plugin providing WebSearch and WebFetch skills as a drop-in replacement for Claude Code's built-in tools. Powered by DuckDuckGo (no API keys required). Zero configuration for basic use.
- WebSearch -- Search the web using DuckDuckGo, returning structured XML results
- WebFetch -- Fetch a web page, extract its main content, and convert to markdown
No API keys, no accounts, no subscriptions. Install the plugin and start searching.
Quick Install
Clone the repository and point Claude Code at it:
git clone https://github.com/Djarvur/cc-websearch.git
claude --plugin-dir /path/to/cc-websearch
Compiled scripts are shipped in git (built via esbuild), so the plugin works immediately after clone -- no build step is needed.
claude --plugin-url <url> can load a packaged plugin .zip for a single session, but this repository does not currently publish one as a release asset.
Usage
Both skills accept JSON input on stdin and write results to stdout. Errors and diagnostic messages are written to stderr.
WebSearch
Pipe a JSON object with a query field:
echo '{"query":"latest ECMAScript specification"}' | node "${CLAUDE_PLUGIN_ROOT}/skills/websearch/scripts/websearch.cjs"
The script produces <search_results> XML on stdout:
<search_results>
<result>
<title>ECMAScript 2024 specification finalized</title>
<url>https://example.com/ecmascript-2024</url>
<snippet>ECMAScript 2024, the 15th edition, adds new array grouping, Promise.withResolvers, and RegExp v flag.</snippet>
</result>
</search_results>
Optional fields:
allowed_domains(string[]): Only return results from these domainsblocked_domains(string[]): Exclude results from these domains
allowed_domains and blocked_domains cannot be used together.
WebFetch
Pipe a JSON object with a url and prompt field:
echo '{"url":"https://example.com/article","prompt":"Summarize this article"}' |