关于 stealth
此技能指导 AI Agent 诊断和处理网页访问中的反机器人拦截,按代理、CAPTCHA 求解和浏览器隐身分层给出建议。
主要功能
- 01诊断常见拦截症状
- 02通过住宅代理转发流量
- 03按验证类型选择 CAPTCHA 求解服务
- 04应用浏览器隐身技术
- 05检查地理位置限制
适用场景
- 01排查 403 或 429 响应
- 02处理网页访问中的 CAPTCHA 验证
- 03应对网站返回虚假内容
- 04检查按国家实施的服务限制
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ tapauth/ stealth --skill stealth安装后在 Claude Code 中输入/stealth确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/browser-stealth.mdcaptcha-setup.mdpolymarket-geoblock.mdproxy-setup.mdscripts/diagnose.py详细介绍
Stealth — AI Agent 反机器人检测
按顺序应用三个层级。大多数拦截都能在第 1 层解决。
快速诊断
先运行此命令,了解问题:
curl -s https://ipinfo.io/json | python3 -c "
import sys,json;d=json.load(sys.stdin)
org=d.get('org','')
h=d.get('privacy',{}).get('hosting') if 'privacy' in d else None
dc=h or any(x in org.lower() for x in ['digital','amazon','google','microsoft','azure','linode','vultr','hetzner','ovh','cloud'])
print(f'IP: {d[\"ip\"]} | Org: {org} | Datacenter: {dc}')
if dc: print('⚠️ Datacenter IP detected → Layer 1 (proxy) required')
else: print('✅ Residential IP — skip to Layer 2 or 3 if still blocked')
"
拦截类型参考
| 症状 | 原因 | 层级 |
|---|---|---|
| 403 Forbidden | IP/机器人拦截 | 1 |
| 429 Too Many Requests | 速率限制 | 1 |
| Cloudflare challenge | 机器人检测 | 1 + 3 |
| 出现 CAPTCHA | 验证关卡 | 2 |
| 返回 200,但内容错误 | 蜜罐/伪造数据 | 3 |
| 重定向循环 | Cookie/会话检测 | 3 |
第 1 层:住宅代理
首选解决方案。 Cloudflare、Akamai、PerimeterX 和大多数反机器人系统会立即标记数据中心 IP。住宅代理通过真实的 ISP 连接传输流量。
有关提供商对比和设置说明,请参阅 references/proxy-setup.md。
设置后快速测试:
curl -x http://USER:PASS@HOST:PORT -s https://ipinfo.io/json | python3 -c "
import sys,json;d=json.load(sys.stdin)
print(f'Proxy IP: {d[\"ip\"]} | Org: {d.get(\"org\")}')
"
Org 应显示 ISP(Comcast、Verizon、AT&T),而不是云服务提供商。
第 2 层:CAPTCHA 求解
切勿自行尝试解决 CAPTCHA。 你会失败、浪费令牌,并触发更高级别的验证。请始终使用 CAPTCHA 求解服务。
重要路由规则: 2Captcha 于 2025 年末彻底停止支持 hCaptcha。请使用 CapSolver 处理 hCaptcha。
| CAPTCHA 类型 | 提供商 |
|---|---|
| hCaptcha | 仅限 CapSolver |
| reCAPTCHA v2/v3 | 2Captcha 或 CapSolver |
| Cloudflare Turnstile | 两者均可 |
| 图片/文本 | 2Captcha |
有关提供商设置、API 集成代码和令牌注入,请参阅 references/captcha-setup.md。
第 3 层:隐身浏览器
代理单独使用不够时。 网站会通过 navigator 属性、WebGL、Canvas 和自动化标记对无头浏览器进行指纹识别。
有关 Playwright 隐身配置、请求头模板和反指纹识别,请参阅 references/browser-stealth.md。
地理封锁服务
有些服务会按国家/地区封锁访问,而不只是检测数据中心。加密货币/预测市场平台常见这种情况。
Polymarket 是最常见的案例,在美国、英国、法国、德国、意大利、澳大利亚及其他 25 个以上国家/地区遭到封锁。
有关完整的封锁国家/地区列表、检测方法、推荐代理国家/地区和特定提供商的定向语法,请参阅 references/polymarket-geoblock.md。
故障排除
| 问题 | 解决方法 |
|---|---|
| 使用代理后仍被拦截 | 通过 ipinfo.io 确认 IP 是住宅 IP。廉价提供商会转售数据中心 IP。 |
| CAPTCHA 求解器报错 | 求解器是否与 CAPTCHA 类型匹配?2Captcha 无法解决 hCaptcha。 |
| 网站提供伪造数据 | 添加隐身浏览器配置(第 3 层)。 |
| 响应缓慢 | 尝试使用距离目标网站所在区域更近的代理服务。 |
| 请求过多后被拦截 | 在代理控制面板中启用 IP 轮换。 |