# Headed Fetcher

> ボット対策で保護されたページをPlaywrightのheadedブラウザで取得します。WebFetchが403エラーを返す場合や、Cloudflareチャレンジが表示される場合に使用してください。

- Skill: `drillan/headed-fetcher` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add drillan/headed-fetcher`
- Raw SKILL.md: https://api.skillmd.com/api/skills/drillan/headed-fetcher/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: MIT
- Author: drillan (https://skillmd.com/u/drillan)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/drillan/headed-fetcher

---


# headed-fetcher

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

## When to Use

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

## Setup

```bash
./scripts/setup.sh
```

## Usage

```bash
# 基本的な使用方法
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`オプションを使用してください：

```bash
# 推奨: --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

```yaml
---
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](references/REFERENCE.md) for advanced usage and troubleshooting.