# Khaos Browser Operations

> Operational guide for the Khaos headless browser MCP tools — when to use each tool, operation reference for khaos_browser_inspect and khaos_browser_hook, and pentest-stage sequences for client-side recon and interaction testing

- Skill: `henriqqw/khaos-browser-operations` (Agent Skill)
- Install (CLI): `npx get-skill add henriqqw/khaos-browser-operations`
- Raw SKILL.md: https://api.skillmd.com/api/skills/henriqqw/khaos-browser-operations/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: henriqqw (https://skillmd.com/u/henriqqw)
- Updated: 2026-11-18
- Page: https://skillmd.com/skills/henriqqw/khaos-browser-operations

---


# Khaos Browser Operations

As ferramentas de browser fornecem uma sessão Chromium isolada por assessment, restrita ao escopo de URLs declarado no target. Use-as quando ferramentas HTTP puras (`khaos_http_request`, `khaos_authenticated_read_probe`) não conseguem observar o DOM renderizado, rotas SPA, estado JavaScript ou chamadas de rede que só disparam após interação do usuário. Não use o browser como cliente HTTP genérico — use `khaos_http_request` para chamadas de API direta onde execução de JS não é necessária.

A sessão é criada na primeira chamada e tem TTL de 15 minutos de inatividade. Uma navegação a URL fora do escopo encerra a sessão com erro.

## Referência de Tools

| Tool | Parâmetros obrigatórios | Retorna | Quando usar |
|---|---|---|---|
| `khaos_browser_navigate` | `assessment_id`, `target_url` | URL final, page title | Iniciar sessão, seguir redirecionamentos, confirmar estado pós-login |
| `khaos_browser_fill` | `assessment_id`, `selector`, `value` | status, selector | Preencher campos de formulário, injetar payloads em inputs |
| `khaos_browser_click` | `assessment_id`, `selector` | status, clicked | Submeter formulários, acionar links e botões |
| `khaos_browser_screenshot` | `assessment_id` | screenshot_b64 (PNG) | Capturar evidência de estado visual da página |
| `khaos_browser_cookie_metadata` | `assessment_id` | cookie_names, count | Verificar presença de cookies de sessão; analisar nomes (não valores) |
| `khaos_browser_inspect` | `assessment_id`, `operation` | resultado da operação | Leitura de DOM: source, form fields, scripts, HTMX bindings |
| `khaos_browser_hook` | `assessment_id`, `action` | resultado do hook | Interceptar fetch/XHR para mapear chamadas de rede client-side |
| `khaos_browser_close` | `assessment_id` | status | Liberar sessão explicitamente ao final do fluxo |

## khaos_browser_inspect — Referência de Operações

Todas as operações são leituras puras sem mutação do estado da página.

| Operação | Retorna | Tamanho típico | Uso em pentest |
|---|---|---|---|
| `page_title` | String | curto | Confirmar que o target renderizou; detectar estados de loading de SPA |
| `location` | URL atual | curto | Detectar redirecionamentos pós-login; confirmar escopo após navegação |
| `visible_text` | innerText do body | ≤32 KB | Buscar strings sensíveis, mensagens de debug, tokens expostos em texto |
| `form_fields` | Array `{tag, name, type, required}` | variável | Mapear campos hidden, tokens CSRF, nomes de parâmetros para fuzzing |
| `page_source` | outerHTML completo | ≤64 KB | Análise estática do HTML renderizado; encontrar endpoints não visíveis ao katana |
| `htmx_endpoints` | Array de objetos com atributos `hx-*` | ≤500 entradas | Enumerar todos os targets `hx-get/post/put/patch/delete` — alimentar `khaos-htmx-security` |
| `inline_scripts` | Array com conteúdo de cada `<script>` inline | ≤20 blocos × 4 KB | Extrair URLs de API base, padrões de token, objetos de config — alimentar `khaos-javascript-api` |
| `external_scripts` | Array de URLs `src` | variável | Identificar bundles de terceiros, scripts CDN, candidatos a source maps |

## khaos_browser_hook — Lifecycle

`khaos_browser_hook` opera em duas etapas com dependência de ordem:

1. **install** — injeta interceptores `fetch` e `XMLHttpRequest` no `window` da página atual. Retorna `"installed"` ou `"already_installed"` se já estava ativo. Deve ser chamado *após* `khaos_browser_navigate` e *antes* das interações que se quer capturar.

2. **collect** — retorna um array de requests capturados desde o `install`. Cada entrada tem: `url`, `method`, `body` (≤512 bytes), `via` (`fetch` ou `xhr`), `ts` (timestamp).

**Importante:** os hooks são escopados à página atual. Uma navegação para uma nova origem (`khaos_browser_navigate` para URL diferente) reseta os interceptores — chame `install` novamente após a navegação. Chamar `collect` sem `install` retorna array vazio.

**Uso pós-collect:** cruze as URLs coletadas com `khaos_endpoint_id` para obter `observed_endpoint_ids` e use-os em `khaos_http_request` para replay direto com controle total de headers e body.

## Sequências por Stage

### Surface Mapping (enumeration)

Mapear a superfície client-side renderizada antes de fuzzing ativo.

```
khaos_browser_navigate → URL alvo
khaos_browser_inspect(page_source)       → HTML completo para análise
khaos_browser_inspect(htmx_endpoints)   → bindings HTMX → ver khaos-htmx-security
khaos_browser_inspect(inline_scripts)   → scripts inline → ver khaos-javascript-api
khaos_browser_inspect(external_scripts) → CDN / bundles externos
khaos_browser_screenshot                → evidência do estado
```

### Authenticated Interaction Capture (vuln)

Mapear chamadas de rede que só aparecem após interação autenticada.

```
khaos_browser_navigate → URL de login
khaos_browser_fill     → campo usuário
khaos_browser_fill     → campo senha
khaos_browser_click    → botão submit
khaos_browser_inspect(location) → confirmar redirecionamento pós-login
khaos_browser_hook(install)     → ativar interceptação
khaos_browser_navigate → feature sob teste (ou khaos_browser_click em trigger)
khaos_browser_hook(collect)     → ver todas as chamadas fetch/XHR disparadas
khaos_browser_screenshot        → evidência
```

### Cookie and Session Inspection (validation)

Inspecionar estado de sessão para análise de fixação, flags e parâmetros.

```
khaos_browser_navigate → URL autenticada
khaos_browser_inspect(form_fields)   → mapear parâmetros de sessão em formulários
khaos_browser_cookie_metadata        → nomes de cookies presentes (não valores)
khaos_browser_screenshot             → evidência
```

Para atributos de cookie (`HttpOnly`, `Secure`, `SameSite`), use `khaos_http_request` inspecionando o header `Set-Cookie` da resposta — esses atributos não são acessíveis via DOM.

## Limites e Restrições

- **Valores de cookies nunca são retornados** por nenhuma tool de browser. `khaos_browser_cookie_metadata` retorna apenas nomes e contagem. Para flags de segurança dos cookies, use `khaos_http_request` com inspeção de `Set-Cookie`.
- **JavaScript arbitrário não é aceito.** `khaos_browser_inspect` e `khaos_browser_hook` executam apenas scripts pré-auditados e fixos.
- **Scope enforced:** navegação para URL fora do escopo do target retorna erro e pode encerrar a sessão.
- Para análise de vulnerabilidades HTMX (`htmx_endpoints`), consulte a skill `khaos-htmx-security`.
- Para análise de scripts client-side (`inline_scripts`, `external_scripts`), consulte a skill `khaos-javascript-api`.

