High-performance browser automation bridge and multi-instance orchestrator with advanced stealth injection and real-time dashboard.
docs(skill): add network export to API, CLI, MCP, and agent references
Ariae33412d3efdf
diff --git a/skills/pinchtab/references/agent-optimization.md b/skills/pinchtab/references/agent-optimization.mdindex 6a527bfd..529b9409 100644--- a/skills/pinchtab/references/agent-optimization.md+++ b/skills/pinchtab/references/agent-optimization.md@@ -171,3 +171,4 @@ pinchtab nav <url> --block-images --timeout 60- **Scope snapshots.** Use `snap -s <selector>` to target a specific section of the page when you know where the element is.- **Prefer `fill` over `type` for framework forms.** Saves retries caused by React/Vue not detecting raw keystroke events.- **Check health before long workflows.** Run `pinchtab health` at the start of a multi-step task to fail fast if the server is down.+- **Export network traces after sessions.** `pinchtab network-export -o session.har` captures every request. For live capture: `pinchtab network-export --stream -o live.har`.diff --git a/skills/pinchtab/references/api.md b/skills/pinchtab/references/api.mdindex 1ba922c3..fa30c606 100644--- a/skills/pinchtab/references/api.md+++ b/skills/pinchtab/references/api.md@@ -378,6 +378,35 @@ Returns `solved: true, attempts: 0` when no challenge is detected — safe to ca**Stealth requirement:** Solvers work best with `stealthLevel: "full"`. Cloudflare checks browser fingerprints before and after the checkbox click. Verify stealth is active with `GET /stealth/status`.+## Network Export++```bash+# Export as HAR 1.2 (stream to response)+curl /network/export?format=har++# Export as NDJSON (one JSON per line)+curl /network/export?format=ndjson++# Save to server-side file+curl "/network/export?format=har&output=file&path=session.har"++# Include response bodies (10 MB cap per entry)+curl "/network/export?format=har&body=true"++# Include raw sensitive headers (Cookie, Authorization)+curl "/network/export?format=har&redact=false"++# Live streaming export (entries written to file as they arrive)+curl -N "/network/export/stream?format=ndjson&path=live.ndjson"++# Tab-scoped+curl /tabs/TAB_ID/network/export?format=har+```++All standard network filters apply: `filter`, `method`, `status`, `type`, `limit`.++Formats are pluggable. `GET /network/export?format=unknown` returns `{"available": ["har", "ndjson"]}`.+## Stealth```bashdiff --git a/skills/pinchtab/references/commands.md b/skills/pinchtab/references/commands.mdindex a4082af7..de9c403b 100644--- a/skills/pinchtab/references/commands.md+++ b/skills/pinchtab/references/commands.md@@ -164,6 +164,19 @@ pinchtab eval "document.querySelectorAll('a').length"> Requires `security.allowEvaluate: true` in config. Returns 403 by default.+### `pinchtab network-export`+Export captured network data in standard formats.++```bash+pinchtab network-export # HAR 1.2 to exports/+pinchtab network-export -o session.har # HAR to specific file+pinchtab network-export --format ndjson -o s.ndjson # NDJSON (one JSON per line)+pinchtab network-export --body # Include response bodies+pinchtab network-export --stream -o live.har # Live capture while browsing+```++Formats: `har` (Chrome DevTools compatible), `ndjson` (streamable). Sensitive headers redacted by default.+---## Fleet / Multi-Profile Commandsdiff --git a/skills/pinchtab/references/mcp.md b/skills/pinchtab/references/mcp.mdindex 307d53a2..ca481504 100644--- a/skills/pinchtab/references/mcp.md+++ b/skills/pinchtab/references/mcp.md@@ -108,6 +108,7 @@ All tool names are prefixed with `pinchtab_`.| `pinchtab_network` | List recent captured network requests. Optional: `tabId`, `filter`, `method`, `status`, `type`, `limit`, `bufferSize`. || `pinchtab_network_detail` | Get one request's details. Required: `requestId`. Optional: `tabId`, `body`. || `pinchtab_network_clear` | Clear captured network data. Optional: `tabId`. |+| `pinchtab_network_export` | Export captured data as HAR or NDJSON file. Optional: `tabId`, `format` (har/ndjson), `body`, `filter`, `method`, `status`, `type`, `limit`. Returns `{path, entries, format}`. |### Dialog| Tool | Description |