Product Title Checker (Amazon & eBay)

Valide títulos de produtos da Amazon e eBay de acordo com as políticas oficiais — limites de caracteres, símbolos proibidos, excesso de palavras-chave. Baseado em regras, determinístico, sem chamadas de LLM.

GitHubExperimente este MCPPatrocinado

Documentação

API de Verificação de Título de Produto (MVP)

Esta é uma API de validação de títulos de produtos baseada em regras (sem IA) para vendedores de e-commerce/dropshipping e agentes de IA. Ela verifica, com base nas políticas da Amazon e eBay, contagem de caracteres, expressões proibidas/exageradas, uso excessivo de maiúsculas, keyword stuffing, caracteres especiais, emojis, erros de espaçamento, palavrões, etc. Como não chama LLMs, a resposta é sempre determinística, com baixa latência e custo de execução quase zero.

Como executar

pip install -r requirements.txt
uvicorn main:app --host 0.0.0.0 --port 8000

Quando o servidor estiver no ar, você pode testar diretamente na interface Swagger UI em http://localhost:8000/docs.

Endpoints

`POST /check` — Validação individual

`POST /check/batch` — Validação em lote (máx. 100 itens)

Fontes das regras e nível de confiança (pesquisa em 12/07/2026)

A tabela abaixo especifica de onde veio cada regra e o quão confiável ela é. "Método de verificação" refere-se à forma como a regra foi validada por meio de busca na web/fetch.

Amazon

Regra	Valor	Confiança	Método de verificação
Limite de caracteres	75 caracteres (previsto para 27/07/2026; até lá, 200 caracteres)	Confirmado oficialmente	Anúncio oficial da conta `News_Amazon` da Amazon no fórum Seller Central ("Updates to improve your product titles begin on July 27") verificado diretamente via web_search. Data do anúncio: 10/06/2026. URL: `sellercentral.amazon.com/seller-forums/discussions/t/145b6d0f-999c-4555-896c-c694bda2e470`
Limite de 200 caracteres (política antiga, em vigor desde 21/01/2025)	200 caracteres	Confirmado oficialmente	Anúncio de 21/01/2025 da mesma conta (`News_Amazon`) verificado via web_search. URL: `sellercentral.amazon.com/seller-forums/discussions/t/b2b15728-0d43-453e-974f-59eb63f73059`
Caracteres especiais proibidos `! $ ? _ { } ^ ¬ ¦` (exceção para nomes de marca)	Lista	Verificação cruzada (fetch direto falhou)	A página oficial do Seller Central (`Product title requirements and guidelines`) exige login, então o fetch direto não foi possível. Em vez disso, a mesma lista de caracteres foi citada como "anúncio oficial do Seller Central da Amazon" em duas fontes independentes de consultoria para vendedores (ex.: fecoms.com). Atenção: recomendamos comparar com o texto original após o login
Proibido repetir a mesma palavra mais de 2 vezes (exceto preposições, artigos e conjunções)	Máx. 2 vezes	Verificação cruzada (fetch direto falhou)	Confirmado nas mesmas fontes acima. Não foi possível comparar diretamente com o texto oficial
Novo campo Item Highlights (125 caracteres)	—	Confirmado oficialmente	Mencionado no anúncio oficial da conta News_Amazon. Apenas para referência (a API atual valida apenas o título; Item Highlights não é suportado)

eBay

Regra	Valor	Confiança	Método de verificação
Limite de caracteres	80 caracteres	Confirmado oficialmente	Página oficial do eBay `export.ebay.com/en/growth/promotion-strategies/how-to-optimize-your-listings/` acessada diretamente via web_fetch. Texto original: "According to eBay rules, you can use only 80 characters"
Evitar palavras inteiras em maiúsculas	— (aviso)	Confirmado oficialmente	Texto da mesma página oficial: "avoid writing entire words in capital letters or with asterisks and other markers between words"
Proibido usar asteriscos (`*`) e outros marcadores entre palavras	`*`	Confirmado oficialmente	Verificado na mesma frase acima
Proibido usar palavras-chave com ponto de interrogação (`?`)	`?`	Confirmado oficialmente	Página oficial de políticas do eBay `ebay.com/help/policies/listing-policies/search-browse-manipulation-policy?id=4243` acessada diretamente via web_fetch. Texto original: "Listings can't include keywords with question marks, as this can be misleading for buyers"
Proibido usar palavras-chave irrelevantes ao produto (spam)	—	Confirmado oficialmente (não implementado na API atual)	Verificado na mesma página de políticas acima. No entanto, determinar se uma palavra-chave é "irrelevante ao produto" é difícil de automatizar com regras, então não foi incluído neste MVP — pode ser expandido futuramente com uma abordagem de lista de permissões por categoria

Comum (Amazon/eBay, sem confirmação oficial separada)

Regra	Confiança	Observações
Lista de expressões exageradas (best, guaranteed, free shipping etc.)	Prática geral, não verificado	Ambas as plataformas desencorajam alegações de marketing, mas não foi possível confirmar um documento oficial proibindo palavras individuais. Tratar apenas como aviso informativo
Filtro de palavrões/linguagem vulgar	Prática geral, não verificado	Conjunto mínimo adicionado arbitrariamente pela equipe (12 palavras). Não se trata de um dicionário oficial de palavras proibidas do marketplace; é necessário substituí-lo por um dicionário mais abrangente antes da implantação em produção
Proibição de emojis	Prática geral, não verificado	Um site de terceiros relacionado ao eBay (3dsellers.com) mencionou a "proibição de emojis", mas não foi possível confirmar diretamente na página oficial do eBay

⚠️ Limitações e pontos a revalidar

A lista de caracteres especiais da Amazon e a regra de repetição de palavras foram validadas por verificação cruzada de fontes secundárias, e não pela leitura direta da página oficial. Se você tiver acesso ao login do Seller Central, recomendamos comparar com o texto original da página Product title requirements and guidelines.
As listas de expressões exageradas/palavrões são estimativas baseadas em práticas gerais do setor, e não dicionários oficiais de palavras proibidas. É essencial validá-las separadamente antes da implantação em produção.
A regra dos 75 caracteres da Amazon entrará em vigor em 27/07/2026 (atualmente estamos em período de transição). Recomendamos revalidar se a regra será realmente aplicada após essa data.
Como as políticas das duas plataformas mudam com frequência, recomendamos, conforme discutido anteriormente, verificar a diferença (diff) das páginas oficiais cerca de uma vez por semana e revisar manualmente apenas quando houver alterações.

Método de atualização de políticas (sem automação — escolha intencional)

Na prática, verificamos que as políticas de título da Amazon/eBay mudam com pouca frequência (Amazon: 01/2025 → 07/2026, intervalo de cerca de um ano e meio). Com essa frequência, criar e manter um script de detecção automática seria um investimento excessivo. Por isso, adotamos verificações manuais trimestrais.

Como funciona

Adicione um lembrete trimestral no calendário ("Verificar políticas de título Amazon/eBay")
Ao receber o lembrete, abra as páginas oficiais abaixo no navegador e faça uma revisão rápida (5 a 10 minutos)
Se houver alterações → envie as mudanças para o Claude e solicite a atualização de rules.py
Baixe o arquivo atualizado e faça o reimplantação no servidor/hospedagem (este projeto é um arquivo de trabalho separado da API implantada; a reimplantação é sempre manual)

Páginas oficiais para verificação

Plataforma	Página
Amazon	Seller Central > Ajuda > "Product title requirements and guidelines" (requer login)
Amazon	Publicações da conta `News_Amazon` nos Fóruns de Vendedores (públicas, `sellercentral.amazon.com/seller-forums`)
eBay	`ebay.com/help/policies/listing-policies/search-browse-manipulation-policy`
eBay	`export.ebay.com/en/growth/promotion-strategies/how-to-optimize-your-listings/`

Por que abandonamos a automação

A raspagem automática apresenta risco de bloqueio por bot (WAF), o que reduz a confiabilidade
A baixa frequência de mudanças não justifica o benefício da detecção em tempo real (mesmo com atraso de até 3 meses, a API não passa a emitir julgamentos incorretos em massa; ela continua funcionando normalmente em um estado "quase atualizado, mas não 100%")
A verificação manual no navegador elimina o risco de bloqueio e não exige infraestrutura adicional (cron, configuração de e-mail etc.)

Como implantar no Render

O arquivo render.yaml já está incluído, então a implantação pode ser feita com alguns cliques no painel.

1. Enviar o código para o GitHub (o Render usa repositórios do GitHub)

cd title_checker
git init
git add .
git commit -m "Product Title Checker API - initial commit"

Crie um novo repositório no GitHub (ex.: product-title-checker) e faça o push com os comandos indicados:

git remote add origin https://github.com/본인계정/product-title-checker.git
git branch -M main
git push -u origin main

2. Implantar no Render

Cadastre-se em render.com (é possível entrar com a conta do GitHub)
No painel, escolha New > Blueprint
Selecione o repositório do GitHub que você acabou de criar → o Render reconhecerá automaticamente o render.yaml e preencherá os comandos de build/execução
Clique em Apply → o build e a implantação serão concluídos em poucos minutos
Após a implantação, será gerada uma URL pública, como https://product-title-checker-xxxx.onrender.com

3. Verificar a implantação

curl https://받은-URL.onrender.com/
curl -X POST https://받은-URL.onrender.com/check \
  -H "Content-Type: application/json" \
  -d '{"title": "Wireless Earbuds", "platform": "amazon"}'

Quando essa URL estiver disponível, envie-a para o Claude para verificar se está funcionando corretamente.

Observação: características do plano gratuito do Render

Sem tráfego, o serviço entra automaticamente em modo de suspensão; a primeira solicitação pode levar dezenas de segundos para reiniciar (isso é aceitável na fase inicial de testes na listagem do RapidAPI, mas, com o aumento de usuários pagantes, será necessário considerar um plano pago)
O plano gratuito oferece 750 horas mensais (praticamente suficiente para manter o serviço sempre ativo)

Conecte-se via MCP (para agentes de IA)

Esta API é exposta automaticamente como um servidor MCP (Model Context Protocol) por meio do RapidAPI, permitindo que agentes de IA (Claude, Cursor etc.) a chamem diretamente como uma ferramenta, sem necessidade de código de integração personalizado.

Adicione isto à configuração do seu cliente MCP:

{
  "mcpServers": {
    "Product Title Checker": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.rapidapi.com",
        "--header", "x-api-host: product-title-checker.p.rapidapi.com",
        "--header", "x-api-key: YOUR_RAPIDAPI_KEY"
      ]
    }
  }
}

Substitua YOUR_RAPIDAPI_KEY pela sua própria chave. Obtenha uma assinando (há plano gratuito) em RapidAPI.

Depois de conectado, você pode pedir ao seu agente de IA coisas como:

"Verifique se este título de produto é válido para a Amazon: 'Wireless Earbuds Best Deal!!!'"

e ele chamará /check automaticamente e retornará um resultado estruturado e determinístico.

Estrutura de arquivos

title_checker/
├── main.py       # FastAPI 엔드포인트
├── rules.py       # 규칙 정의 및 검증 로직 (출처는 이 README 참고)
├── requirements.txt
├── render.yaml     # Render 배포 설정 (Blueprint)
├── logo.png        # RapidAPI 리스팅용 로고
└── README.md