pinchtab

name	pinchtab
description	Browser automation for AI agents via PinchTab HTTP API/CLI. Navigate, extract text, fill forms, click elements, scrape pages, take screenshots, export PDF, multi-tab. Token-efficient (~800 tokens/page), built-in stealth, persistent login sessions. Dùng khi user nhắc 'PinchTab', 'pinchtab', hoặc cần tự động hóa trình duyệt qua PinchTab cụ thể (khác agent-browser). Hỗ trợ: scraping, login automation, pagination, form filling, screenshot, PDF export, batch actions via macro endpoint.
allowed-tools	["Bash","Read"]

PinchTab — Browser Automation for AI Agents

Control Chrome browsers via PinchTab's CLI and HTTP API. Token-efficient (~800 tokens/page), fast startup, stable element references, built-in stealth.

Prerequisites

# Install (pick one)
curl -fsSL https://pinchtab.com/install.sh | bash
brew install pinchtab/tap/pinchtab
npm install -g pinchtab

# Start server (skip if already running)
pinchtab server &
curl -s http://localhost:9867/health

Core Concepts

Server → Profile (prof_XXX) → Instance (inst_XXX) → Tab (tab_XXX) → Element Refs (e0, e1, e5)

• Profile — Persistent browser data (cookies, storage). Reuse profiles to keep login sessions alive.
• Instance — Running Chrome process (max 1 per profile).
• Element Ref — Stable IDs from snapshots for clicking/filling. Re-snapshot after page changes because refs become stale.

Choosing the Right Approach

Situation	Approach