PinchTab

这个 Agent 能做什么，适合哪些场景？

PinchTab 是一个用 Go 编写的独立 HTTP 服务器，把本地 Chrome 变成 AI 代理可直接调用的浏览器控制面。它由 server、实例（每个对应一个 Chrome 进程）、profile（保存 cookies、历史和本地存储）以及轻量 bridge 运行时组成，支持多实例并行、无头/有头模式、外部 Chrome attach 与可选的 CloakBrowser 隐身支持。默认监听 127.0.0.1:9867，以用户级 daemon 方式在后台常驻，提供 CLI 与 HTTP API 两种调用方式，并通过活动元素引用（如 e5）实现高 token 效率的页面快照与文本提取。它还内置站点审计与版本视觉对比命令，可用于 CI 门禁。默认安全姿态为本地优先：敏感端点族与 attach 默认关闭，IDPI 仅允许本地网站白名单，远程或分布式部署需要操作者自行负责令牌、网络边界与 TLS。

PinchTab 以 server-first 模型运行：pinchtab daemon install 或 pinchtab server 启动控制面，服务器管理 profile 与 Chrome 实例，每个实例背后由 pinchtab bridge 管理单个浏览器进程。代理可通过 CLI（pinchtab nav、pinchtab snap -i -c、pinchtab click e5、pinchtab text、pinchtab fill、pinchtab press）或 HTTP API 操作：先 POST /profiles 创建 profile，再 POST /instances/start 启动无头/有头实例，然后 POST /instances/{id}/tabs/open 打开标签页，GET /tabs/{tabId}/snapshot?filter=interactive 获取快照，POST /tabs/{tabId}/action 执行点击等动作。此外 pinchtab audit 可输出 report.json 与截图并覆盖控制台错误、可访问性评分、Core Web Vitals 与安全发现，pinchtab compare 支持 --fail-on-diff 作为发布前门禁。

1. AI 代理开发者：希望代理在本地以低 token 成本浏览网页、抓取结构化内容并点击表单，而不直接暴露浏览器给模型。
2. 需要登录态自动化的团队：为工作账号创建带认证信息的 profile，让代理自动选择正确 profile 下载周报。
3. QA 与测试团队：在 CI 中用 pinchtab audit 检查站点截图、控制台错误与 Core Web Vitals，并用 pinchtab compare --fail-on-diff 阻断有视觉回归的发布。
4. 多任务爬取场景：通过多实例并行运行隔离的 Chrome 进程，为不同 profile 分配不同浏览任务。
5. Raspberry Pi 或 ARM64 设备用户：利用 ARM64 优化和自动 Chromium 检测，在边缘设备上运行本地浏览器控制面。
6. 需要更强隔离的本地自动化：用 Docker 容器运行 PinchTab，在沙箱中执行代理浏览任务。

如何安装或部署这个 Agent？

macOS/Linux 可用安装脚本或 Homebrew，也可通过 npm 全局安装：

curl -fsSL https://pinchtab.com/install.sh | bash

brew install pinchtab/tap/pinchtab

npm install -g pinchtab

Docker 方式需要本机已有 Chrome/Chromium 或使用镜像内的浏览器：

docker run -d \
  --name pinchtab \
  -p 127.0.0.1:9867:9867 \
  -v pinchtab-data:/data \
  --shm-size=2g \
  pinchtab/pinchtab

从源码构建需要 Go 1.26+：

git clone https://github.com/pinchtab/pinchtab.git
cd pinchtab
./dev doctor
go build ./cmd/pinchtab

如何使用这个 Agent？

推荐先安装并启动用户级 daemon，再让代理指向 http://localhost:9867：

pinchtab daemon install
pinchtab daemon

首次可直接用 CLI 驱动浏览器：

pinchtab nav https://pinchtab.com --snap
pinchtab snap -i -c
pinchtab click e5
pinchtab text

HTTP API 需要服务端令牌，每个请求都要带上：

export PINCHTAB_TOKEN=$(pinchtab config token --stdout)

PROF=$(curl -s -X POST http://localhost:9867/profiles \
  -H "Authorization: Bearer $PINCHTAB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"name":"work"}' | jq -r '.id')

INST=$(curl -s -X POST http://localhost:9867/instances/start \
  -H "Authorization: Bearer $PINCHTAB_TOKEN" \
  -H "Content-Type: application/json" \
  -d "{\"profileId\":\"$PROF\",\"mode\":\"headless\"}" | jq -r '.id')

TAB=$(curl -s -X POST http://localhost:9867/instances/$INST/tabs/open \
  -H "Authorization: Bearer $PINCHTAB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://pinchtab.com"}' | jq -r '.tabId')

curl -H "Authorization: Bearer $PINCHTAB_TOKEN" "http://localhost:9867/tabs/$TAB/snapshot?filter=interactive"

站点审计与视觉对比：

pinchtab audit https://example.com --output-dir ./audit
pinchtab compare https://example.com https://staging.example.com --fail-on-diff

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

常见问题