headed-fetcher

📁 drillan/headed-fetcher 📅 Jan 24, 2026
9
总安装量
7
周安装量
#32352
全站排名
安装命令
npx skills add https://github.com/drillan/headed-fetcher --skill headed-fetcher

Agent 安装分布

claude-code 7
opencode 4
codex 4
windsurf 2
cursor 2
github-copilot 2

Skill 文档

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.