Descricoes de produto com IA: como escalar conteudo sem perder qualidade

O problema e de escala. Uma loja com 500 SKUs precisa de 500 descricoes unicas, otimizadas para SEO, alinhadas ao tom da marca e factualmente corretas. Com 5.000 SKUs, o problema se multiplica por 10. Na pratica, a maioria das lojas tem um dos seguintes cenarios: descricoes copiadas do fabricante (conteudo duplicado que o Google ignora), descricoes genericas de 2 linhas que nao ajudam na decisao de compra, ou descricoes ausentes (campo vazio no admin). Qualquer um desses cenarios custa vendas e posicionamento organico. IA resolve o problema de volume. Um script com Claude API ou GPT-4 gera 500 descricoes unicas em menos de 1 hora, a um custo de R$ 50-200. Mas gerar nao e o mesmo que publicar. O workflow completo envolve geracao, revisao humana e publicacao, e cada etapa importa.

Por que descricoes importam para SEO

Google avalia conteudo de pagina de produto em 3 dimensoes: unicidade (conteudo duplicado do fabricante e ignorado ou penalizado), relevancia (a descricao contem as keywords que o usuario busca?) e utilidade (Google Helpful Content Update prioriza conteudo que realmente ajuda o usuario a tomar uma decisao). Uma descricao bem feita cobre specs tecnicas, beneficios praticos, contexto de uso e comparacoes relevantes. Paginas de produto com descricoes unicas de 150+ palavras indexam em media 23% mais keywords do que paginas com descricoes genericas de 30 palavras, segundo estudo da Ahrefs com 100.000 paginas de e-commerce. O impacto indireto: paginas bem indexadas atraem trafego organico que custa zero em ads. Para uma loja com 2.000 SKUs, a diferenca entre descricoes genericas e descricoes otimizadas pode representar 20.000-50.000 visitas organicas adicionais por mes.

Ferramentas e APIs

Claude API (Anthropic): excelente para descricoes longas e estruturadas. Modelo Claude Sonnet oferece o melhor custo-beneficio para processamento em lote. Custo: ~USD 0.003-0.015 por descricao de 200 palavras. ChatGPT API (OpenAI): GPT-4o e GPT-4o-mini. O mini e mais barato para volume alto. Custo: ~USD 0.002-0.010 por descricao. Sanity AI Assist: integrado ao Sanity Studio. O editor clica num botao e a IA gera conteudo baseado no contexto dos campos do documento. Ideal para equipes que ja usam Sanity como CMS. O custo esta incluso no plano Sanity (a partir do Growth plan). Shopify Magic: nativo no admin do Shopify. Gera descricoes com base no titulo e keywords do produto. Gratuito para todos os lojistas Shopify. Limitacao: menos controle sobre tom e estrutura comparado a APIs. VTEX nao oferece geracao nativa de descricoes, mas a VTEX Catalog API permite atualizar descricoes em massa via script. A geracao acontece externamente (Claude API ou GPT-4) e a publicacao via API.

Workflow pratico

O workflow que funciona em producao tem 5 etapas: 1) Extrair dados do produto: exporte do admin (VTEX ou Shopify) ou via API um CSV com titulo, categoria, subcategoria, specs tecnicas (peso, dimensoes, material, cor), publico-alvo e keywords SEO da categoria. 2) Prompt engineering: crie um template de prompt com instrucoes claras sobre tom da marca, estrutura (abertura com beneficio principal, specs tecnicas, contexto de uso, CTA), keywords obrigatorias e comprimento desejado. 3) Processar em lote: script Node.js que le o CSV, envia cada produto para a API do LLM com o prompt template, e salva o resultado em um arquivo de saida. Inclua rate limiting e retry logic. Para 1.000 produtos com Claude API, o processamento leva 30-60 minutos e custa R$ 50-150. 4) Revisao humana: nunca publique sem revisao. Foque em verificar dados tecnicos (IA alucina specs), remover afirmacoes exageradas ('o melhor produto do mercado') e ajustar tom quando necessario. Um revisor processa 50-100 descricoes por hora. 5) Publicar: importe via API (VTEX Catalog API, Shopify Admin API) ou diretamente no CMS (Sanity). Automatize com um script que le o arquivo revisado e atualiza cada produto.

Prompt engineering para e-commerce

O prompt e 80% do resultado. Um prompt ruim gera descricoes genericas e inuteis. Um prompt bem construido gera conteudo publicavel com revisao minima. Template base que funciona: 'Voce e um copywriter especializado em e-commerce de [segmento]. Escreva uma descricao de produto para a pagina de [plataforma]. Tom: [profissional/casual/tecnico]. Publico: [persona]. Estrutura: 1) Abertura com o principal beneficio (1 frase), 2) 3-4 paragrafos com specs tecnicas e contexto de uso, 3) Para quem e ideal (1 frase). Inclua as keywords: [lista]. Comprimento: 150-250 palavras. Dados do produto: titulo: [titulo], categoria: [categoria], specs: [specs], material: [material].' Dicas que melhoram o resultado: inclua 2-3 exemplos de descricoes aprovadas no prompt (few-shot learning); especifique o que NAO fazer ('nao use superlativos como melhor, unico, incrivel'); inclua o publico-alvo para contextualizar a linguagem; peca para a IA gerar 2 variantes e escolha a melhor.

Integracao com CMS e plataformas

Sanity AI Assist: para equipes que usam Sanity como CMS headless, a integracao e nativa. No Sanity Studio, o editor ve um botao de IA ao lado dos campos de texto. Ao clicar, a IA gera conteudo baseado no contexto do documento (titulo, categoria, outros campos preenchidos). O editor revisa, ajusta e publica. Zero codigo necessario. VTEX Catalog API: endpoint PUT /api/catalog/pvt/product/{productId} permite atualizar descricao, meta description e titulo. Script Node.js que le um CSV com descricoes revisadas e atualiza em massa. Rate limit: 40 requests por minuto. Para 2.000 produtos, o processo leva ~50 minutos. Shopify Admin API: endpoint PUT /admin/api/2025-01/products/{product_id}.json atualiza body_html (descricao). Bulk editor no admin tambem permite colar descricoes manualmente para volumes menores. Pipeline automatizado completo: produto novo cadastrado no Sanity (webhook) > Cloudflare Worker recebe o evento > Claude API gera descricao > Supabase armazena como draft > notificacao no Slack para revisor > revisor aprova no Sanity Studio > publicacao automatica.

Cuidados

1) Alucinacao: o risco numero 1. LLMs inventam dados tecnicos que parecem plausiveis mas sao falsos. Um produto com 500g pode aparecer na descricao como 450g. Uma camiseta 100% algodao pode ser descrita como 'algodao com elastano'. Revisao humana dos dados factuais e obrigatoria. 2) Conteudo generico: se todas as descricoes soam iguais, voce trocou conteudo duplicado do fabricante por conteudo duplicado da IA. Varie os prompts, inclua contexto especifico de cada produto e revise para garantir diferenciacao. 3) Dependencia excessiva: IA gera drafts, humanos publicam. Nunca automatize o pipeline completo sem revisao humana no meio. O custo de uma descricao errada (devolucao, reclamacao, problema legal) e muito maior que o custo de 30 segundos de revisao. 4) SEO keyword stuffing: incluir keywords e importante, mas forcar keywords em cada frase prejudica legibilidade e pode ser penalizado pelo Google. A regra: keywords no titulo, primeira frase e 1-2 mencoes naturais no corpo. 5) Ignorar plataforma: descricoes que funcionam no Shopify (HTML com formatacao rica) podem nao renderizar bem no VTEX (que tem limitacoes de HTML no campo de descricao). Adapte o formato para a plataforma de destino.