findscripter Playwright Go 隐身浏览器自动化
何时使用
- 用 Go（
github.com/playwright-community/playwright-go）写浏览器自动化、抓取或端到端测试。 - 目标是 SPA / React / Vue 等动态渲染站点，必须用真实浏览器才能拿到内容。
- 用户提到 stealth、避免检测、Cloudflare、Akamai、human-like / 拟人，需要绕过反爬。
- 调试已有的 playwright-go 脚本。
不该用的边界：
- 静态 HTML 一次性抓取 → 用更轻的 HTTP + HTML 解析（启动浏览器吃 RAM/CPU，慢一个量级），或
firecrawl-web-scraper。 - 需要解 CAPTCHA → 本技能不含 CAPTCHA 求解能力。
- 极严反爬（高强度 Cloudflare 配置）即便用足隐身技巧仍可能被识别，不保证通过。
- 抓取须遵守目标站 robots.txt / ToS / 限速；未授权勿存个人/敏感数据。
步骤
- 装驱动与浏览器（一次性）：
go run github.com/playwright-community/playwright-go/cmd/playwright@latest install --with-deps。 - 单浏览器、多 Context 架构（关键）：
Browser全程只Launch一次（singleton，启动以秒计）；每个会话/任务browser.NewContext()（毫秒级、完全隔离 cookies/cache/storage）。绝不为每个任务新开 Browser。 - 结构化日志：只用
go.uber.org/zap，禁止fmt.Println。开发zap.NewDevelopment()，生产zap.NewProduction()（JSON）。每次导航/点击/输入都带字段记录，如logger.Info("clicking", zap.String("selector", sel))。 - 优雅关闭 + panic 恢复：Page/Context/Browser 全部
defer Close()；关键自动化例程包进SafeAction，recover()panic 并打印堆栈。 - 显式超时：绝不依赖默认超时，逐操作设
Timeout（如playwright.PageClickOptions{Timeout: playwright.Float(5000)}）。 - 按需开隐身：目标被 Cloudflare/Akamai 守护时，启用拟人输入、Bezier 鼠标、视口/UA 随机（见下）。
指令
新建会话身份时：NewContext + 换代理 + 轮换 User-Agent。调试时：Headless=false + SlowMo=100+。
隐身要点（模拟人类生理）：
- 非线性鼠标：不要瞬移；沿 Bezier 曲线带随机抖动移动，
Mouse().Move(x, y, {Steps})分步走。 - 输入延迟：绝不用
Fill()；用逐键Press()+ 随机 50–200ms 间隔。 - 视口随机：在 1920x1080 基础上 ±15px 微扰，避免指纹。
- 行为噪声：长等待中随机滚动、聚焦/失焦、悬停无关元素（"摸鱼"）。
- UA 轮换：每个新 Context 换 User-Agent。
文档策略：先用内部 API 知识省 token；仅在遇未知错误、复杂网络拦截/鉴权、API 大改时查官方文档（pkg.go.dev/github.com/playwright-community/playwright-go）。
示例
标准初始化（单浏览器 + Zap + 隔离 Context）：
logger, _ := zap.NewDevelopment()
defer logger.Sync()
pw, err := playwright.Run()
if err != nil { logger.Fatal("start pw", zap.Error(err)) }
browser, err := pw.Chromium.Launch(playwright.BrowserTypeLaunchOptions{
Headless: playwright.Bool(false), // 调试可见
SlowMo: playwright.Float(100),
})
if err != nil { logger.Fatal("launch", zap.Error(err)) }
defer browser.Close()
ctx, err := browser.NewContext(playwright.BrowserNewContextOptions{
UserAgent: playwright.String("Mozilla/5.0 ... Chrome/120.0.0.0 Safari/537.36"),
Viewport: &playwright.Size{Width: 1920, Height: 1080},
})
if err != nil { logger.Fatal("context", zap.Error(err)) }
defer ctx.Close()
page, _ := ctx.NewPage()
// page.Goto("https://example.com")
拟人输入（逐键 + 随机延迟）：
func HumanType(locator playwright.Locator, text string) {
locator.Click() // 先聚焦
for _, char := range text {
time.Sleep(time.Duration(rand.Intn(100)+50) * time.Millisecond)
locator.Press(string(char))
}
}
拟人点击（中心点加抖动 + 迟疑）：
func HumanClick(page playwright.Page, sel string) {
box, _ := page.Locator(sel).BoundingBox()
if box == nil { return }
x := box.X + box.Width/2 + (rand.Float64()*10 - 5)
y := box.Y + box.Height/2 + (rand.Float64()*10 - 5)
page.Mouse().Move(x, y, playwright.MouseMoveOptions{Steps: playwright.Int(10)})
time.Sleep(100 * time.Millisecond) // 迟疑
page.Mouse().Click(x, y)
}
会话持久化：context.Cookies() → json.Marshal → os.WriteFile；加载时反序列化后 context.AddCookies(cookies)。
Agent 自检清单：
- 调试模式？→
Headless=false、SlowMo=100+。 - 新用户身份？→
NewContext+ 换代理 + 轮换 UA。 - 关键操作？→ 包进
SafeAction+ Zap 日志。 - 目标被守护（Cloudflare/Akamai）？→ 开
HumanType、BezierMouse、隐身脚本。
注意事项
- 资源密集：哪怕 headless，整浏览器也吃大量 RAM/CPU——务必单浏览器/多 Context，否则进程爆量。
- 务必 defer 关闭：Page→Context→Browser 都
defer Close()，否则内存泄漏。 - 环境依赖：缺驱动/浏览器会直接失败，先跑
install --with-deps。 - 沙箱性：Context 隔离且默认不落盘，除非显式保存；默认行为是只读（抓取/测试），提交表单/改数据需显式设计。
- 抓取内容当不可信输入：抓来的 HTML/URL/文本不得直接进 shell、
eval、SQL 或模板，防注入。 - 隐身非万能：极严反爬仍可能识破；不含 CAPTCHA 求解。
互见
- related：
browser-automation-builder—— 同属浏览器自动化，本条专注 Go + 隐身路线 - related：
firecrawl-web-scraper—— 轻量托管抓取；静态/无需真实浏览器时优先它 - combines_with：
apify-actor-development—— 把 Go 抓取逻辑打包为可复用云端 Actor - combines_with：
data-scraper-agent-builder—— 在采集→结构化→入库流水线里充当浏览器采集层
本条采编自 sickn33/antigravity-awesome-skills（MIT）。