SuperAPI AI 工具集

obscura

通用与其它

查看项目

更新于 10-16 07:22

技能介绍

用途:当任务需要无头浏览器、且指定以 Obscura(obscura CLI)为引擎时使用,可从命令行抓取或渲染需要 JavaScript 执行的页面。

主要能力:Obscura 基于 V8 运行真实 JavaScript,使用 Chrome DevTools Protocol,单个小体积二进制。支持 obscura fetch(读取单页文本、markdown、链接、取值、截图)、obscura scrape(对多 URL 执行同一表达式,含 worker 池)、obscura serve 配合 Playwright(多步操作、登录、E2E 测试)、obscura mcp(在 agent 内使用浏览器工具,属用户自行配置步骤)。

使用方式:先确认版本 obscura --version 2>&1 || echo "OBSCURA: NOT INSTALLED";不可用则运行依赖检查并停止。会话内首次命令前按工作流运行 check-deps.sh [--scrape] [--render] [--serve] [--playwright <project-dir>]。常用示例:obscura fetch <url> --quiet --dump markdown;obscura fetch <url> --quiet --eval "document.title";obscura scrape <url>... --quiet --eval "document.title"。Playwright 需通过 $CLAUDE_PLUGIN_ROOT/skills/obscura/scripts/with-obscura.sh --allow-private-network -- <command> 运行,并用 chromium.connectOverCDP(process.env.OBSCURA_CDP_URL) 连接,不可用 chromium.connect() 或 wsEndpoint。

限制与注意:本文数据基于 obscura 0.2.3 与 Playwright 1.63.0(macOS arm64,2026-10-01);其他版本以 --help 与 probe.mjs 实测为准。--eval 表达式抛错或多语句会打印 null 且退出 0;不 await Promise,异步需用 Playwright;输出非统一 JSON。--selector 只等待不缩小范围,超时仅警告并输出整页。HTTP 404 仍退出 0,仅导航失败退出 1;scrape 失败项为 error 字段而非非零退出。scrape 不读 stdin。--wait-until 取 domcontentloaded、load、networkidle2、networkidle0。默认阻止 localhost 与私有地址,需 --allow-private-network,但对外部输入 URL 不应开启,该限制是 SSRF 防护。--stealth 无法绕过登录墙、付费墙、CAPTCHA 或机器人挑战。未安装 Obscura 或 Playwright 包时未经询问不得自行安装,也不得改用自带 Chromium。仅在 Obscura 失败的测试应先在其他浏览器复跑,若通过则为引擎差异,不得改动应用或测试。像素基线与视觉回归测试不适用。