Web Fetch with Linkup

Fetch clean web content via the Linkup API using a standalone Python script.

Prerequisites

A .env file in the skill directory (.claude/skills/web-fetch-linkup/.env) with:

LINKUP_API_KEY=your_api_key_here

See .env.example for the template.

Workflow

Step 1: Collect the URL

Get the URL from the user via AskUserQuestion or directly if provided in the request.

Step 2: Fetch the content

Run the script using Bash:

python3 .claude/skills/web-fetch-linkup/fetch.py "<URL>"

Options:

Examples:

# Standard fetch (JS rendering enabled)
python3 .claude/skills/web-fetch-linkup/fetch.py "https://example.com/article"

# Static page, faster
python3 .claude/skills/web-fetch-linkup/fetch.py "https://example.com" --no-render-js

# With images
python3 .claude/skills/web-fetch-linkup/fetch.py "https://example.com" --extract-images

Step 3: Parse the response

The script outputs JSON on stdout with:

• url — The fetched URL
• markdown — The extracted content in Markdown format
• images — (only with --extract-images) List of image URLs
• rawHtml — (only with --include-raw-html) Raw HTML source

Step 4: Save the content

Create a file in fetched-content/ with the format:

Filename: {domain}-{YYYYMMDD-HHmmss}.md

Structure:

---
source: <URL>
fetched_at: <ISO timestamp>
---

# <Title inferred from content>

<Extracted markdown content>

Step 5: Confirm

Inform the user of the created file path.

Exit codes

Error handling

Usage examples

Fetch an article:

“Fetch the content of https://example.com/article“

Fetch documentation:

“Use linkup to scrape https://docs.example.com/api“

Dynamic page:

“Extract content from this React page: https://app.example.com/dashboard“