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.