> For the complete documentation index, see [llms.txt](https://docs.sellermagnet.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sellermagnet.com/pt-or-guia-do-sellermagnet/ferramentas-de-venda/listing-optimizer-overview/listing-agent.md).
# Listing Agent
{% hint style="info" %}
**Dificuldade:** 🟡 Intermediário · **Tempo de leitura:** \~8 min
{% endhint %}
{% hint style="warning" %}
**Disponibilidade:** o Listing Agent faz parte da suíte **Listing Manager AI**, que é lançada **por conta**. Enquanto a sua está pendente, você verá uma ampulheta âmbar ao lado dele no menu **Listing-Manager** e uma nota "you're on the list" ao abri-lo - sem cobrança até você decidir mantê-lo. É necessário ter uma conta Amazon conectada. Veja [Listing Optimizer](/pt-or-guia-do-sellermagnet/ferramentas-de-venda/listing-optimizer-overview.md).
{% endhint %}
{% hint style="success" icon="rocket" %}
**Abrir esta página no seu painel:** [**Ir para Listing Agent →**](https://dashboard.sellermagnet.com/listing-agent)
{% endhint %}
## 📋 Visão Geral
O **Listing Agent** é a maneira mais rápida de encontrar e corrigir lacunas de conteúdo em todo o seu catálogo da Amazon. Em vez de abrir um anúncio por vez, ele escaneia cada produto que você sincronizou, classifica-os por quão urgentemente precisam de atenção e permite que você redija texto com IA e o envie para a Amazon em lotes.
Pense nele como uma triagem em massa: o Agent mostra onde está o dano em muitos anúncios de uma vez, redige uma correção para cada campo fraco e submete os campos que você aprova, tudo sem sair da página.
Um único escaneamento observa até **seis sinais de conteúdo**, mas só pontua aqueles que a API da Amazon realmente consegue ver:
| Sinal | O que ele verifica | Severidade |
| ----------------- | ------------------------------------------------------- | -------------------------------------------------------------------------------------------------- |
| **Title** | Presente e com pelo menos 50 caracteres | Ausente = Critical · Curto demais = Warning |
| **Bullet Points** | Todos os 5 bullet points presentes | 0 bullets = Critical · Menos de 5 = Warning |
| **Images** | Pelo menos 5 imagens (7+ recomendado) | 0 imagens = Critical · Menos de 5 = Warning |
| **Description** | Só sinalizado quando o corpo está realmente visível | Não visível via API = excluído (chip neutro) · Visível mas com menos de \~100 caracteres = Warning |
| **A+ Content** | Só sinalizado quando uma ausência é realmente observada | Status desconhecido (o caso usual) = excluído (chip neutro) · Observado ausente = Warning |
| **Video** | Só sinalizado quando uma ausência é realmente observada | Status desconhecido (o caso usual) = excluído (chip neutro) · Observado ausente = Info |
A razão pela qual Description, A+ Content e Video se comportam assim é que a API da Amazon (SP-API) geralmente não consegue vê-los - ela raramente retorna o corpo da descrição, e o status de A+/vídeo muitas vezes volta desconhecido. Quando um sinal é desconhecido, o Agent **o exclui da pontuação e o mostra como um chip neutro** em vez de penalizar você por algo que ele não consegue verificar. Uma descrição vazia ou ilegível, portanto, **não é mais Critical**; apenas uma descrição que está genuinamente visível e com menos de \~100 caracteres levanta um Warning.
Cada produto recebe uma **pontuação de qualidade** que é a **proporção dos sinais conhecidos que ele passa** - na prática, isso normalmente é Title + Bullets + Images (de 3), nem sempre 6 - mostrada como um percentual com um anel colorido: verde em 80%+, âmbar em 50-79%, vermelho abaixo de 50%.
{% hint style="info" %}
**Chips "Not visible via Amazon API".** Campos que a API da Amazon não consegue ver - descrição, A+ Content e vídeo - são renderizados como um chip cinza neutro com um ícone de ponto de interrogação e o tooltip **"Not visible via Amazon API"**. Um chip assim **não** é uma falha e não conta contra a sua pontuação; ele simplesmente significa que o Agent não tem dados confiáveis para aquele campo. Apenas Title, Bullets e Images estão consistentemente visíveis, então é a partir deles que a pontuação normalmente é construída.
{% endhint %}
{% hint style="info" %}
**De onde vêm os dados do escaneamento.** O Listing Agent lê o **snapshot mais recente do Listing Quality** de cada produto, ele não busca dados frescos da Amazon por conta própria. Se o Agent mostrar um estado vazio ("No Listing Data Found"), abra o [Listing Quality](/pt-or-guia-do-sellermagnet/ferramentas-de-venda/listing-optimizer-overview/listing-quality.md) e escaneie seus produtos lá primeiro para preencher os dados do catálogo, depois volte ao Agent.
{% endhint %}
***
## Os cartões de estatística
Assim que um escaneamento termina, quatro cartões resumem seu catálogo num relance:
| Cartão | O que ele conta |
| -------------------- | ------------------------------------------------------------------------------------------- |
| **Total Products** | Cada produto retornado pelo escaneamento |
| **Critical Issues** | Produtos que têm pelo menos um problema Critical (um título, descrição ou imagens ausentes) |
| **Warnings** | Produtos que têm avisos mas **nenhum** problema Critical |
| **Perfect Listings** | Produtos sem nenhum problema entre os sinais conhecidos |
Os mesmos grupos aparecem como abas de filtro acima da lista de produtos: **All**, **Critical**, **Warnings** e **Perfect**. Um produto com qualquer problema Critical cai no grupo Critical; um produto apenas com avisos cai em Warnings; um produto limpo cai em Perfect. A lista é ordenada por severidade primeiro, então os anúncios mais prejudiciais (por exemplo, um título ausente) sempre sobem ao topo.
Quando um escaneamento cobre menos produtos do que todo o seu catálogo, uma linha aparece acima da grade - **"Scanned {n} of {m} products - data as of {date}"** - para que você sempre saiba quanto do catálogo a visão atual reflete e quão fresca ela é.
***
## 🔧 Passo a passo: escanear, corrigir e enviar
{% stepper %}
{% step %}
### Escaneie o catálogo
Clique em **Scan Catalog** na barra de ferramentas superior. O Agent percorre seus produtos sincronizados e os agrupa em All / Critical / Warnings / Perfect. Use a **caixa de busca** para filtrar por ASIN ou título a qualquer momento.
{% endstep %}
{% step %}
### Escolha um grupo
Clique na aba **Critical** para trabalhar nos produtos que mais estão prejudicando você, ou use **Warnings** para uma limpeza mais leve. Cada linha mostra a imagem do produto, título, ASIN e SKU, uma fila de chips de saúde por campo (Title, Bullets, Description, Images, A+, Video) e o anel de pontuação de qualidade.
{% endstep %}
{% step %}
### Abra a gaveta Fix
Clique em **Fix** em qualquer produto com problemas (ou clique na linha) para abrir a **gaveta Fix** à direita. Os problemas são listados do mais prejudicial primeiro, cada um como um cartão de recomendação explicando o que está errado.
{% endstep %}
{% step %}
### Gere com IA por campo
Para cada campo corrigível, clique em **Generate with AI**. O Agent redige texto de substituição usando o contexto do seu produto e o mostra em linha para revisão. A redação de IA no Agent cobre **Title**, **Bullet Points** e **Description**. Lacunas de imagem e A+ são apresentadas na gaveta como achados, mas você as cria no [Listing Quality](/pt-or-guia-do-sellermagnet/ferramentas-de-venda/listing-optimizer-overview/listing-quality.md) ou no AI Image Studio, não pelo botão Generate do Agent.
{% endstep %}
{% step %}
### Update on Amazon
Quando estiver satisfeito com os rascunhos, clique em **Update on Amazon** no topo da gaveta. Um modal abre listando os elementos que você pode enviar: **Title**, **Bullet Points**, **Description**, **Keywords** e **Images**.
{% endstep %}
{% step %}
### Escolha os campos e Save
Marque os elementos que deseja enviar, depois clique em **Save**. Apenas os campos para os quais você realmente gerou conteúdo são enviados, se você marcar um elemento sem um rascunho por trás, o Agent diz para gerar conteúdo primeiro em vez de enviar uma mudança vazia. O SellerMagnet então submete os campos selecionados à Amazon como um lote.
{% endstep %}
{% endstepper %}
{% hint style="info" %}
**Campos que o Agent pode redigir vs. enviar.** O botão Generate redige Title, Bullet Points e Description. O modal de atualização lista todos os cinco elementos por completude, mas um campo só é submetido quando tem conteúdo gerado por IA (ou editado) por trás. Para trabalho de imagem e A+, e para o editor profundo completo, use o [Listing Quality](/pt-or-guia-do-sellermagnet/ferramentas-de-venda/listing-optimizer-overview/listing-quality.md).
{% endhint %}
***
## 🤖 Modos de IA
Nos bastidores, a IA roda em templates de prompt pré-construídos com quatro **modos**. O botão **Generate with AI** de um clique do Agent sempre usa **Optimize** (ele melhora o campo que você já tem). Os outros modos estão disponíveis no AI Studio mais profundo do [Listing Quality](/pt-or-guia-do-sellermagnet/ferramentas-de-venda/listing-optimizer-overview/listing-quality.md).
| Modo | Use-o para |
| -------------- | --------------------------------------------------------------------------------------------------- |
| **Create** | Escrever um campo do zero quando não há nada para começar |
| **Optimize** | Limpar e melhorar o SEO do seu título, bullets ou descrição existentes (é isto que o Agent usa) |
| **Competitor** | Gerar texto projetado para superar um rival, cole o título de um concorrente como a meta a bater |
| **Translate** | Localizar o campo no idioma do marketplace com texto de som nativo, não tradução automática literal |
### A conformidade com o guia de estilo da Amazon é integrada
Cada prompt tem as regras de título e conteúdo da Amazon embutidas, então a saída é compatível por construção em vez de precisar de uma limpeza manual:
* **Title Case** (capitalizar todas as palavras exceto preposições curtas)
* **Limites de caracteres** por campo (títulos por volta de 80-150 caracteres, bullets 150-250 cada e menos de 1.000 no total)
* **Sem linguagem promocional** (nenhum "best seller", "#1", "guarantee" e afirmações similares)
* **Sem emojis** e nenhum caractere especial proibido (`~ ! * $ ? _ { } # < > ^`)
* **Estrutura com a marca primeiro** (Marca + Nome do Produto + Recurso Principal + Tamanho/Cor/Variante)
* **Palavras-chave no início** para que os termos de busca mais importantes venham primeiro
***
## 🔒 Segurança de envio
O Listing Agent é deliberadamente "rascunho primeiro". Nada que você gera toca seu anúncio ao vivo até você tomar uma ação explícita.
{% hint style="warning" %}
**Nada é enviado à Amazon até você enviá-lo.** Cada rascunho de IA chega na gaveta Fix como uma **sugestão**, nunca uma mudança aplicada. Seu anúncio ao vivo só muda depois que você abre **Update on Amazon**, marca elementos específicos e clica em **Save**.
{% endhint %}
{% hint style="info" %}
**A Amazon coloca as submissões em fila, ela não as aplica instantaneamente.** Um envio bem-sucedido significa que a Amazon **aceitou a sua submissão em sua fila**. O anúncio é atualizado quando a Amazon termina de validá-lo, e a Amazon ainda pode **rejeitar** uma mudança durante essa etapa. Você verá a confirmação: "Changes submitted to Amazon and queued for processing. Amazon can still reject them during validation."
{% endhint %}
Salvaguardas adicionais em cada envio:
| Salvaguarda | O que ela faz |
| --------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Pré-verificação de política de texto** | Antes de qualquer coisa ser submetida, cada campo é examinado em busca de textos sabidamente problemáticos. Conteúdo bloqueado por política é interrompido localmente e reportado a você, não enviado à Amazon. |
| **Verificação de propriedade do marketplace** | O Agent confirma que o marketplace de destino pertence à sua conta Amazon conectada antes de submeter. |
| **Resultados por campo** | O próprio texto de validação da Amazon é mostrado por campo no modal, então uma falha parcial diz exatamente qual elemento foi recusado e por quê, em vez de um único erro genérico. |
| **Change log** | Cada mudança aplicada é registrada (valor antigo e valor novo), então há uma trilha de auditoria do que foi enviado e quando, e as mudanças podem ser revertidas. |
***
## Listing Agent vs. Listing Quality
Ambas as ferramentas vivem na suíte Listing Manager AI e ambas podem enviar para a Amazon, mas foram feitas para trabalhos diferentes.
| | **Listing Agent** | **Listing Quality** |
| ----------------- | -------------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| **Feito para** | Triagem em massa rápida em muitos anúncios | Trabalho profundo num único anúncio |
| **Escopo** | Todo o catálogo de uma vez, agrupado por severidade | Um produto por vez |
| **Verificações** | Seis sinais de conteúdo por produto | 37 verificações detalhadas com subpontuações |
| **Edição** | Rascunho de IA de um clique por campo, envio em lote | Editor completo, AI Studio, abas de palavras-chave e histórico, ferramentas de imagem |
| **Melhor quando** | Você quer varrer o catálogo e corrigir as piores lacunas rapidamente | Você quer aperfeiçoar um anúncio específico de alto valor |
Use o Agent para encontrar onde está o dano e limpar as lacunas óbvias em massa; entre no [Listing Quality](/pt-or-guia-do-sellermagnet/ferramentas-de-venda/listing-optimizer-overview/listing-quality.md) quando um anúncio precisar de trabalho cuidadoso e detalhado.
***
## ⚠️ Ressalvas
* **Lançamento por conta.** A suíte Listing Manager AI é lançada por conta. Enquanto a sua está pendente, você verá uma ampulheta âmbar ao lado dele no menu Listing-Manager e uma nota "you're on the list" ao abri-lo - sem cobrança até você decidir mantê-lo.
* **Requer uma conta Amazon conectada.** O Agent lê seu catálogo sincronizado e envia através da API da Amazon, então uma conexão Amazon ativa é necessária.
* **Precisa de dados do Listing Quality primeiro.** O escaneamento lê os snapshots mais recentes do Listing Quality. Se nada foi escaneado ainda, preencha os dados a partir do [Listing Quality](/pt-or-guia-do-sellermagnet/ferramentas-de-venda/listing-optimizer-overview/listing-quality.md) antes que o Agent possa mostrar seus produtos.
* **A IA roda com créditos da plataforma, nenhuma chave de API necessária.** A IA usa os próprios modelos do SellerMagnet; você não traz nem paga pela sua própria chave da OpenAI ou Gemini. A redação é retirada de uma **cota mensal de créditos** incluída no seu plano, **compartilhada com o** [**Bulk Sourcer**](/pt-or-guia-do-sellermagnet/ferramentas-de-venda/product-sourcer-overview/bulk-sourcer.md). Se o saldo acabar, o botão Generate para até a cota reabastecer.
***
## ✅ Melhores Práticas
1. **Trabalhe a aba Critical primeiro.** Ela apresenta os anúncios que estão ativamente perdendo conversão e descoberta para você, um título, descrição ou imagens ausentes. Corrigir estes entrega os maiores ganhos reais.
2. **Ordene por receita na sua cabeça.** O Agent classifica por severidade, mas você decide a ordem. Limpe as piores lacunas nos seus ASINs mais vendidos antes da cauda longa.
3. **Sempre leia o rascunho da IA antes de enviar.** Trate cada rascunho como uma forte primeira versão, não uma acabada. Leia-o, ajuste se necessário, depois submeta.
4. **Envie apenas os campos que você gerou.** Marcar Keywords ou Images sem um rascunho por trás não faz nada útil, gere o conteúdo primeiro, ou trate esses campos no Listing Quality.
5. **Re-escaneie após a Amazon processar a mudança.** Um envio é enfileirado, não instantâneo. Re-escaneie depois para confirmar que o campo foi limpo e a pontuação subiu.
6. **Fique de olho no seu saldo de créditos.** A redação gasta da cota mensal compartilhada com o Bulk Sourcer; o saldo restante é mostrado no menu Listing. Veja [quanto custam as ações de IA](/pt-or-guia-do-sellermagnet/ferramentas-de-venda/listing-optimizer-overview.md) para os custos de crédito por ação.
***
## ❓ FAQ
Por que meu Listing Agent está vazio mesmo eu tendo produtos?
O Agent lê o snapshot mais recente do Listing Quality de cada produto, ele não busca dados frescos da Amazon por conta própria. Abra o [Listing Quality](/pt-or-guia-do-sellermagnet/ferramentas-de-venda/listing-optimizer-overview/listing-quality.md), escaneie seus produtos lá, depois volte ao Agent e ele mostrará seu catálogo.
Qual é a diferença entre um problema Critical e um Warning?
Problemas Critical são lacunas que ativamente suprimem conversão ou descoberta, um título ausente, uma descrição ausente ou nenhuma imagem. Warnings são conteúdo que existe mas está fraco (curto demais, ou menos de cinco bullets) e vale a pena melhorar quando você tiver tempo. Um produto com qualquer problema Critical cai no grupo Critical; um apenas com avisos cai em Warnings.
Quais campos o Agent pode redigir com IA?
Title, Bullet Points e Description. O modal de atualização também lista Keywords e Images por completude, mas o botão Generate do Agent não os cria, use o [Listing Quality](/pt-or-guia-do-sellermagnet/ferramentas-de-venda/listing-optimizer-overview/listing-quality.md) e o AI Image Studio para trabalho de imagem e palavras-chave.
Minhas mudanças entram no ar na Amazon imediatamente?
Não. Quando você envia, a Amazon aceita a mudança em sua fila e a aplica após validar, e ela ainda pode rejeitar uma mudança durante essa etapa. O SellerMagnet registra cada submissão e grava os valores antigo e novo para que as mudanças possam ser revertidas. Trate como submeter uma edição no Seller Central, não uma edição instantânea.
A saída da IA é compatível com a Amazon?
Os prompts têm o guia de estilo da Amazon integrado, Title Case, limites de caracteres, sem linguagem promocional, sem emojis ou símbolos proibidos, estrutura com a marca primeiro e palavras-chave no início, então a saída é compatível por construção. Além disso, uma pré-verificação de política de texto examina cada campo em busca de textos sabidamente problemáticos antes de ser submetido.
A IA precisa da minha própria chave da OpenAI ou Gemini, e custa a mais?
Nenhuma chave necessária. A IA roda nos próprios modelos do SellerMagnet e está incluída no seu plano. O uso é retirado de uma cota mensal de créditos que é compartilhada com o Bulk Sourcer. Se o saldo chegar a zero, o botão Generate pausa até a cota reabastecer.
Quando devo usar o Listing Agent em vez do Listing Quality?
Use o Agent para triagem em massa rápida, varrendo todo o catálogo, classificando por severidade e enviando vários anúncios rapidamente. Use o [Listing Quality](/pt-or-guia-do-sellermagnet/ferramentas-de-venda/listing-optimizer-overview/listing-quality.md) quando um único anúncio precisar de trabalho profundo e detalhado com o detalhamento completo de 37 verificações, editor e ferramentas de imagem.
***
## ➡️ O que vem a seguir?
{% content-ref url="/pages/JZZiVAeUhBqMEJ7Ynabt" %}
[Listing Quality](/pt-or-guia-do-sellermagnet/ferramentas-de-venda/listing-optimizer-overview/listing-quality.md)
{% endcontent-ref %}
{% content-ref url="/pages/gMNIdUztU9RscC9hrlZH" %}
[Keyword Research](/pt-or-guia-do-sellermagnet/ferramentas-de-venda/listing-optimizer-overview/keyword-research.md)
{% endcontent-ref %}
{% content-ref url="/pages/MnpWbIzgQZ0bauaQTMxf" %}
[Otimizador de Anúncios](/pt-or-guia-do-sellermagnet/ferramentas-de-venda/listing-optimizer-overview.md)
{% endcontent-ref %}