Scraplingとは｜HTML変更に自動追従するPythonスクレイピングの使い方

この記事ではClaude Codeに特化して解説します。Claude Code全般は Claude Code｜2026年版・インストールからCLAUDE.md・Hooks・本番運用までの実装手引き をご覧ください。

Scraplingとは——壊れないセレクタという発想

Scraplingは、Python向けのWebスクレイピングフレームワーク。HTTPリクエストからフルブラウザ自動化まで1つのライブラリで賄い、取得したページを共通のパーサAPIで扱う。

このライブラリの中心にあるのは adaptive という考え方である。通常のスクレイピングでは div.price > span のようなセレクタを書くが、サイトが改修されてクラス名やDOM階層が変わると一斉に壊れる。Scraplingは要素の特徴を記憶しておき、構造が変わったページでも同じ意味の要素を探し直す。保守コストの削減がこのライブラリの主たる価値である。

実測データ（2026-11-07 時点）

スターは 2026-08 時点の 73,873 から約 98.8k へ伸び、本日（11-07）も GitHub トレンド上位にいる。版も v0.4.14 から v0.5.1 へ上がり、後述の AI 連携（MCP サーバ・Agent Skill） が加わった。

4種のFetcherをどう選び分けるか

Scraplingの実務上の要点は「取得方法だけを差し替えられる」ことにある。パース側のコードは変えずに、対象サイトの防御レベルに応じてFetcherを選ぶ。

選定は上から順に試すのが定石である。Fetcher で本文が取れるならそれが最速で、ブラウザを起動する必要はない。取れない場合にのみ DynamicFetcher、それでもブロックされる場合に StealthyFetcher へ降りる。

導入方法と最小コード

pipからの直接インストール：

pip install scrapling
# ブラウザ系Fetcher（DynamicFetcher / StealthyFetcher）を使う場合は追加取得が必要
scrapling install

静的ページなら Fetcher だけで完結する。impersonate で実ブラウザのTLSフィンガープリントを装える。

from scrapling.fetchers import Fetcher, FetcherSession

with FetcherSession(impersonate='chrome') as session:
    page = session.get('https://quotes.toscrape.com/', stealthy_headers=True)
    quotes = page.css('.quote .text::text')
    print(quotes)

保護の強いサイトや動的ページでは Fetcher を差し替える。パース側（page.css(...)）は変えなくてよい点がこの設計の利点である。

from scrapling.fetchers import StealthyFetcher

# adaptive を有効化すると、HTML構造が変わっても要素を再特定する
StealthyFetcher.adaptive = True
page = StealthyFetcher.fetch(
    'https://example.com',
    headless=True,
    network_idle=True,
    solve_cloudflare=True,   # Turnstile / Interstitial を突破
)
print(page.css('h1::text'))

AI連携——MCPサーバとAgent Skill（v0.5〜）

v0.5 系で加わった2026年らしい特徴が、AIエージェントに Web データを渡す口を内蔵したことだ。Scrapling は MCP（Model Context Protocol）サーバ（scrapling-mcp）と Agent Skill を同梱し、server.json は PyPI と ghcr.io の両方を配布元として宣言している。

MCP サーバとして接続すると、ブラウザでの取得・抽出・スクリーンショットなどのツールをエージェントに公開できる。取得したページは page.markdown() で LLM 向けの Markdown に整えられ、「LLM をループに入れずに」コーパス化できるとドキュメントは述べる。注目はプロンプトインジェクション対策で、スクレイピング結果に紛れる隠し要素・コメント・ゼロ幅文字（＝人間に見えない指示）を除去してからエージェントへ渡すとしている（効果は未検証だが、設計として踏み込んでいる）。外から来るデータを信用しない、という発想はエージェント運用で無視できない。

競合との違い

Selenium / Playwright vs Scrapling：Selenium・Playwrightはブラウザの完全な自動操作に特化した「ドライバ」である。Scraplingはそれらを内部で使いつつ（DynamicFetcher は Playwright ベース）、取得とパースを1つのAPIに束ねる上位レイヤーにあたる。競合というより、Scraplingがブラウザ自動化を包含する関係にある。

Beautiful Soup vs Scrapling：Beautiful Soupはパース専用で、取得は requests 等に任せる。セレクタの手動指定が前提であり、サイト改修で壊れたら人手で直す。Scraplingは取得を内包し、かつ adaptive によりセレクタの再特定を自動化する点が異なる。

cloudscraper vs Scrapling：Cloudflare対策に絞ったモジュールがcloudscraper：CloudflareをバイパスするPythonモジュールである。Scraplingは StealthyFetcher として同種の機能を内蔵しているため、Scraplingを使うなら併用は基本的に不要になる。

こんな人におすすめ

・定期的にHTML構造が変わるサイトからのデータ抽出を続けたい開発者（adaptive の恩恵が最も大きい）
・静的ページと動的ページが混在し、取得方式を都度使い分けているPythonエンジニア
・Cloudflare配下のサイトに対し、複数ライブラリを組み合わせている運用を1本化したいチーム
・並行クロールにpause/resumeやプロキシローテーションを求めるデータ収集基盤の担当者

実装上の考慮点

Scraplingの導入時は、スクレイピング対象サイトの利用規約確認が必須。robots.txtの尊重やレート制限の実装で、対象サイトへの負荷軽減を意識すべきである。アンチボット突破機能を持つライブラリほど、法務・倫理面の確認を省略できない点は強調しておきたい。技術的に取得できることと、取得してよいことは別である。

パフォーマンスは非同期処理の活用で大幅に改善される。AsyncFetcher と async セッションを使った並列リクエスト処理は、大量URLのスクレイピング時に顕著な効果が出る。一方、StealthyFetcher はブラウザを起動するため最も遅い。全URLを一律ステルスで取りにいくのではなく、必要なドメインだけ降ろす設計が現実的である。

関連記事: Claude Code｜2026年版・インストールからCLAUDE.md・Hooks・本番運用までの実装手引き

参照ソース

• D4Vinci/Scrapling GitHub リポジトリ（スター約98.8k・v0.5.1・BSD-3-Clause を2026-11-07に再確認。clone して README/構成・version（pyproject 0.5.1）を実測）
• Scrapling 公式ドキュメント — MCP サーバ（MCP ツールとプロンプトインジェクション対策）
• Scrapling 公式ドキュメント — Choosing a Fetcher
• Playwright Python 公式ドキュメント