headed-fetcher

WebページをPlaywrightで取得し、Markdown形式に変換するClaude Codeスキル。

When to Use

• WebFetchツールが403エラーを返す場合
• Cloudflareなどのボット対策が表示される場合
• JavaScriptを実行しないとコンテンツが表示されないサイト

Setup

./scripts/setup.sh

Usage

# 基本的な使用方法
uv run scripts/fetch.py https://example.com

# ファイルに出力
uv run scripts/fetch.py https://example.com -o output.md

# 特定要素のみを抽出
uv run scripts/fetch.py https://example.com --selector "article"

# ボット対策サイト用（headedモード）
uv run scripts/fetch.py https://protected-site.com --headed

Claude Code Integration

スキルがインストールされたディレクトリから実行する場合は、cdではなくuv run --directoryオプションを使用してください：

# 推奨: --directory オプションを使用
uv run --directory $SKILL_DIR scripts/fetch.py <URL> [options]

# 例（スキルが ~/.claude/skills/headed-fetcher にインストールされている場合）
uv run --directory ~/.claude/skills/headed-fetcher scripts/fetch.py https://example.com --headed

重要: cd $SKILL_DIR && uv run ... の形式は使用しないでください。

Options

| Option | Description | |--------|-------------| | -o FILE | ファイルに出力 | | --selector CSS | CSSセレクタで要素を抽出 | | --headed | headedモードで実行 | | --timeout N | タイムアウト秒数（デフォルト: 30） | | --wait-until | 待機条件（load/domcontentloaded/networkidle） | | --no-block-images | 画像読み込みを有効化 | | --no-block-fonts | フォント読み込みを有効化 | | --no-block-media | メディア読み込みを有効化 |

Output Format

---
url: https://example.com
title: Page Title
fetched_at: 2026-01-24T12:34:56Z
---

# Page Heading

Content in Markdown...

Exit Codes

| Code | Meaning | |------|---------| | 0 | Success | | 1 | Network error (timeout, DNS, connection) | | 2 | Selector not found | | 3 | Markdown conversion error |

Detailed Documentation

See references/REFERENCE.md for advanced usage and troubleshooting.