---

name: web-fetch description: Fetch and extract clean content from URLs using Jina Reader API. Use when users need to read webpage content, extract article text, or fetch URL content for analysis. Triggers on "fetch this page", "read this URL", "extract content from", "get the content of", "what does this page say".

Web Fetch

Overview

Extract clean, readable content from any URL using Jina Reader API. Returns raw JSON with title, content, and metadata optimized for LLM consumption.

When to Use

• User wants to read or analyze webpage content
• Need to extract article text from a URL
• Fetching documentation or reference pages
• Converting web pages to clean text for processing

Workflow

1. Identify the URL from user request
2. Validate URL format
3. Run the fetch script
4. Present extracted content to user

Usage

# Basic fetch
uv run --script scripts/web_fetch.py --url "https://example.com"

# With custom timeout
uv run --script scripts/web_fetch.py \
  --url "https://example.com/article" \
  --timeout 60

Parameters

Parameter	Default	Description
--url	(required)	URL to fetch and extract content from
--timeout	30	Request timeout in seconds

Output Contract

Scenario	stdout	stderr	exit code
Success	Raw JSON from Jina	(empty)	0
Invalid URL	(empty)	Error message	1
Timeout	(empty)	Timeout error	1
HTTP Error	(empty)	HTTP error details	1

Success output contains:

• Page title and description
• Clean extracted content (markdown-formatted)
• URL and metadata
• Token usage information

Prerequisites

• Uses Jina Reader API (no API key required)
• Requires uv for running PEP 723 scripts

Examples

Fetch a webpage

uv run --script scripts/web_fetch.py \
  --url "https://docs.python.org/3/whatsnew/3.12.html"

Fetch with longer timeout for slow pages

uv run --script scripts/web_fetch.py \
  --url "https://example.com/large-article" \
  --timeout 60