mcpField
W
web-content-fetcher

web-content-fetcher

github.com/shirenchuangProductivity6113.0k installsUpdated 31w ago
Repository

About web-content-fetcher

A skill that fetches a URL and extracts its main content as Markdown while preserving document structure. It selects between Scrapling and Jina Reader based on availability and site behavior, with explicit limits on retries.

Key features

  1. 01Extract page content as Markdown
  2. 02Choose fast or stealth fetching
  3. 03Route known domains to a fetch mode
  4. 04Limit output by character count
  5. 05Use Jina Reader as fallback
  6. 06Stop after one failed attempt

Use cases

  1. 01Convert an article URL into Markdown
  2. 02Fetch JavaScript-rendered pages
  3. 03Limit extracted text for context use

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/shirenchuang/web-content-fetcher --skill web-content-fetcher

After installing, type/web-content-fetcherin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

.gitignore
requirements.txt
README.md
scripts/
fetch.py

Details

From the project README

Web Content Fetcher

Given a URL, return its main content as clean Markdown — headings, links, images, lists, code blocks all preserved.

Extraction Strategy

Always try one method per URL — don't cascade blindly. Pick the right one upfront.

URL
 │
 ├─ 1. Scrapling script (preferred)
 │     Run fetch.py — check the domain routing table to decide fast vs --stealth.
 │     Works for most sites. Returns clean Markdown directly.
 │
 └─ 2. Jina Reader (fallback — only if Scrapling fails or dependencies not installed)
       web_fetch("https://r.jina.ai/<url>")
       Free tier: 200 req/day. Fast (~1-2s), good Markdown output.
       Does NOT work for: WeChat (403), some Chinese platforms.
Scrapling script
python3 <SKILL_DIR>/scripts/fetch.py "<url>" [max_chars] [--stealth]

<SKILL_DIR> is the directory where this SKILL.md lives. Resolve it before calling the script.

The script has two modes built in:

  • Default (fast): HTTP fetch, ~1-3s, works for most sites
  • --stealth: Headless browser, ~5-15s, for JS-rendered or anti-scraping sites

When run without --stealth, the script automatically falls back to stealth if the fast result has too little content. So you rarely need to specify --stealth manually — the only reason to force it is when you already know the site needs it (see routing table), which saves the initial fast attempt.

Domain Routing

Use this table to pick the right mode on the first call:

DomainCommandWhy
mp.weixin.qq.comfetch.py <url> --stealthJS-rendered content
zhuanlan.zhihu.comfetch.py <url> --stealthAnti-scraping + JS
juejin.cnfetch.py <url> --stealthJS-rendered SPA
sspai.comfetch.py <url>Static HTML
blog.csdn.netfetch.py <url>Static HTML
ruanyifeng.comfetch.py <url>Static blog
openai.comfetch.py <url>Static HTML
blog.googlefetch.py <url>Static HTML
Everything elsefetch.py <url>Auto-fallback handles it

Script Options

# Basic — auto-selects fast or stealth
python3 <SKILL_DIR>/scripts/fetch.py "https://sspai.com/post/73145"

# Force stealth for known JS-heavy sites
python3 <SKILL_DIR>/scripts/fetch.py "https://mp.weixin.qq.com/s/xxx" --stealth

# Limit output to 15000 characters (default: 30000)
python3 <SKILL_DIR>/scripts/fetch.py "https://example.com/article" 15000

# JSON output with metadata (url, mode, selector, content_length)
python3 <SKILL_DIR>/scripts/fetch.py "https://example.com" --json

Install Dependencies

First use only — the script checks and tells you if anything is missing:

pip install scrapling html2text

If on system-managed Python (macOS/Linux), add --break-system-packages or use a venv.

Failure Rules

  • Same URL fails once → give up, tell the user "unable to extract content from this URL"
  • Do not retry — each failed call wastes context tokens

Comments

Markdown supported