Pinchtab Helper

控制并自动化操作浏览器，支持导航、快照、点击、输入、提交表单和截图，需预先安装并启动 PinchTab 服务。

PinchTab Browser Control 🖱️

让 AI 通过 PinchTab 控制浏览器的 Skill。

什么是 PinchTab?

PinchTab 是一个轻量级的浏览器控制工具，比传统的浏览器自动化更高效：

• Token 高效：800 tokens/page（比截图便宜 5-13 倍）
• 稳定性好：使用稳定的 accessibility refs
• 支持多实例：可同时运行多个浏览器实例

使用前提

1. 安装 PinchTab（需要先安装）：

   # macOS / Linux
   curl -fsSL https://pinchtab.com/install.sh | bash
   
   # 或 npm
   npm install -g pinchtab
   
   # 或 Docker
   docker run -d --name pinchtab -p 127.0.0.1:9867:9867 pinchtab/pinchtab
   

2. 启动服务：

   pinchtab &
   

核心操作

1. 导航到网页

pinchtab nav https://example.com

2. 获取页面快照

pinchtab snap -i -c
# -i: interactive 模式（可交互元素）
# -c: 显示点击引用

3. 点击元素（通过 ref）

pinchtab click e5

4. 输入文字

pinchtab fill e3 "搜索内容"

5. 提交表单

pinchtab press e7 Enter

6. 截图

pinchtab screenshot

完整示例

搜索任务

# 1. 打开 Google
pinchtab nav https://google.com

# 2. 获取页面
pinchtab snap -i -c

# 3. 在搜索框输入（假设 ref 是 e5）
pinchtab fill e5 "什么是 AI"

# 4. 按回车
pinchtab press e5 Enter

# 5. 获取结果
pinchtab snap -i -c

API 端点

如果直接用 HTTP：

• 基础 URL: http://localhost:9867
• 创建实例: POST /instances/launch
• 打开标签: POST /instances/{id}/tabs/open
• 快照: GET /tabs/{id}/snapshot
• 操作: POST /tabs/{id}/action

Skill 触发词

• 打开浏览器
• 浏览网页
• 搜索xxx
• 访问xxx网站
• 帮我操作浏览器
• 用 pinchtab

注意事项

1. 安全：PinchTab 默认只绑定 127.0.0.1
2. Profile：建议使用专门的自动化 profile
3. Token：如果需要远程访问，设置 BRIDGE_TOKEN

---

Made with ❤️ by 小溪