Skip to content

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.md
index 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.md
index 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
```bash
diff --git a/skills/pinchtab/references/commands.md b/skills/pinchtab/references/commands.md
index 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 Commands
diff --git a/skills/pinchtab/references/mcp.md b/skills/pinchtab/references/mcp.md
index 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 |