BrowseCraft Skill
Installation Prerequisites
- 1. Install CLI: INLINECODE0
- Verify install: INLINECODE1
- Optional (RoxyBrowser only): configure your Roxy API endpoint and token in local env/config.
If the CLI is missing, stop and ask the user to install it first. Do not assume local package scripts are available.
Recommended Flow
- 1. Check status: INLINECODE2
- Start browser if needed: INLINECODE3
- Open target page: INLINECODE4
- Capture snapshot: INLINECODE5
- Prefer
click-ref / fill-ref for stable interactions - Re-snapshot after page transitions
- Capture result evidence: INLINECODE8
Backend Strategy
- - RoxyBrowser: INLINECODE9
- Camoufox:
browsecraft start --type camoufox (optional --camoufox-path) - Existing endpoint: INLINECODE12
Credential & Scope Policy
- - Roxy credentials are optional and only needed when the user explicitly chooses RoxyBrowser.
- Prefer environment variables over CLI token flags. Avoid printing or echoing secrets.
- Never send credentials or page data to third-party endpoints unless the user explicitly requests it.
- If a step needs network access outside the target website, ask for confirmation first.
Stability Rules
- - If element lookup fails: refresh with
snapshot, then retry. - If page is unstable: use
wait-for before interaction. - Always return structured output: objective / steps / result / failure reason / next action.
BrowseCraft 技能
安装前提
- 1. 安装CLI：npm install -g browsecraft-cli
- 验证安装：browsecraft --help
- 可选（仅限RoxyBrowser）：在本地环境/配置中配置Roxy API端点与令牌。
若CLI缺失，请停止操作并提示用户先安装CLI。请勿假定本地包脚本可用。
推荐流程
- 1. 检查状态：browsecraft status
- 按需启动浏览器：browsecraft start
- 打开目标页面：browsecraft open
- 捕获快照：browsecraft snapshot
- 优先使用click-ref/fill-ref实现稳定交互
- 页面跳转后重新捕获快照
- 捕获结果证据：browsecraft screenshot
后端策略
- - RoxyBrowser：browsecraft start --type roxy --roxy-window-id ...
- Camoufox：browsecraft start --type camoufox（可选参数--camoufox-path）
- 现有端点：browsecraft connect --type
凭证与范围策略
- - Roxy凭证为可选配置，仅在用户明确选择RoxyBrowser时需要。
- 优先使用环境变量而非CLI令牌标志。避免打印或回显敏感信息。
- 除非用户明确请求，否则不得将凭证或页面数据发送至第三方端点。
- 若某步骤需要访问目标网站外的网络资源，请先请求用户确认。
稳定性规则
- - 若元素查找失败：通过snapshot刷新页面，然后重试。
- 若页面不稳定：在交互前使用wait-for。
- 始终返回结构化输出：目标/步骤/结果/失败原因/下一步操作。
