How do I install the Web Fetch skill?

Run npx skillmds@latest add tomevault-io/web-fetch-2 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 Web Fetch safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Web Fetch?

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 Web Fetch free to use?

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

Who published Web Fetch?

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

Web Fetch by tomevault-io — Agent Skill

Name: Web Fetch
Author: tomevault-io

Web Fetch

Fetches web content as clean markdown by preferring markdown-native responses and falling back to selector-based HTML extraction. Use for documentation, articles, and reference pages at http/https URLs. Use when this capability is needed.

tomevault-io Updated Sep 17, 2026

File contents

Web Content Fetching

Fetch web content in this order:

Prefer markdown-native endpoints (content-type: text/markdown)
Use selector-based HTML extraction for known sites
Use the bundled Bun fallback script when selectors fail

Prerequisites

Verify required tools before extracting:

command -v curl >/dev/null || echo "curl is required"
command -v html2markdown >/dev/null || echo "html2markdown is required for HTML extraction"
command -v bun >/dev/null || echo "bun is required for fetch.ts fallback"

Install Bun dependencies for the bundled script:

cd ~/.claude/skills/web-fetch && bun install

Default Workflow

Use this as the default flow for any URL:

URL="<url>"
CONTENT_TYPE="$(curl -sIL "$URL" | awk -F': ' 'tolower($1)=="content-type"{print tolower($2)}' | tr -d '\r' | tail -1)"

if echo "$CONTENT_TYPE" | grep -q "markdown"; then
  curl -sL "$URL"
else
  curl -sL "$URL" \
    | html2markdown \
        --include-selector "article,main,[role=main]" \
        --exclude-selector "nav,header,footer,script,style"
fi

Known Site Selectors

Site	Include Selector	Exclude Selector
platform.claude.com	`#content-container`	-
docs.anthropic.com	`#content-container`	-
developer.mozilla.org	`article`	-
github.com (docs)	`article`	`nav,.sidebar`
Generic	`article,main,[role=main]`	`nav,header,footer,script,style`

Example:

curl -sL "<url>" \
  | html2markdown \
      --include-selector "#content-container" \
      --exclude-selector "nav,header,footer"

Finding the Right Selector

When a site isn't in the patterns list:

# Check what content containers exist
curl -s "<url>" | grep -o '<article[^>]*>\|<main[^>]*>\|id="[^"]*content[^"]*"' | head -10

# Test a selector
curl -sL "<url>" | html2markdown --include-selector "<selector>" | head -30

# Check line count
curl -sL "<url>" | html2markdown --include-selector "<selector>" | wc -l

Universal Fallback Script

When selectors produce poor output, run the bundled parser:

bun ~/.claude/skills/web-fetch/fetch.ts "<url>"

If already in the skill directory:

bun fetch.ts "<url>"

Options Reference

--include-selector "CSS"  # Keep only matching elements
--exclude-selector "CSS"  # Remove matching elements
--domain "https://..."    # Convert relative links to absolute

Troubleshooting

Empty output with selectors: The page might be markdown-native. Check headers first:

curl -sIL "<url>" | grep -i '^content-type:'

Wrong content selected: The site may have multiple article/main regions:

curl -s "<url>" | grep -o '<article[^>]*>'

html2markdown not found: Install it, then retry selector-based extraction.

bun or script deps missing: Run cd ~/.claude/skills/web-fetch && bun install.

Missing code blocks: Check if the site uses non-standard code formatting.

Client-rendered content: If HTML only has "Loading..." placeholders, the content is JS-rendered. Neither curl nor the Bun script can extract it; use browser-based tools.

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: web-fetch-2description: Fetches web content as clean markdown by preferring markdown-native responses and falling back to selector-based HTML extraction. Use for documentation, articles, and reference pages at http/https URLs. Use when this capability is needed.---# Web Content FetchingFetch web content in this order:1. Prefer markdown-native endpoints (`content-type: text/markdown`)2. Use selector-based HTML extraction for known sites3. Use the bundled Bun fallback script when selectors fail## PrerequisitesVerify required tools before extracting:```bashcommand -v curl >/dev/null || echo "curl is required"command -v html2markdown >/dev/null || echo "html2markdown is required for HTML extraction"command -v bun >/dev/null || echo "bun is required for fetch.ts fallback"```Install Bun dependencies for the bundled script:```bashcd ~/.claude/skills/web-fetch && bun install```## Default WorkflowUse this as the default flow for any URL:```bashURL="<url>"CONTENT_TYPE="$(curl -sIL "$URL" | awk -F': ' 'tolower($1)=="content-type"{print tolower($2)}' | tr -d '\r' | tail -1)"if echo "$CONTENT_TYPE" | grep -q "markdown"; then curl -sL "$URL"else curl -sL "$URL" \ | html2markdown \ --include-selector "article,main,[role=main]" \ --exclude-selector "nav,header,footer,script,style"fi```## Known Site Selectors| Site | Include Selector | Exclude Selector ||------|------------------|------------------|| platform.claude.com | `#content-container` | - || docs.anthropic.com | `#content-container` | - || developer.mozilla.org | `article` | - || github.com (docs) | `article` | `nav,.sidebar` || Generic | `article,main,[role=main]` | `nav,header,footer,script,style` |Example:```bashcurl -sL "<url>" \ | html2markdown \ --include-selector "#content-container" \ --exclude-selector "nav,header,footer"```## Finding the Right SelectorWhen a site isn't in the patterns list:```bash# Check what content containers existcurl -s "<url>" | grep -o '<article[^>]*>\|<main[^>]*>\|id="[^"]*content[^"]*"' | head -10# Test a selectorcurl -sL "<url>" | html2markdown --include-selector "<selector>" | head -30# Check line countcurl -sL "<url>" | html2markdown --include-selector "<selector>" | wc -l```## Universal Fallback ScriptWhen selectors produce poor output, run the bundled parser:```bashbun ~/.claude/skills/web-fetch/fetch.ts "<url>"```If already in the skill directory:```bashbun fetch.ts "<url>"```## Options Reference```bash--include-selector "CSS" # Keep only matching elements--exclude-selector "CSS" # Remove matching elements--domain "https://..." # Convert relative links to absolute```## Troubleshooting**Empty output with selectors**: The page might be markdown-native. Check headers first:```bashcurl -sIL "<url>" | grep -i '^content-type:'```**Wrong content selected**: The site may have multiple article/main regions:```bashcurl -s "<url>" | grep -o '<article[^>]*>'```**`html2markdown` not found**: Install it, then retry selector-based extraction.**`bun` or script deps missing**: Run `cd ~/.claude/skills/web-fetch && bun install`.**Missing code blocks**: Check if the site uses non-standard code formatting.**Client-rendered content**: If HTML only has "Loading..." placeholders, the content is JS-rendered. Neither curl nor the Bun script can extract it; use browser-based tools.---> Converted and distributed by [TomeVault](https://tomevault.io/claim/0xbigboss) — claim your Tome and manage your conversions.

Frequently asked questions