Camoufox Tools

Simplified CLI tools for camoufox anti-detection browser automation. Provides fox-open, fox-scrape, fox-eval, fox-close, and fox-bilibili-stats commands for...

Security Scan

The skill claims to install and expose multiple fox-* CLI tools for anti-detection browsing, but the package contains no command binaries — only an installer that only adds a bin directory to PATH — which is an incoherent and potentially risky omission.

Purpose & Capability

The SKILL.md promises commands (fox-open, fox-scrape, fox-eval, fox-close, fox-bilibili-stats) and 'one‑click install', but the archive only includes SKILL.md and an install.sh; there are no fox-* executables or scripts in the bundle. The installer simply adds $SKILL_DIR/bin to PATH and lists any executables found there. This is inconsistent: a user would reasonably expect the package to provide the mentioned CLI tools or to document where they come from.

Instruction Scope

Runtime instructions are limited to running the provided install.sh, optionally setting CAMOUFOX_PATH, and using the described commands. The SKILL.md references external dependencies (camoufox, agent-browser, openclaw CLI) which are outside this package — that is acceptable but should be explicit. There are no instructions that read unrelated system files or exfiltrate data. The stated use (anti-detection scraping) has legal/ethical implications but does not by itself indicate technical incoherence.

Install Mechanism

There is no formal install spec; install.sh is the only installer and it does not download or extract remote code. It modifies the user's shell RC (appending export PATH lines) which is a persistent change; this is expected for CLI tooling but should be visible to the user. Because no code is downloaded, install risk is lower, but the absence of the actual CLI scripts means the installer as provided is incomplete.

Credentials

The skill requests no environment variables or credentials. SKILL.md documents an optional CAMOUFOX_PATH env var (reasonable and optional). No secrets or unrelated credentials are requested.

Persistence & Privilege

The installer appends an export line to the user's shell RC to persist the PATH change — a modest persistence action but not unusual for CLI tool installs. The skill is not marked always:true and does not request elevated privileges or modify other skills' configs.

What to consider before installing

Do not install yet. The package advertises fox-* CLI tools but does not include those executables — this could be an incomplete upload or an attempt to rely on external fetchers not shown here. Before proceeding: (1) ask the publisher where the fox-* scripts/binaries are or request a complete package; (2) inspect any fox-* scripts that will be placed in the bin directory before adding them to your PATH; (3) note the installer will append to your shell RC — back up that file first; (4) be aware the tool is for anti-detection scraping (may violate site terms or laws); (5) if the publisher says the CLI is downloaded at runtime, request the download URLs and verify they are from trusted release hosts (GitHub releases or an official domain) before allowing execution.

🦊 封装 camoufox + agent-browser 的最佳实践，提供简化的命令行工具用于反检测浏览器自动化和数据抓取。

为什么需要这个 Skill？

• 反检测: camoufox 是基于 Firefox 的防指纹浏览器，能绕过 Bilibili 等网站的风控
• 简化命令: 隐藏复杂的 --executable-path 和 --headed 参数
• 最佳实践: 自动处理 close 规范，避免资源泄漏
• 即装即用: 一键安装，无需记忆长路径

安装

# 运行安装脚本，将工具添加到 PATH
cd ~/.openclaw/workspace/skills/camoufox-tools
./install.sh

# 或者手动添加到 PATH
export PATH="$HOME/.openclaw/workspace/skills/camoufox-tools/bin:$PATH"

环境变量

# 可选：自定义 camoufox 路径（默认: ~/.local/share/camoufox/camoufox）
export CAMOUFOX_PATH=/path/to/camoufox

工具列表

1. fox-open - 有头模式打开网页

使用 camoufox 有头模式打开指定网页。

fox-open "https://example.com"
fox-open "https://bilibili.com"

特性:

• 自动关闭之前的 browser 实例
• 自动使用 --headed 模式
• 自动填充 camoufox 路径

---

2. fox-scrape - 抓取页面内容

抓取网页内容，支持等待时间和 CSS 选择器。

# 基本用法
fox-scrape "https://example.com"

# 等待 5 秒后抓取
fox-scrape "https://example.com" --wait 5000

# 抓取特定元素
fox-scrape "https://example.com" --selector ".article-content"

# 短选项
fox-scrape "https://example.com" -w 5000 -s ".content"

选项:

• -w, --wait <ms> - 等待时间（毫秒，默认 3000）
• -s, --selector <sel> - CSS 选择器，提取特定元素

特性:

• 自动启动 browser（如未运行）
• 任务完成后自动关闭 browser

---

3. fox-eval - 执行 JavaScript

在当前页面执行 JavaScript 代码。

# 获取页面标题
fox-eval "document.title"

# 获取元素文本
fox-eval "document.querySelector('.like-btn').textContent"

# 获取多个元素
fox-eval "[...document.querySelectorAll('.stat')].map(e => e.textContent)"

注意: 需要先使用 fox-open 打开网页。

---

4. fox-close - 规范关闭

关闭所有 browser 实例，释放资源。

fox-close

建议: 在每个任务完成后执行，避免资源占用。

---

5. fox-bilibili-stats - 获取 B 站视频数据

获取 Bilibili 视频的统计数据。

fox-bilibili-stats "BV1NGZtBwELa"
fox-bilibili-stats "BV1xx411c7mD"

输出:

• 📺 视频标题
• ▶️ 播放量
• 👍 点赞数
• 🪙 投币数
• ⭐ 收藏数
• 📤 分享数
• 💬 弹幕数

特性:

• 自动处理 BV 号格式
• 自动启动和关闭 browser

---

典型工作流

工作流 1: 快速查看网页

fox-open "https://example.com"
# 查看完成后
fox-close

工作流 2: 抓取动态内容

fox-scrape "https://example.com" --wait 5000 --selector ".dynamic-content"

工作流 3: 交互式数据提取

# 打开页面
fox-open "https://example.com"

# 执行一些操作后提取数据
fox-eval "document.querySelector('.data').textContent"

# 关闭
fox-close

工作流 4: B 站视频数据分析

fox-bilibili-stats "BV1NGZtBwELa"

---

故障排除

Browser 无法启动

• 检查 camoufox 是否已安装: ls ~/.local/share/camoufox/camoufox
• 设置正确的路径: export CAMOUFOX_PATH=/path/to/camoufox

页面加载超时

• 增加等待时间: fox-scrape --wait 10000
• 检查网络连接

选择器找不到元素

• 使用 fox-open 打开页面后手动检查元素
• 使用 fox-eval 测试选择器: fox-eval "document.querySelector('.your-selector')"

---

依赖

• openclaw CLI
• camoufox (headless Firefox)
• agent-browser 扩展

---

许可证

MIT