P9.2 · Vitrine SEO — gerador de descrição, trial e aplicação em lote
Depende de P9.1 e P2.1. Skill: `/identidade-ecomsmart`.
O prompt
Implemente a geração da descrição em si, o trial gratuito e o fluxo de aplicar de volta na loja.
1. Geração
Para um Produto canônico:
- Busca (ou consulta, se não tiver cache) volume de busca e termos relacionados via P9.1
- No Pro, busca também quem rankeia hoje para o termo principal
- Gera título (até 60 caracteres, com a palavra-chave de maior volume), meta description (140 a 155 caracteres) e corpo (200 a 400 palavras), usando os dados reais recuperados — não invente número de busca, sempre venha do DataForSEO
- Grava em
DescricaoGerada:produto,titulo,meta_description,corpo,termos_usados(JSON com volume de cada um),versao,criada_em,aplicada_em(nulo até o lojista aplicar)
O corpo gerado segue o tom EcomSmart voltado ao consumidor final da loja (não o tom interno do painel) — direto, sem "clique aqui", sem palavra proibida, sem prometer o que o produto não é.
2. Trial gratuito — sem cartão
Endpoint público (usa o OAuth já feito no Raio-X, não pede novo): lojista escolhe até 3 produtos do catálogo já sincronizado, recebe a descrição gerada na tela, sem poder aplicar ainda — só visualizar e copiar manualmente. Aplicar direto na loja é recurso pago (Essencial e Pro).
Isso replica a mesma lógica de qualificação do Raio-X: mostra o valor primeiro, cobra depois.
3. Aplicar na loja
- Essencial: um produto por vez, com revisão obrigatória do lojista antes de confirmar — nunca publica sem essa etapa
- Pro: aplicar em lote, mas ainda com uma tela de revisão em massa antes de confirmar (lista com checkbox, não é "aplicar tudo cegamente")
- Escreva no conector canônico (
conectores/) o método de atualização de descrição do produto — a Nuvemshop e o resto seguem a mesma interfaceConectorBasede P1.1, então implemente oupdate_produto_descricao()ali, não duplique lógica de plataforma aqui
4. Painel
Componentes de P2.1, claro e escuro:
- Catálogo — lista de produtos com indicador de "descrição fraca" (abaixo de 40 palavras) versus "otimizada", contagem visível no topo em KPI (Figtree 700, azul, tabular, com data de referência)
- Gerar — fluxo de seleção de produto → geração → revisão → aplicar, cards numerados
- Histórico — versões anteriores por produto (30 dias no Essencial, 12 meses no Pro), com opção de reverter
5. Limite de plano
Trave o teto do plano no mesmo serviço central usado no resto do catálogo. Ao esgotar, tela de upgrade com o benefício real — nunca erro seco. Módulo Pro (SERP, lote) aparece desfocado no Essencial com um argumento real: "3 concorrentes seus já aparecem na primeira página para {termo}. Veja quais no plano Pro."
Critérios de aceite
- Geração real de descrição para 3 produtos de teste, com título, meta description e corpo, usando dado real do DataForSEO — mostre os termos e volumes usados
- Trial gratuito funcionando sem pedir cartão, sem permitir aplicar
- Teste de que Essencial exige revisão produto a produto e não permite lote
update_produto_descricao()implementado na interfaceConectorBasee testado contra o conector Nuvemshop- As 3 telas em claro e escuro, passando pelo checklist do manual
- Teste de palavras proibidas no corpo gerado — inclua um teste que roda a checagem sobre uma amostra de descrições geradas, não só sobre templates fixos