Descrições de produto e newsletters da loja virtual em escala com Claude Code

No fim de semana em que recebi 50 produtos novos de uma só vez, me arrependi profundamente da minha própria decisão.

Comprar bem eu sei fazer. O problema vem depois. Escrever a descrição de cada página de produto, preencher tamanho e material, pensar nas sugestões de uso e, de quebra, montar a newsletter da semana. Mesmo gastando só 15 minutos por produto, são 12 horas e meia para 50 itens. O sábado e o domingo iam embora inteiros.

Pior: a descrição que escrevi às 3 da manhã, relida na manhã seguinte, era metade texto vazio do tipo “uma peça especial feita com material de alta qualidade”, que serve para qualquer produto. Não aparece na busca e não prende a atenção de ninguém. Foi ali que percebi: eu me desgastava mais com o texto do que com a compra.

Se você toca uma loja virtual sozinho ou com pouca gente, conhece essa sensação. Produto para vender tem. O que falta sempre é tempo para escrever descrição e newsletter. Quando você passa essa parte para a IA gerar, o fim de semana volta.

Pontos principais

• O rascunho de descrição e newsletter cai de 15 minutos por produto para 2 ou 3 minutos quando você delega ao Claude Code.
• Custo de compra, margem e dados pessoais de clientes não vão para a IA: a regra é mostrar só a ficha técnica que pode ser publicada.
• Tem um prompt pronto para colar e um script de teste que gera as descrições em lote a partir de uma lista de produtos.
• A IA cuida só do rascunho. Termos que esbarram na lei do consumidor e a conferência final de preço e estoque ficam sempre com a pessoa.
• Numa loja que cadastra 10 itens por dia, 40 a 60 horas de escrita por mês caem para a casa das 10 horas.

Para quem é este artigo

Penso em donos e operadores de loja virtual com este perfil:

• Vendem dezenas a centenas de itens por mês em Nuvemshop, Shopify, Mercado Livre, plataformas próprias ou marketplaces parecidos.
• Fazem cadastro, foto, descrição e newsletter sozinhos ou com 1 ou 2 ajudantes.
• Nunca programaram, mas usam planilha e copiar e colar tranquilamente.
• Querem “criar texto com IA”, mas travam por não saber o que é seguro passar e como.

Quem já tem geração automática de descrição embutida no sistema central e rodando bem pode pular este artigo, porque já resolveu o problema anterior a ele. Se você nunca programou e está inseguro, vale ler antes o Claude Code para quem não é da área: o resto fica bem mais leve.

Quebrando o fluxo de cadastro da loja virtual

Para achar onde economizar tempo, primeiro a gente separa o caminho até um produto ir ao ar. Na minha loja era assim:

Etapa	O que se faz	Onde nasce texto
Recebimento	Conferência, medição, foto	(ainda sem texto)
Cadastro	Ficha técnica, categoria	Nome do produto, chamada
Descrição	Escrever o corpo	Descrição, modo de uso, avisos
Divulgação	Redes sociais, newsletter	Newsletter de novidade, post
Recompra	Reposição, promoção	Newsletter para quem já comprou

Olhe a coluna “Onde nasce texto”. Do recebimento à recompra, mais da metade do tempo de trabalho é sugada por essa coluna. É exatamente aqui que a IA corta. Foto e medição só a pessoa faz, mas transformar o resultado em texto, até o rascunho, dá para delegar inteiro.

Retrabalhos e dores comuns

Antes de facilitar, deixo claro onde a gente trava. Os três retrabalhos que mais escuto na prática:

1. A descrição vira um texto raso que serve para qualquer produto, não aparece na busca e acaba reescrita. Toda vez você inventa as mesmas palavras de novo.
2. O tom da newsletter varia de dia para dia. Dias animados se misturam com dias secos, e a imagem da marca fica embaçada.
3. Você usa sem querer um “o mais barato” ou “100% de resultado” e cai em propaganda enganosa. Depois precisa corrigir todos os produtos.

Esses três quase somem se você decidir antes de escrever um “molde” e uma “lista de proibições”. E o Claude Code é justo o parceiro certo para decorar esse molde.

O que delega ao Claude Code e o que você decide

Se não traçar essa linha primeiro, dá acidente. Na minha loja a divisão é esta:

Etapa	Delego à IA	Decido eu, sempre
Descrição	Rascunho a partir da ficha	Conferir preço, estoque, material
Chamada	Gerar 5 opções	Escolher a opção que combina com a marca
Newsletter	Esboço de assunto e corpo	Hora de envio e botão de enviar
Termos legais	Sugerir palavras de risco	Decisão final sobre a lei do consumidor

A regra é simples: toda decisão que envolve “fato” e “responsabilidade” fica com a pessoa. Trate a IA como “a área que rascunha rápido e em volume” e dá para delegar sem medo. A forma de delegar parte do guia básico do Claude Code.

Caso 1: rascunhar descrições em lote

Este é o que mais rende. Você passa nome, categoria, material, tamanho e características numa tabela e recebe de volta vários rascunhos que seguem o molde da descrição.

Aqui está o prompt pronto para colar. Troque o que está entre <> pelos seus produtos.

Você é o redator de produtos da nossa loja. Siga estas regras à risca ao escrever a descrição.

# Tom da loja
- Sem primeira pessoa, sem exagero, frases diretas
- Cada frase com até 40 caracteres; corpo entre 250 e 350 caracteres

# Termos proibidos (lei do consumidor)
- Não usar "o mais barato", "Nº 1", "100%", "funciona sempre", "cura"
- Não fazer superlativos nem afirmações sem comprovação

# Entrada
Produto: <Carteira de couro marrom, dobrável>
Material: <Couro legítimo (bovino)>
Tamanho: <11 cm de largura, 9,5 cm de altura>
Características: <6 cartões / porta-moedas / leve, 85 g>

# Saída
1. Chamada (até 25 caracteres)
2. Descrição (250 a 350 caracteres)
3. Três palavras-chave de busca para esta página

O segredo é passar os termos proibidos logo no começo. Sem isso, a IA tenta “ajudar” e pisa numa mina do tipo “a melhor qualidade do mercado”. Com o porteiro na frente, as palavras de risco param de aparecer. Quem quer subir mais um nível na precisão do prompt encontra ideias em técnicas avançadas de engenharia de prompt.

Caso 2: escrever newsletter de novidade e de recompra de formas diferentes

A newsletter muda conforme “para quem você envia”. Para clientes novos, mostre o atrativo do produto. Para quem já comprou, passe um ar de “feito para você”. Dá para a IA escrever cada versão.

Como checklist, deixo o mínimo que uma newsletter precisa ter:

• Assunto com cerca de 20 caracteres e concretude que dá vontade de abrir
• Nas 2 primeiras linhas, “para quem é e do que se trata o aviso”
• Link de produto focado em 1 tema por envio (sem amontoar)
• Link de descadastro e identificação do remetente (regras de e-mail comercial)
• Preço, estoque e validade do cupom conferidos por olho humano

Quando você passa esse checklist inteiro no prompt, a IA devolve um rascunho com cada item preenchido. Depois é só a pessoa apertar enviar. Esse ponto nunca se automatiza.

Caso 3: transformar uma anotação de uma linha em descrição formal

Aquele rabisco feito na hora da compra, tipo “tricô preto quente elástico até M”. Aqui o uso é inflar esse rabisco até virar descrição formal.

Anotação rápida	Rascunho ajustado pela IA (resumo)
Tricô preto quente elástico até M	Tricô preto em material felpudo que reduz a estática e acompanha o corpo. Tamanhos até M…
Caneca nórdico micro-ondas OK	Tons sóbrios de estilo nórdico. Caneca de uso diário, compatível com micro-ondas e lava-louças…

Some o retrabalho de não conseguir reler o rabisco e ter que escavar a memória a cada passagem a limpo. Se você deixar uma linha já na hora da anotação, a versão final da noite vira quase um preencher lacunas.

Script de teste pronto para colar

Para quem acha que “colar item por item cansa do mesmo jeito”, deixo um script que lê a lista de produtos (CSV) e rascunha a descrição de cada linha de uma vez. Funciona com Node.js e uma chave de API da Anthropic.

Primeiro, a preparação.

mkdir ec-copy && cd ec-copy
npm init -y
npm install @anthropic-ai/sdk

Na mesma pasta, coloque o products.csv. A primeira linha é o cabeçalho.

name,material,size,features
Carteira de couro marrom,Couro legitimo,11cm x 9.5cm,6 cartoes/porta-moedas/85g
Trico preto,Mistura acrilica,ate M,felpudo/elastico/menos estatica

O corpo (generate.mjs). Ele lê o CSV, faz respeitar os termos proibidos e escreve o resultado em drafts.md.

import Anthropic from "@anthropic-ai/sdk";
import { readFile, writeFile } from "node:fs/promises";

const client = new Anthropic();

// Leitura simples do CSV (separado por vírgula, sem aspas)
const raw = await readFile("./products.csv", "utf8");
const [head, ...lines] = raw.trim().split(/\r?\n/);
const keys = head.split(",");
const rows = lines
  .filter((l) => l.trim() !== "")
  .map((l) => Object.fromEntries(l.split(",").map((v, i) => [keys[i], v])));

const rule =
  "Frases diretas, sem exagero, cada frase com ate 40 caracteres. Proibido: o mais barato/No 1/100%/funciona sempre/cura.";

let out = "";
for (const r of rows) {
  const res = await client.messages.create({
    model: process.env.ANTHROPIC_MODEL || "claude-sonnet-4-6",
    max_tokens: 700,
    system: `Voce e o redator de produtos da nossa loja. Restricoes: ${rule}`,
    messages: [
      {
        role: "user",
        content:
          `Escreva a descricao deste produto em 250 a 350 caracteres.\n` +
          `Produto:${r.name} Material:${r.material} Tamanho:${r.size} Caracteristicas:${r.features}`,
      },
    ],
  });
  const text = res.content.find((b) => b.type === "text")?.text ?? "";
  out += `## ${r.name}\n\n${text}\n\n`;
  console.log(`pronto: ${r.name}`);
}

await writeFile("./drafts.md", out, "utf8");
console.log("-> gravado em drafts.md");

Para rodar, é só isto.

node generate.mjs

Com 10 linhas no CSV, os 10 rascunhos ficam alinhados em drafts.md. Depois a pessoa confere os fatos e cola no painel de cada loja. Se você escrever as regras de proibição no CLAUDE.md, a IA decora o tom da loja sem você precisar repetir tudo a cada vez. O passo a passo está em como escrever o CLAUDE.md.

O que mudou do antes para o depois

Em números a diferença fica clara. É uma estimativa da minha loja (10 cadastros por dia, 1 newsletter por semana).

Item	Antes	Depois
Escrever 1 descrição	cerca de 15 min	cerca de 2 a 3 min
Escrever 10 por dia	cerca de 2,5 h	cerca de 30 min
Newsletter semanal	cerca de 60 min	cerca de 15 min
Escrita no mês	cerca de 50 h	cerca de 12 h

Supondo um valor-hora de R$ 30, cortar 38 horas no mês libera o equivalente a cerca de R$ 1.140 de tempo. Poder jogar esse tempo em compra e foto foi a maior mudança. Dá para manter a qualidade do rascunho constante com as ideias de como ser mais produtivo.

Cuidados com dados pessoais e segurança

Pular esta parte vira acidente, não economia. As regras mínimas são estas:

• Não passe custo de compra, custo e margem para a IA. A descrição não precisa de custo. Passe só a ficha que pode ser publicada.
• Não cole nome, endereço, e-mail ou histórico de compra do cliente. Na newsletter, informe só o “nome do segmento” e deixe o sistema de envio inserir o destinatário.
• Guarde a chave de API no .env e não suba no git. Coloque .env no .gitignore sem falta.
• Não publique o resultado direto: a pessoa confere. A IA às vezes inventa fatos. Cruze preço, estoque e material com o painel.
• As leis do consumidor e de e-mail comercial têm responsabilidade final da loja. A saída da IA é “candidata”, não “selo de aprovação”.

Como fonte pública externa, vale conferir uma vez a página oficial do Código de Defesa do Consumidor para entender o limite das expressões que se pode usar.

Perguntas frequentes

P. A IA lê a foto do produto? Ela consegue ler características da imagem, mas medição e confirmação final do material ficam com a pessoa. Ela capta a nuance da foto, mas não crava “couro legítimo ou sintético”. O fato verdadeiro é o valor do painel.

P. Dá para jogar direto no Mercado Livre ou na Shopify? Este script vai só até gerar o rascunho em drafts.md. A colagem no formato de cada plataforma é feita pela pessoa. Se a loja tiver cadastro em lote por CSV, basta acrescentar um prompt que formate a saída naquele padrão para facilitar mais.

P. O tom da marca não sai direito. Cole 2 ou 3 descrições antigas que ficaram boas no prompt, como “modelo”. A IA imita melhor o tom a partir de exemplos concretos do que de instruções abstratas.

P. Dá para testar de graça? A API tem custo de uso, mas por descrição fica na casa de centavos. Comece com 10 itens, compare com o tempo que sobrou e decida a partir daí.

Por onde começar

Se você toca uma loja virtual pequena e quer “primeiro fazer por conta própria”, deixei um PDF gratuito e uma coletânea de exemplos na página de materiais. Você leva embora o prompt e o checklist prontos.

Se você opera com vários ajudantes e quer “unificar as regras de texto da loja inteira” ou “ter acompanhamento na implantação”, fale comigo pela página de treinamento e consultoria. A gente fecha junto até o desenho do CLAUDE.md no tom da sua loja.

O que aconteceu quando eu testei

Depois daquele “fim de semana perdido com 50 itens”, testei este passo a passo numa compra do mesmo tamanho.

Conferi três coisas. Primeira: pondo os termos proibidos no topo do prompt, “o mais barato” e “Nº 1” praticamente sumiram. Em 20 itens, só 1 teve palavra de risco. Segunda: rodando 10 itens no script de lote, os rascunhos ficaram em drafts.md em cerca de 2 minutos, um trabalho que à mão levava duas horas e meia. Terceira: cruzando preço e material com olho humano, a IA tinha inflado “couro legítimo” para “couro legítimo premium” em 2 pontos, o que confirmou que a conferência da pessoa é necessária.

Conclusão: a IA acelera o rascunho de forma brutal, mas o porteiro dos fatos e da lei fica com a pessoa. Se você respeitar essa linha, o fim de semana volta para a compra e para a família. Em vez de caçar a IA mais esperta, decida antes o que vai delegar. Foi isso que mais funcionou.