High-performance browser automation bridge and multi-instance orchestrator with advanced stealth injection and real-time dashboard.
update skill: add all env vars, batch actions, cookies, stealth endpoints, tabId tip
L29aa27111179
diff --git a/skill/pinchtab/SKILL.md b/skill/pinchtab/SKILL.mdindex d9436117..90cd8fc9 100644--- a/skill/pinchtab/SKILL.md+++ b/skill/pinchtab/SKILL.md@@ -20,10 +20,34 @@ metadata:description: "Bearer auth token for Pinchtab API"- name: BRIDGE_PORToptional: true- description: "HTTP port (default: 18800)"+ description: "HTTP port (default: 9867)"- name: BRIDGE_HEADLESSoptional: truedescription: "Run Chrome headless (true/false)"+ - name: BRIDGE_PROFILE+ optional: true+ description: "Chrome profile directory (default: ~/.pinchtab/chrome-profile)"+ - name: BRIDGE_STATE_DIR+ optional: true+ description: "State/session storage directory (default: ~/.pinchtab)"+ - name: BRIDGE_NO_RESTORE+ optional: true+ description: "Skip restoring tabs from previous session (true/false)"+ - name: BRIDGE_CHROME_VERSION+ optional: true+ description: "Chrome UA version string (default: 133.0.6943.98)"+ - name: BRIDGE_CONFIG+ optional: true+ description: "Path to config JSON file (default: ~/.pinchtab/config.json)"+ - name: BRIDGE_TIMEOUT+ optional: true+ description: "Action timeout in seconds (default: 15)"+ - name: BRIDGE_NAV_TIMEOUT+ optional: true+ description: "Navigation timeout in seconds (default: 30)"+ - name: CDP_URL+ optional: true+ description: "Connect to existing Chrome DevTools instead of launching"---# Pinchtab@@ -85,6 +109,12 @@ curl "http://localhost:9867/snapshot?diff=true"# Text format — indented tree, ~40-60% fewer tokens than JSONcurl "http://localhost:9867/snapshot?format=text"++# YAML format+curl "http://localhost:9867/snapshot?format=yaml"++# Write to file+curl "http://localhost:9867/snapshot?output=file&path=/tmp/snapshot.json"```Returns flat JSON array of nodes with `ref`, `role`, `name`, `depth`, `value`, `nodeId`.@@ -197,6 +227,40 @@ curl -X POST http://localhost:9867/tab \Multi-tab: pass `?tabId=TARGET_ID` to snapshot/screenshot/text, or `"tabId"` in POST body.+### Batch actions++```bash+# Execute multiple actions in sequence+curl -X POST http://localhost:9867/actions \+ -H 'Content-Type: application/json' \+ -d '[{"kind":"click","ref":"e3"},{"kind":"type","ref":"e3","text":"hello"},{"kind":"press","key":"Enter"}]'+```++### Cookies++```bash+# Get cookies for current page+curl http://localhost:9867/cookies++# Set cookies+curl -X POST http://localhost:9867/cookies \+ -H 'Content-Type: application/json' \+ -d '{"url":"https://example.com","cookies":[{"name":"session","value":"abc123"}]}'+```++### Stealth++```bash+# Check stealth status and score+curl http://localhost:9867/stealth/status++# Rotate browser fingerprint+curl -X POST http://localhost:9867/fingerprint/rotate \+ -H 'Content-Type: application/json' \+ -d '{"os":"windows"}'+# os: "windows", "mac", or omit for random+```+### Health check```bash@@ -226,12 +290,18 @@ curl http://localhost:9867/health| `BRIDGE_PROFILE` | `~/.pinchtab/chrome-profile` | Chrome profile dir || `BRIDGE_STATE_DIR` | `~/.pinchtab` | State/session storage || `BRIDGE_NO_RESTORE` | `false` | Skip tab restore on startup |+| `BRIDGE_CHROME_VERSION` | `133.0.6943.98` | Chrome UA version string |+| `BRIDGE_CONFIG` | `~/.pinchtab/config.json` | Path to config JSON file |+| `BRIDGE_TIMEOUT` | `15` | Action timeout (seconds) |+| `BRIDGE_NAV_TIMEOUT` | `30` | Navigation timeout (seconds) || `CDP_URL` | (none) | Connect to existing Chrome DevTools |## Tips+- **Always pass `tabId` explicitly** when working with multiple tabs — active tab tracking can be unreliable- Refs are stable between snapshot and actions — no need to re-snapshot before clicking- After navigation or major page changes, take a new snapshot to get fresh refs- Use `filter=interactive` by default, fall back to full snapshot when needed- Pinchtab persists sessions — tabs survive restarts (disable with `BRIDGE_NO_RESTORE=true`)- Chrome profile is persistent — cookies/logins carry over between runs+- Use `BRIDGE_CHROME_VERSION` to match your installed Chrome version for stealth consistency