agent-skill/Scrapling-Skill/examples/README.md

Scrapling Examples

These examples scrape quotes.toscrape.com — a safe, purpose-built scraping sandbox — and demonstrate every tool available in Scrapling, from plain HTTP to full browser automation and spiders.

All examples collect all 100 quotes across 10 pages.

Quick Start

Make sure Scrapling is installed:

pip install "scrapling[all]>=0.4.2"
scrapling install --force

Examples

File	Tool	Type	Best For
01_fetcher_session.py	FetcherSession	Python — persistent HTTP	APIs, fast multi-page scraping
02_dynamic_session.py	DynamicSession	Python — browser automation	Dynamic/SPA pages
03_stealthy_session.py	StealthySession	Python — stealth browser	Cloudflare, fingerprint bypass
04_spider.py	Spider	Python — auto-crawling	Multi-page crawls, full-site scraping

Running

Python scripts:

python examples/01_fetcher_session.py
python examples/02_dynamic_session.py  # Opens a visible browser
python examples/03_stealthy_session.py # Opens a visible stealth browser
python examples/04_spider.py           # Auto-crawls all pages, exports quotes.json

Escalation Guide

Start with the fastest, lightest option and escalate only if needed:

get / FetcherSession
  └─ If JS required → fetch / DynamicSession
       └─ If blocked → stealthy-fetch / StealthySession
            └─ If multi-page → Spider