SmartHub AppsMáquina de aquisição

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:

  1. Busca (ou consulta, se não tiver cache) volume de busca e termos relacionados via P9.1
  2. No Pro, busca também quem rankeia hoje para o termo principal
  3. 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
  4. 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

4. Painel

Componentes de P2.1, claro e escuro:

  1. 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)
  2. Gerar — fluxo de seleção de produto → geração → revisão → aplicar, cards numerados
  3. 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

  1. 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
  2. Trial gratuito funcionando sem pedir cartão, sem permitir aplicar
  3. Teste de que Essencial exige revisão produto a produto e não permite lote
  4. update_produto_descricao() implementado na interface ConectorBase e testado contra o conector Nuvemshop
  5. As 3 telas em claro e escuro, passando pelo checklist do manual
  6. 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
© 2026 EcomSmart · Uso interno · pt-BR