websearch git:20260521.8539224B

Immutable. This exact content never changes and is served at /api/v1/blob/1d541bf4563be763.

---
description: Search the web using DuckDuckGo. Use this skill when the user needs current information, web search results, or to find web pages about a topic.
allowed-tools: Bash(node *)
---

# WebSearch

Execute a web search by piping JSON input to the search script.

## Usage

Run the search script with the query as JSON stdin:

```bash
echo '{"query":"SEARCH_TERMS"}' | node "${CLAUDE_PLUGIN_ROOT}/scripts/websearch.cjs"
```

The script accepts JSON on stdin with this schema:

- `query` (string, required, minimum 2 characters): The search query
- `allowed_domains` (string[], optional): Only return results from these domains
- `blocked_domains` (string[], optional): Exclude results from these domains

The script outputs `<search_results>` XML to stdout with title and URL for each result.
Errors and diagnostic messages are written to stderr.

Always use the search results to inform your response. Include source URLs when citing information.