Search the web using DuckDuckGo and return structured results with titles, URLs, and snippets. No API key required.
When to Use
Finding information on the web about a topic
Looking up documentation, articles, or resources
Answering questions that require current or real-time information
Discovering URLs to fetch with the web_fetch tool
When NOT to Use
Fetching the full content of a known URL — use the web_fetch tool instead
Searching within a specific service (GitHub, Linear, etc.) — use that service's skill
Querying local files or databases
Tools
web_search
Search the web for information. Returns titles, URLs, and snippets from DuckDuckGo.
Parameters:
Name
Type
Required
Description
query
string
yes
Search query string
count
number
no
Number of results to return (1–20, default 5)
Returns:{ "result": "..." } — formatted text with numbered results:
Search results for "query":
1. **Title**
URL: https://example.com
Snippet text describing the result...
2. **Another Title**
URL: https://another.com
Another snippet...
On failure, returns { "error": "..." }.
Examples:
{ "query": "best databases for AI agents", "count": 5 } — search with 5 results
{ "query": "Node.js fetch API documentation" } — search with default count
Notes
Uses DuckDuckGo HTML search (no API key required)
Results include title, URL, and snippet for each match
For fetching full page content from a result URL, use the web_fetch tool from the web-fetch skill
1---2name: web-search3description: Web Search4---5# Web Search67Search the web using DuckDuckGo and return structured results with titles, URLs, and snippets. No API key required.89## When to Use1011- Finding information on the web about a topic12- Looking up documentation, articles, or resources13- Answering questions that require current or real-time information14- Discovering URLs to fetch with the `web_fetch` tool1516## When NOT to Use1718- Fetching the full content of a known URL — use the `web_fetch` tool instead19- Searching within a specific service (GitHub, Linear, etc.) — use that service's skill20- Querying local files or databases2122## Tools2324### `web_search`2526Search the web for information. Returns titles, URLs, and snippets from DuckDuckGo.2728**Parameters:**2930| Name | Type | Required | Description |31|------|------|----------|-------------|32| `query` | string | yes | Search query string |33| `count` | number | no | Number of results to return (1–20, default 5) |3435**Returns:** `{ "result": "..." }` — formatted text with numbered results:3637```38Search results for "query":39401. **Title**41 URL: https://example.com42 Snippet text describing the result...43442. **Another Title**45 URL: https://another.com46 Another snippet...47```4849On failure, returns `{ "error": "..." }`.5051**Examples:**5253- `{ "query": "best databases for AI agents", "count": 5 }` — search with 5 results54- `{ "query": "Node.js fetch API documentation" }` — search with default count5556## Notes5758- Uses DuckDuckGo HTML search (no API key required)59- Results include title, URL, and snippet for each match60- For fetching full page content from a result URL, use the `web_fetch` tool from the web-fetch skill
Run npx skillmds@latest add aaronboshart1/web-search in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Web Search It is listed under Coding & Dev Tools on SkillMD.
This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
aaronboshart1 (@aaronboshart1) published this skill. Their other Agent Skills are listed on their SkillMD profile.