原始内容
name: headed-fetcher description: ボット対策で保護されたページをPlaywrightのheadedブラウザで取得します。WebFetchが403エラーを返す場合や、Cloudflareチャレンジが表示される場合に使用してください。 license: MIT compatibility:
- uv
- playwright metadata: version: 1.0.0 author: drillan
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.