Snapgrab

Snapgrab

한국어 문서 · llms.txt

URL からメタデータ付きのスクリーンショットを取得します。Claude Vision に最適化されています。

from snapgrab import capture

result = await capture("https://example.com")
print(result.path)           # /tmp/snapgrab/example_com_desktop_20260317_120000.png
print(result.metadata.title) # "Example Domain"
print(result.vision_tokens)  # ~2764

特長

• スクリーンショットの取得 — PNG、JPEG、PDFに対応し、ページ全体をキャプチャできます
• ページのメタデータ — タイトル、説明、Open Graph タグ、ファビコン、HTTP ステータス
• Claude Vision に最適化 — 1568px に自動リサイズし、トークンコストを推定します
• ビューポートのプリセット — デスクトップ（1920x1080）、タブレット（768x1024）、モバイル（375x812）
• MCP サーバーを同梱 — Claude Code / MCP クライアント向けの3つのツール
• 要素のキャプチャ — 特定の CSS セレクターのスクリーンショットを撮影します
• ダークモード — ライト／ダークのカラースキームを強制します

インストール

pip install snapgrab

初回実行時に、Playwright ブラウザーのインストールを求められます。

playwright install chromium

使い方

Python API

import asyncio
from snapgrab import capture

async def main():
    # Basic screenshot
    result = await capture("https://example.com")

    # Mobile viewport, full page
    result = await capture("https://example.com", viewport="mobile", full_page=True)

    # Dark mode, JPEG format
    result = await capture("https://example.com", dark_mode=True, format="jpeg")

    # Specific element
    result = await capture("https://example.com", selector="#main-content")

    # Custom viewport
    result = await capture("https://example.com", viewport=(1440, 900))

asyncio.run(main())

CLI

snapgrab https://example.com                          # basic PNG
snapgrab https://example.com -v mobile -f             # mobile, full page
snapgrab https://example.com --format jpeg -q 90      # JPEG quality 90
snapgrab https://example.com -s "#hero" --dark-mode   # element + dark mode
snapgrab https://example.com -j                       # JSON output
snapgrab meta https://example.com                     # metadata only

MCP サーバー

pip install "snapgrab[mcp]"
snapgrab-mcp  # starts stdio MCP server

ツール：

• capture_screenshot — URL をメタデータとビジョントークンの推定値とともにキャプチャします
• capture_comparison — デスクトップとモバイル（または任意のビューポート）を比較します
• extract_page_metadata — スクリーンショットを撮らずにメタデータのみを抽出します

仕組み

flowchart LR
    A["🔗 URL"] --> B["Playwright\nlaunch browser"]
    B --> C["📸 Screenshot\nfull page / viewport"]
    C --> D["Resize for\nClaude Vision"]
    D --> E["✅ Image +\nMetadata"]

CaptureResult

result.path            # saved file path
result.format          # "png", "jpeg", "pdf"
result.width           # viewport width
result.height          # page height (full_page) or viewport height
result.file_size       # bytes
result.vision_tokens   # estimated Claude Vision token cost
result.vision_path     # path to Vision-optimized image (≤1568px)
result.processing_time_ms
result.metadata.title
result.metadata.description
result.metadata.og_title
result.metadata.og_image
result.metadata.favicon_url
result.metadata.status_code
result.metadata.url    # final URL after redirects

使用例

• watchdeck — ビジュアル差分と安全ガードを備えたウェブページ監視

ライセンス

MIT

---

_{QuartzUnit エコシステムの一部です — データ収集、抽出、検索、AI エージェントの安全性に対応する、組み合わせ可能な Python ライブラリ群です。}