Web Search Skill
Search the web and fetch URL content using private, self-hosted scripts. No external APIs or MCP tools needed.
When to use
Any time you need information from the web — searching for something, looking up a topic, fetching a page's content. Always use these scripts instead of WebSearch, WebFetch, or MCP web tools.
Tools
The scripts live under ~/.claude/skills/search/scripts/. There are two main tools:
1. Search the web
python3 "~/.claude/skills/search/scripts/search.py" "your search query"
Options:
--json— raw JSON output--num N— limit to N results (default 10)
Returns a list of results with title, URL, and snippet for each.
2. Fetch a URL's content
python3 "~/.claude/skills/search/scripts/fetch_url.py" "https://example.com/page"
Options:
--json— raw JSON output--timeout N— timeout in seconds (default 30)
Returns the page's full text content plus metadata (title, author, publish date, word count).
How to search
Formulate a good query. Be specific. Include key terms, dates, or context that narrow the results.
Run the search. Use the search.py script. Read the output — you'll get titles, URLs, and snippets.
Fetch relevant pages. If a result looks promising, use fetch_url.py to get the full content. Focus on the top 2-3 most relevant results rather than fetching everything.
Synthesize. Combine information from multiple sources. Always cite the URL you got the information from.
Examples
Basic search:
User: "search for latest Claude 4 release date"
→ python3 "~/.claude/skills/search/scripts/search.py" "Claude 4 Anthropic release date 2026"
Research a topic:
User: "what's the current state of WebAssembly?"
→ python3 "~/.claude/skills/search/scripts/search.py" "WebAssembly current state 2026"
→ Then fetch the most relevant results to get detailed content
Fetch a specific page:
User: "can you read https://example.com/article and summarize it?"
→ python3 "~/.claude/skills/search/scripts/fetch_url.py" "https://example.com/article"
→ Summarize the content
Look up documentation:
User: "find the React 19 docs on use()"
→ python3 "~/.claude/skills/search/scripts/search.py" "React 19 use() hook documentation"
→ Fetch the most relevant result
Tips
- Run searches with
--jsonif you need to programmatically parse results. - For time-sensitive queries, include the year or "latest" in the search.
- If search results aren't great, try rephrasing the query with different keywords.
- When fetching pages, the script handles Reddit (via JSON API), Hacker News, and falls back to Puppeteer for JS-heavy sites automatically.