Scrapling 安装指南：3 条命令从 pip 到首次抓取请求
【免费下载链接】Scrapling🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev项目地址: https://gitcode.com/GitHub_Trending/sc/Scrapling
Scrapling 是一个自适应 Web Scraping 框架，从单条 HTTP 请求到整站并发爬取都能接管，还能直接绕过 Cloudflare Turnstile 这类反爬验证。它内置三种 Fetcher，各管一档难度：Fetcher走快速 HTTP 请求并伪装 Chrome 的 TLS 指纹；DynamicFetcher用 Playwright 驱动浏览器加载动态页面；StealthyFetcher隐身模式，专门对付复杂防护。这条教程用 3 条命令加 1 个验证脚本完成安装，全程约 5 分钟。
环境自查：2 分钟确认能装
| 检查项 | 要求 | 查看方式 |
|---|---|---|
| Python 版本 | 3.10 及以上（官方测试到 3.13） | python --version |
| pip | 任意较新版本 | pip --version |
| 操作系统 | Windows / macOS / Linux 均可 | 无需额外配置 |
⚠️ 最坑的一点先说清楚：
pip install scrapling只装了解析引擎，不含抓取依赖。只装完这一步就去 importscrapling.fetchers，会直接抛ModuleNotFoundError。第二章第 2 步就是补这个，别跳。
三步装完
第 1 步：核心包。
pip install scrapling这一步装好自适应解析引擎和命令行工具，lxml、orjson 等底层依赖会一起带上，不用你单独处理。此时解析能力可用，但还不能抓网页。
第 2 步：抓取依赖 + 浏览器（要抓页面就必做）。
pip install "scrapling[fetchers]" scrapling install第二条命令会下载 Chromium 浏览器及系统依赖，体积不小，建议网络好时执行。如果之前装过但环境报错，加参数强制重装：scrapling install --force。
第 3 步：按需加装 extras（可选）。
scrapling[shell]：交互式抓取 shell 和extract命令，不写代码也能在终端抓页面scrapling[ai]：MCP server，把抓取能力接入 AI 助手scrapling[rag]：搭建 RAG 系统的依赖scrapling[all]：一次装齐上面全部- 不想本地折腾的，也可以直接
docker pull pyd4vinci/scrapling，镜像自带所有 extras 和浏览器
装了任何 extras 之后，记得再跑一次scrapling install补全浏览器依赖。
验证安装：发一个真实请求
把下面代码存成verify.py，运行python verify.py：
from scrapling.fetchers import Fetcher page = Fetcher.get('https://example.com') print(page.status)输出200✅ 即安装成功。这一步同时完成了你的首次真实请求，返回的page是 Response 对象，可以直接接page.css(...)或page.xpath(...)取数据。
没成功的话，按这两条速查：
ModuleNotFoundError: ... scrapling.fetchers❌ → 漏了第 2 步，补跑pip install "scrapling[fetchers]"和scrapling install- 浏览器相关报错 → 跑一次
scrapling install --force重装浏览器
接下来去哪
Scrapling 的 Spider 框架支持并发抓取、断点续爬和代理轮换，整体结构长这样：
图中请求由 Crawler Engine 统一调度，Checkpoint 系统负责断点恢复，理解它之后再按目标往下走：
- 在三种 Fetcher 之间选型：docs/fetching/choosing.md
- 写第一个多页爬虫：docs/spiders/getting-started.md
- 不写代码、终端直接抓：docs/cli/overview.md
- 读懂 Selector 和自适应元素跟踪：docs/parsing/main_classes.md
装好了，去抓你的第一个页面吧。
【免费下载链接】Scrapling🕷️ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev项目地址: https://gitcode.com/GitHub_Trending/sc/Scrapling
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
)
