Resource Map

基准路径: .claude/skills/scraping-specialist/references/domains/scrapling/

scrapling/
├── assets/
│   └── templates/
│       ├── basic_fetch.py
│       ├── parse_only.py
│       ├── session_login.py
│       └── stealth_cloudflare.py
├── references/
│   ├── api-quick-ref.md
│   ├── cli-quick-ref.md
│   ├── site-patterns.md
│   └── troubleshooting.md
├── requirements.txt
└── SKILL.md

Scrapling 抓取与反爬路线

此技能用于明确要走 scrapling 生态的场景，尤其适合“要快速写出 Python 抓取脚本”且目标站点可能存在反爬或登录态要求的任务。

先做环境检查

pip show scrapling

如果未安装，执行：

pip install "scrapling[fetchers]"
scrapling install

先选 Fetcher，再写脚本

不要直接盲写脚本。先按站点特征选路线：

• 已有 HTML，只需解析：用 Selector
• 静态页面、无明显反爬：用 Fetcher
• 需要 HTTP 表单登录并保留会话：用 FetcherSession
• 有 Cloudflare / WAF：优先 StealthyFetcher
• JS 渲染或 SPA：用 DynamicFetcher
• 不确定：先 Fetcher，失败后再升级到 StealthyFetcher 或 DynamicFetcher

推荐工作流

1. 先读取 API 速查 确认 fetcher 参数。
2. 再查 站点模式经验库，看目标站点是否已有经验。
3. 如果只想快速命令行试抓，读取 CLI 速查。
4. 生成脚本时，优先复用 assets/templates/ 下的模板。
5. 运行失败时，读取 故障排查。

模板位置

• assets/templates/basic_fetch.py
• assets/templates/parse_only.py
• assets/templates/session_login.py
• assets/templates/stealth_cloudflare.py

使用规则

• 目标是产出能直接运行的 Python 脚本，而不是只给碎片代码。
• 浏览器型 fetcher 的 cookie 必须使用 list[dict] 格式。
• 不要把用户真实 cookie 或 token 写回仓库，只能临时本地使用。