How do I install the Websearch skill?

Run npx skillmds@latest add tangledgroup/websearch 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.

Is Websearch safe to use?

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.

Which AI agents work with Websearch?

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.

Is Websearch free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Websearch?

tangledgroup (@tangledgroup) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Websearch by tangledgroup — Agent Skill

Name: Websearch
Author: tangledgroup

File contents

Web Search — DuckDuckGo to YAML

Overview

Searches DuckDuckGo via its HTML endpoint https://html.duckduckgo.com/html/ and outputs results as raw YAML. Final output of skill is complete YAML shown to the user exactly as produced — never summarized, never transformed.

A deterministic bash script handles all search execution — the agent always runs bash scripts/search.sh <query> and never constructs commands on the fly. This ensures consistent behavior and prevents command-generation errors.

No API key or external service required. Uses uvx 'scrapling[shell]' for ephemeral execution — no persistent installs.

When to Use

Performing web searches from within an agent workflow
Research tasks that need exact web search results shown to the user
Gathering search results as structured YAML

API Limitations

DuckDuckGo's HTML endpoint has inherent limitations:

First page only — only the top ~10 results are returned
No pagination — there are no additional pages or "next page" links
Top results only — deeper results are not accessible via this endpoint
These are the only results available — do not attempt to fetch more pages or suggest that more results exist

If more results are needed, reformulate the query with different keywords rather than attempting pagination.

Usage Examples

Basic Search

Run search.sh with a query:

bash scripts/search.sh "tangled group"

The script output is shown to the user exactly as produced — raw YAML:

- title: 'Tangled Group, Inc.'
  url: 'https://tangledgroup.com/'
  domain: 'tangledgroup.com'
  snippet: |
    We are a software development company...

- title: 'Tangled Group - LinkedIn'
  url: 'https://www.linkedin.com/company/tangled-group'
  domain: 'linkedin.com'
  snippet: |
    Software engineering services and consulting...

...

Core Concepts

YAML Output Format

Each result in the YAML output contains these fields (only present if available in the HTML):

title
url
domain
snippet

Dependencies

bash — shell scripting
uvx — ephemeral Python package execution (runs scrapling[shell])
python3 — query encoding and HTML-to-YAML formatting (builtins only: html.parser, re, sys, urllib.parse)

---name: websearchdescription: Searches DuckDuckGo via its HTML endpoint and outputs results as raw YAML. Uses a deterministic bash script, extracts search results, and prints exact YAML output.---# Web Search — DuckDuckGo to YAML## OverviewSearches DuckDuckGo via its HTML endpoint `https://html.duckduckgo.com/html/` and outputs results as raw YAML. Final output of skill is complete YAML shown to the user **exactly as produced — never summarized, never transformed**.A deterministic bash script handles all search execution — the agent always runs `bash scripts/search.sh <query>` and never constructs commands on the fly. This ensures consistent behavior and prevents command-generation errors.No API key or external service required. Uses `uvx 'scrapling[shell]'` for ephemeral execution — no persistent installs.## When to Use- Performing web searches from within an agent workflow- Research tasks that need exact web search results shown to the user- Gathering search results as structured YAML### API LimitationsDuckDuckGo's HTML endpoint has inherent limitations:- **First page only** — only the top ~10 results are returned- **No pagination** — there are no additional pages or "next page" links- **Top results only** — deeper results are not accessible via this endpoint- **These are the only results available** — do not attempt to fetch more pages or suggest that more results existIf more results are needed, reformulate the query with different keywords rather than attempting pagination.## Usage Examples### Basic SearchRun `search.sh` with a query:```bashbash scripts/search.sh "tangled group"```The script output is shown to the user exactly as produced — raw YAML:```yaml- title: 'Tangled Group, Inc.' url: 'https://tangledgroup.com/' domain: 'tangledgroup.com' snippet: | We are a software development company...- title: 'Tangled Group - LinkedIn' url: 'https://www.linkedin.com/company/tangled-group' domain: 'linkedin.com' snippet: | Software engineering services and consulting......```## Core Concepts### YAML Output FormatEach result in the YAML output contains these fields (only present if available in the HTML):- title- url- domain- snippet### Dependencies- **bash** — shell scripting- **uvx** — ephemeral Python package execution (runs `scrapling[shell]`)- **python3** — query encoding and HTML-to-YAML formatting (builtins only: `html.parser`, `re`, `sys`, `urllib.parse`)

Frequently asked questions

Websearch