parity extract — deco developer docs

parity extract é a captura de site único, de nível mais baixo: ele fotografa os componentes de UI de um site (header, footer, nav, prateleiras, hero, minicart, …) num bundle estruturado e pronto para IA — sem comparação prod × cand.

parity extract --url https://loja.com \
  --pages /,category-auto,pdp-auto --format both

Use quando não há código-fonte para ler e você quer o inventário bruto de componentes para alimentar um agente. (O parity migrate parte das mesmas primitivas e acrescenta tema, playbooks de destino, conteúdo VTEX e um relatório visual.)

O que ele captura

Uma passagem heurística roda sempre (sem precisar de LLM): tags semânticas (header/footer/nav), [data-section] da Deco, heurísticas de classe (shelf/carousel/minicart) e uma passagem de geometria para hero/banner. Uma passagem opcional com LLM reetiqueta os papéis detectados.

Por componente: HTML renderizado, estilos computados, um screenshot recortado e inventários de assets/links/textos.

Flags

Flag	Padrão	O que faz
`--url`	obrigatória	Site de onde extrair
`--pages`	`/`	Caminhos literais e/ou `category-auto` / `pdp-auto`
`--components`	todos	Lista de papéis permitidos (ex.: `header,footer,shelf`)
`--viewport`	`mobile`	`mobile` \| `desktop` \| `tablet`
`--format`	`both`	`md` \| `json` \| `both`
`--out`	`./parity-extract`	Diretório de saída
`--no-llm`	LLM ligado	Pula a passagem de reetiquetagem

Saída

parity-extract/<host>/<timestamp>/ — index.md (visão geral), manifest.json (bundle completo) e components/<role>/ (README + component.html + styles.json + screenshot.png).

Mantenha parity-extract/ no gitignore — ele contém o conteúdo de uma loja real.

Veja também

parity migrate — o bundle completo de migração