web-fetch

name	web-fetch
description	Fetch a web page or HTTP(S) URL and read it as text/Markdown. Use when you need the full content of a URL — e.g. a search result from web_search, a changelog, docs, or an API response.

Fetching web pages

There is no web_fetch tool on purpose: fetching runs through bash so it inherits the active environment and proxy configuration.

HTML pages → Markdown

Pipe curl into trafilatura to extract the article/body text as Markdown:

curl -sSL --compressed -A "Mozilla/5.0" 'https://example.com/article' \
  | trafilatura --markdown

Notes:

• Quote the URL (single quotes) so query strings with &/? aren't mangled.
• -sSL is silent + show-errors + follow-redirects; --compressed handles gzip.
• The -A browser user-agent avoids some naive bot blocks.
• Use trafilatura --markdown --links when preserving links matters.
• For long pages, pipe through head -c <bytes> or sed -n '1,400p' rather than dumping the whole thing into context.

Noisy pages / DOM-specific extraction

For pages where trafilatura grabs navigation/sidebar text or misses content (e.g. social sites, forums, old Reddit comments), fall back to targeted DOM parsing with Beautiful Soup:

page=$(mktemp)
curl -sSL --compressed -A 'pi-coding-agent:web-fetch:v0.1 (contact: gsfontes.com)' \
  'https://old.reddit.com/r/linux/comments/example/' > "$page"

# Use the nix-shell skill's "Python with packages" pattern to run this with
# beautifulsoup4 available.
python3 - "$page" <<'PY'
import sys
from bs4 import BeautifulSoup

soup = BeautifulSoup(open(sys.argv[1], encoding="utf-8", errors="ignore"), "html.parser")

for item in soup.select(".usertext-body .md")[:10]:
    print(item.get_text(" ", strip=True))
    print("---")
PY

Notes:

• Prefer this when you know the selector you want (article, .comment, .entry-content, .usertext-body .md, etc.).
• Use a descriptive user-agent for sites that reject generic browser/script UAs.
• If the page offers JSON, RSS, Atom, or a public API, that is usually cleaner than scraping HTML.

Raw bodies (JSON / APIs / plain text)

Skip pandoc — fetch directly and parse as needed:

curl -sSL 'https://api.example.com/thing' | jq .      # JSON
curl -sSL 'https://example.com/raw.txt'                # plain text

Tips

• If a fetch returns an anti-bot landing page or a 40x/429, don't hammer it — report what came back.
• To find a URL in the first place, use the web_search tool, then fetch the result you want with the commands above.
• trafilatura can target other formats (--txt, --json, --html) if Markdown output is noisy for a given page.