Workshop Operação Lucrativa · Agenda da manhã · 17/10
Bom dia e boas‑vindas!
Que bom ter você no Workshop Operação Lucrativa. Esta é a página da agenda da manhã: deixe aberta e siga junto com a aula, da abertura ao plugin exclusivo instalado, conectado à sua conta do Mercado Livre e fazendo as primeiras análises. Marque cada etapa ao concluir.
01 Abertura
Abertura e combinados do dia
Hoje você sai com a IA trabalhando na sua operação do Mercado Livre. De manhã, o Claude Desktop e o plugin exclusivo conectados à sua conta. À tarde, o seu primeiro sistema próprio. Antes de começar:
Nossos combinados
Leia e clique em cada um para confirmar. O resto da agenda abre quando você concordar com todos.
O restante da agenda aparece depois que você concordar com os combinados.
Confira o seu Claude Desktop
- Aberto e logado na sua conta.
- Atualizado: se o app oferecer uma atualização, instale antes de começar.
- O Cowork abre: procure “Cowork” (ou “Início”) na barra lateral.
- Serviço no ar: status.claude.com mostra se há instabilidade.
Cronograma do dia
IA na sua conta do ML
- Revisão geral do Claude DesktopModos, skills, plugins e habilidades · etapa 02
- API do Mercado LivreO app no DevCenter que abre a porta da sua conta · etapa 05
- Conexão da sua conta MLUma vez só, e ela se renova sozinha · etapa 06
- Uso do plugin exclusivoHN Anúncio ML baixado e instalado · etapas 03 e 04
- Análises iniciais dos seus dadosRaio-x, Product Ads e as decisões do dia · etapa 07
Do plugin à sua plataforma
- Claude CodeO modo em que o Claude programa por você
- Princípios de desenvolvimento de plataformas
- Calculadora de margemCriação e uso
- Plataformas e ferramentas
- Seu 1º sistema próprio
02 Claude Desktop
As peças do Claude Desktop
Os modos e as seis palavras que vão aparecer o dia inteiro. Entenda cada uma antes de instalar qualquer coisa: o resto do dia fica muito mais fácil.
Três jeitos de trabalhar com o Claude
Chat
A conversa. Perguntas, ideias, textos, a análise de um arquivo que você anexa. É o modo de pensar junto.
Cowork manhã
O Claude trabalha por você: lê e cria arquivos numa pasta, roda scripts e entrega relatórios prontos. É aqui que o plugin roda.
Code tarde
O Claude programa: cria e roda sistemas inteiros a partir do seu pedido em português.
Uma habilidade
Um manual de procedimento: ensina o Claude a fazer uma tarefa do jeito certo, sempre do mesmo jeito. Você não precisa chamar pelo nome: ele escolhe a skill pelo sentido do pedido. Digite / para ver a lista.
raio-x-anuncio-mlUm pacote completo
Junta skills, agentes e scripts num arquivo só. Instala tudo de uma vez e liga ou desliga numa chave. O HN Anúncio ML traz 17 skills e 4 agentes.
hn-anuncio-ml-1.7.0.pluginUm especialista à parte
Um ajudante que o Claude chama para uma parte pesada do trabalho: extrair um anúncio, pesquisar o mercado, conferir os números. Ele trabalha separado e devolve só o resumo, e a conversa principal não se perde.
pesquisa-mercado-mlO seu lugar de trabalho
Reúne as conversas de um assunto, as instruções que valem para todas elas e uma pasta do seu computador. Crie um para a sua loja: o que o plugin gerar fica guardado na pasta dele.
Projeto “Minha Loja ML”O resultado pronto
O que o Claude entrega para você usar fora da conversa: uma página, um relatório, uma planilha, um gráfico, um documento. Você abre, pede ajustes e baixa.
o relatório em HTML do raio-xUma ponte com outro sistema
Liga o Claude a um serviço externo. O plugin não precisa de conector: ele fala direto com a API do Mercado Livre usando a conexão guardada no seu computador.
Pense numa loja: o Claude é o funcionário. No Chat vocês conversam, no Cowork ele trabalha na mesa e no Code ele constrói uma ferramenta nova. As skills são os procedimentos que ele segue, o plugin é o treinamento completo que você entrega de uma vez, os agentes são os especialistas que ele chama, o projeto é a mesa dele, com a pasta da sua loja em cima, e o artefato é o relatório pronto que ele deixa para você.
03 O plugin
O plugin exclusivo da Operação Lucrativa
O HN Anúncio ML foi feito pelo Henrique Niada só para quem está aqui. É um time completo para o Mercado Livre dentro do seu Claude: do raio-x do anúncio à publicação, dos Product Ads às várias lojas — tudo pedindo em português.
Raio-x do anúncio
Descobre por que um anúncio não vende: título, fotos, preço, ficha técnica e concorrência. Não altera nada.
O anúncio perfeito
Estratégia, título, descrição, ficha técnica, preço com margem para promoção e o roteiro das fotos, de ponta a ponta.
Publicação com travas
Revisão completa antes de subir. Só publica depois do seu “pode publicar”.
Product Ads
Diagnóstico da conta e de cada campanha: ROAS, ACOS, TACOS e onde o dinheiro está indo embora. Não mexe nas campanhas.
Decisões do dia
Uma fila curta do que mexer hoje nos ads, com o valor em jogo e quando conferir de novo.
Várias lojas
A mesma análise em todas as suas contas de uma vez, num relatório só para comparar.
HN Anúncio ML · versão 1.7.0
O arquivo do plugin, pronto para instalar na etapa 04. O download é liberado durante o workshop — quando abrir, um clique e ele vai para a sua pasta Downloads, sem precisar abrir nem descompactar.
.plugin do jeito que ele veio.Confira o Python 3
Abra o Terminal (Mac) ou o Prompt de Comando (Windows), cole o comando e aperte Enter. Tem que aparecer Python 3. e um número.
python3 --version
py --version
04 Instalar no Claude
Plugin instalado e pronto no Cowork
Siga o tour: o ponto colorido é onde você clica no seu Claude Desktop. Use Próximo ou as setas ← → com o mouse sobre a tela.
Prints reais do Claude Desktop em português (outubro de 2026). A barra lateral muda conforme a versão do app — o tour mostra as três que existem hoje.
05 App no Mercado Livre
Crie o seu app no DevCenter
O app é a “chave” que deixa o plugin conversar com a API do Mercado Livre em nome da sua conta. Você cria uma vez só e sai com dois códigos: App ID e Secret Key.
https://developers.mercadolivre.com.br/devcenter
Prints reais do DevCenter do Mercado Livre (outubro de 2026). Se o site mudar, os nomes dos campos continuam valendo.
06 Conectar a conta
Ligue o plugin à sua conta
Leva poucos minutos e é uma vez só. Depois disso o plugin enxerga a sua conta do Mercado Livre e a conexão se renova sozinha.
- Peça ao Claude, no Cowork, dentro do projeto
conecta minha conta do Mercado Livre
Se preferir, digite
/conectar-conta-ml. Se as chaves já estiverem guardadas, ele pula direto para o passo 3. - Cole o App ID e a Secret Key quando ele pedir
Copie os dois do seu app no DevCenter e cole na conversa, do jeito que vier. O plugin guarda as chaves num cofre no computador e não repete os valores na conversa.
Cadastrou uma Redirect URI diferente de
https://httpbin.org/get? Avise qual junto com as chaves.Prefere não colar no chat? Use um arquivo
Na pasta do projeto, crie um arquivo chamado
.env— com o ponto na frente — com as três linhas abaixo e avise o Claude que salvou. No Mac ele fica oculto no Finder (Cmd+Shift+. mostra); no Windows, confira que não virou.env.txt..envCLIENT_ID=cole-aqui-o-app-id CLIENT_SECRET=cole-aqui-a-secret-key REDIRECT_URI=https://httpbin.org/get
- Abra o link e autorize
O Claude devolve um link. Abra no navegador logado na conta vendedora e clique em Autorizar. Tem mais de uma conta no navegador? Confira o nome no canto da tela antes de autorizar.
- Copie a barra de endereço e cole no chat
O navegador vai para uma página com um texto técnico — ou até um erro. É assim mesmo. O que importa é a barra de endereço, que agora tem
?code=: copie a URL inteira e cole na conversa.Esse código vale poucos minutos e uma vez só. Demorou? Peça um link novo e repita.
- Confira a conexão
O Claude mostra o apelido da conta e se ela tem acesso a ads. Logo em seguida, ele apresenta tudo o que dá para pedir agora.
Apareceu
ads: não? Volte ao app no DevCenter, marque a permissão Publicidade e peça para conectar de novo: as chaves continuam guardadas, então o link sai direto.
.hn-anuncio-ml), com acesso só para o seu usuário. A Secret Key nunca aparece na conversa. Se um dia o Claude disser que não encontrou a sua conta, é só pedir “conecta minha conta do Mercado Livre” de novo.07 Primeiros pedidos
Agora é pedir em português
Chegou a melhor parte: é só conversar. Escreva do jeito que você falaria com alguém da sua equipe, sem comando para decorar e sem jeito certo. Para começar, copie um destes pedidos, cole no projeto e troque o MLB por um anúncio seu.
faz o raio-x do MLB1234567890Descobre por que o anúncio não vende · não altera nada
como estão meus ads? quero o relatórioRaio-x da publicidade da conta inteira · não altera nada
o que eu mexo hoje nos ads?Uma lista curta do que fazer hoje · não altera nada
monta o anúncio perfeito desse produto: MLB1234567890Cria o anúncio com você · só publica depois do seu “pode publicar”
MLB-. Pode colar o link inteiro também: o Claude entende.Travou? Sem problema
Os tropeços mais comuns têm solução rápida. E se não estiver aqui, chame no chat do evento.
O Claude Desktop recusou o arquivo do plugin
Confira se você enviou o arquivo .plugin original, sem descompactar, e se o seu Claude Desktop está atualizado. Baixe de novo na etapa 03 se o download tiver sido interrompido.
Digitei “/” e as skills hn-anuncio-ml não aparecem
Confirme em Personalizar › Plugins que o HN Anúncio ML aparece e está ativo. Depois abra uma conversa nova dentro do projeto.
O DevCenter diz que o endereço de redirect não é válido
O Mercado Livre exige um endereço HTTPS que responda. Use exatamente https://httpbin.org/get. Endereços com localhost não passam.
“O App ID tem que ser só números” ou “a Secret Key veio vazia ou com espaço”
A colagem pegou algo a mais (um espaço, o nome do campo, a frase inteira). Copie de novo no DevCenter só o valor de cada campo e cole outra vez. Se usa o arquivo .env, confira que ele se chama exatamente .env e está na pasta do projeto.
“invalid_grant” ao colar a URL
O código expirou ou já foi usado. Peça de novo “conecta minha conta do Mercado Livre” e cole a URL logo depois de autorizar.
Tenho mais de uma loja
Repita a etapa 06 logado na outra conta. A conexão nova é acrescentada, não substitui a anterior. Para rodar um relatório em todas, peça: “roda o diagnóstico de ads em todas as minhas contas”.
Bloqueado por enquanto: libera na parte da tarde.