fetching-blocked-urls

name	fetching-blocked-urls
description	Retrieve clean markdown from URLs when web_fetch fails. Converts pages via Jina AI reader service with automatic retry. Use when web_fetch or curl returns 403, blocked, paywall, timeout, JavaScript-rendering errors, or empty content or user explicitly suggests using jina.
metadata	{"version":"0.1.1"}

Fetching Blocked URLs

Retrieve readable content from URLs that web_fetch cannot access. Jina AI's reader service renders JavaScript, bypasses soft blocks, and returns clean markdown.

Activation Triggers

Invoke this skill immediately when web_fetch returns:

• 403 Forbidden or access denied
• Paywall or login wall indicators
• Empty, garbled, or truncated content
• JavaScript-heavy SPA failures
• Timeout errors

Core Command

curl -s --max-time 30 "https://r.jina.ai/TARGET_URL"

The service returns markdown with page title, body text, and preserved links.

Retry Pattern

Jina's backend has ~10% intermittent failures. Use retry logic to achieve 99%+ success:

for attempt in 1 2 3; do
  result=$(curl -s --max-time 30 "https://r.jina.ai/TARGET_URL" 2>&1)
  echo "$result" | grep -q "upstream connect error" || { echo "$result"; break; }
  [ $attempt -lt 3 ] && sleep 1
done

Workflow Integration

1. Primary: Use web_fetch (native tool)
2. Fallback: This skill with retry when web_fetch fails
3. Escalate: Request user assistance only after retry exhaustion

Attempt this fallback before asking users to copy-paste content manually.

Output Format

Jina returns structured markdown:

• Title: page title
• URL Source: original URL
• Markdown Content: extracted body text, links preserved

Limitations

• Long pages may truncate
• Sites blocking all scrapers remain inaccessible
• Login-required content limited to public portions
• Real-time dynamic content may not render

Domain Access

r.jina.ai is whitelisted in Claude container network configuration.