pinchtab

name: pinchtab description: Use Pinchtab to control a browser through the unified pinchtab tool for navigation, snapshots, clicks, typing, readable text extraction, screenshots, JavaScript evaluation, PDF export, and tab management.

Pinchtab 技能

用 Pinchtab 控制浏览器，Token 效率提升 5-13 倍！

前置条件

1. Pinchtab 服务器正在运行（默认端口 9867）
2. 如果有认证 token，设置环境变量 PINCHTAB_TOKEN

快速开始

1. 启动 Pinchtab 服务器

# 方式1：直接运行
pinchtab

# 方式2：带认证
PINCHTAB_TOKEN=my-secret pinchtab

# 方式3：Docker
docker run -d -p 9867:9867 pinchtab/pinchtab

2. 使用技能

这个技能提供以下工具：

• pinchtab - 统一的浏览器控制工具

工具使用

pinchtab - 统一浏览器控制

支持的 actions：

使用示例

示例1：搜索并提取结果

# 1. 导航到搜索页
pinchtab(action="navigate", url="https://example.com/search")

# 2. 获取可交互元素
pinchtab(action="snapshot", filter="interactive", format="compact")

# 3. 点击搜索框（ref 从 snapshot 获取）
pinchtab(action="click", ref="e5")

# 4. 输入搜索词
pinchtab(action="type", ref="e5", text="pinchtab")

# 5. 按回车搜索
pinchtab(action="press", key="Enter")

# 6. 只获取变化（节省 Token）
pinchtab(action="snapshot", diff=True, format="compact")

# 7. 提取文本结果（约 800 tokens）
pinchtab(action="text")

示例2：Token 策略

最省 Token 的组合：

• 阅读内容：用 text action
• 交互操作：用 snapshot + filter=interactive&format=compact
• 后续快照：用 diff=True
• 视觉验证：最后才用 screenshot

配置

环境变量：

安全注意事项

• evaluate action 可以执行任意 JavaScript，仅限信任的 agent 和域名
• 生产环境建议使用 PINCHTAB_TOKEN 保护 API
• 生产环境建议使用 HTTPS 反向代理（Caddy/nginx）

相关资源

• 官方文档：https://pinchtab.com/docs
• GitHub：https://github.com/pinchtab/pinchtab