Product Title Checker (Amazon & eBay)

Valida títulos de productos de Amazon y eBay según las políticas oficiales: límites de caracteres, símbolos prohibidos, relleno de palabras clave. Basado en reglas, determinista, sin llamadas a LLM.

GitHubPrueba este MCPPatrocinado

Documentación

API de Verificación de Títulos de Producto (MVP)

Esta es una API de verificación de títulos de productos basada en reglas (sin IA) para vendedores de comercio electrónico/dropshipping y agentes de IA. Verifica la longitud de caracteres, expresiones prohibidas/exageradas, uso excesivo de mayúsculas, relleno de palabras clave, caracteres especiales, emojis, errores de espacios, lenguaje ofensivo, etc., según las políticas de Amazon y eBay. Como no llama a LLM, la respuesta es siempre determinista, con baja latencia y casi sin costo de ejecución.

Cómo ejecutar

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

Una vez que el servidor esté en funcionamiento, puedes probarlo directamente con la interfaz Swagger UI en http://localhost:8000/docs.

Endpoints

`POST /check` — Verificación de un solo elemento

`POST /check/batch` — Verificación por lotes (máximo 100 elementos)

Fuentes de reglas y confiabilidad (investigación al 2026-07-12)

La siguiente tabla especifica de qué fuente proviene cada regla y qué tan confiable es. "Método de verificación" se refiere a la forma en que se validó realmente mediante búsqueda web/fetch.

Amazon

Regla	Valor	Confiabilidad	Método de verificación
Límite de caracteres	75 caracteres (programado para implementarse el 2026-07-27; hasta entonces, 200 caracteres)	Confirmado oficialmente	Se verificó directamente el texto original del anuncio ("Updates to improve your product titles begin on July 27") publicado por la cuenta oficial de Amazon `News_Amazon` en el foro de Seller Central mediante búsqueda web. Fecha del anuncio: 2026-06-10, URL: `sellercentral.amazon.com/seller-forums/discussions/t/145b6d0f-999c-4555-896c-c694bda2e470`
Límite de 200 caracteres (política anterior, implementada el 2025-01-21)	200 caracteres	Confirmado oficialmente	Se verificó mediante búsqueda web el texto original del anuncio del 2025-01-21 de la misma cuenta (`News_Amazon`). URL: `sellercentral.amazon.com/seller-forums/discussions/t/b2b15728-0d43-453e-974f-59eb63f73059`
Caracteres especiales prohibidos `! $ ? _ { } ^ ¬ ¦` (excepción para nombres de marca)	Lista	Verificación cruzada (fetch directo fallido)	La página oficial de Seller Central (`Product title requirements and guidelines`) requiere inicio de sesión, por lo que no se pudo hacer fetch directo. En su lugar, se realizó una verificación cruzada con 2 medios independientes de consultoría para vendedores (como fecoms.com) que citan la misma lista de caracteres como "anuncio oficial de Seller Central de Amazon". Nota: se recomienda comparar directamente con el texto original después de iniciar sesión
Prohibición de repetir la misma palabra más de 2 veces (excluyendo preposiciones, artículos y conjunciones)	Máximo 2 veces	Verificación cruzada (fetch directo fallido)	Confirmado junto con lo anterior en las mismas fuentes. No se pudo comparar directamente con el texto oficial original
Nuevo campo Item Highlights (125 caracteres)	—	Confirmado oficialmente	Especificado en el anuncio de News_Amazon anterior; solo como referencia (la API actual solo verifica el título y no admite Item Highlights)

eBay

Regla	Valor	Confiabilidad	Método de verificación
Límite de caracteres	80 caracteres	Confirmado oficialmente	Se hizo fetch directo de la página oficial de eBay `export.ebay.com/en/growth/promotion-strategies/how-to-optimize-your-listings/`. Texto original: "According to eBay rules, you can use only 80 characters"
Evitar mayúsculas en palabras completas	— (advertencia)	Confirmado oficialmente	Texto original de la misma página oficial: "avoid writing entire words in capital letters or with asterisks and other markers between words"
Prohibición de marcadores entre palabras como asteriscos (`*`)	`*`	Confirmado oficialmente	Confirmado en la misma oración anterior
Prohibición de palabras clave con signos de interrogación (`?`)	`?`	Confirmado oficialmente	Se hizo fetch directo de la página de políticas oficial de eBay `ebay.com/help/policies/listing-policies/search-browse-manipulation-policy?id=4243`. Texto original: "Listings can't include keywords with question marks, as this can be misleading for buyers"
Prohibición de palabras clave no relacionadas con el producto (spam)	—	Confirmado oficialmente (no implementado en la API actual)	Confirmado en la misma página de políticas anterior. Sin embargo, determinar si una palabra clave "no está relacionada con el producto" es difícil de automatizar con reglas, por lo que no se incluye en este MVP; se puede ampliar en el futuro con un método de listas blancas por categoría

Común (tanto Amazon como eBay, sin confirmación oficial separada)

Regla	Confiabilidad	Notas
Lista de expresiones exageradas (best, guaranteed, free shipping, etc.)	Práctica general, no verificada	Ambas plataformas tienden a desaconsejar afirmaciones de marketing, pero no se pudo confirmar un documento oficial que prohíba palabras individuales. Se tratan solo como advertencias informativas
Filtro de lenguaje ofensivo/insultos	Práctica general, no verificada	Conjunto mínimo agregado arbitrariamente en el escritorio (12 palabras). No se trata de un diccionario oficial de palabras prohibidas del marketplace, por lo que debe reemplazarse con un diccionario más completo antes del despliegue real del servicio
Prohibición de emojis	Práctica general, no verificada	Un medio de terceros relacionado con eBay (3dsellers.com) mencionó la "prohibición de emojis", pero no se pudo confirmar directamente en la página oficial de eBay

⚠️ Limitaciones y puntos a re-verificar

La lista de caracteres especiales de Amazon y la regla de repetición de palabras se verificaron mediante verificación cruzada de fuentes secundarias que las citan, no mediante la lectura directa de la página oficial. Si tienes acceso a Seller Central, se recomienda comparar con el texto original de la página Product title requirements and guidelines.
Las listas de expresiones exageradas/lenguaje ofensivo son listas estimadas basadas en prácticas generales de la industria, no diccionarios oficiales de palabras prohibidas. Se requiere una verificación separada obligatoria antes del despliegue real del servicio.
La regla de 75 caracteres de Amazon está programada para implementarse a partir del 2026-07-27 (actualmente es un período de transición). Se recomienda re-verificar si realmente se aplica después de la implementación.
Como las políticas de ambas plataformas cambian con frecuencia, se recomienda, como se discutió anteriormente, revisar las diferencias en las páginas oficiales aproximadamente una vez por semana y que una persona revise solo cuando haya cambios.

Método de actualización de políticas (sin automatización — elección intencional)

Al verificar realmente las políticas de títulos de Amazon/eBay, la frecuencia de cambios es baja (Amazon: 2025-01 → 2026-07, aproximadamente un intervalo de un año y medio). Con esta frecuencia, se determinó que crear y mantener un script de detección automática sería una inversión excesiva de esfuerzo, por lo que se opera con un método de verificación manual trimestral.

Método operativo

Registrar un recordatorio trimestral en el calendario ("Verificar políticas de títulos de Amazon/eBay")
Cuando llegue la notificación, abrir directamente las páginas oficiales a continuación en el navegador y revisarlas (5 a 10 minutos)
Si se encuentran cambios → comunicar los cambios a Claude y solicitar la modificación de rules.py
Descargar el archivo modificado y volver a implementarlo en el servidor/hosting real (este proyecto es un archivo de trabajo separado de la API implementada, por lo que la reimplementación siempre se realiza manualmente)

Páginas oficiales a verificar

Plataforma	Página
Amazon	Seller Central > Ayuda > "Product title requirements and guidelines" (requiere inicio de sesión)
Amazon	Publicaciones de la cuenta `News_Amazon` en los Foros 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 qué se abandonó la automatización

El scraping automático tiene riesgo de bloqueo por bots (WAF), lo que lo hace poco confiable
La frecuencia de cambios es baja, por lo que el beneficio de la detección en tiempo real no es significativo (incluso con un retraso máximo de 3 meses, la API no emite masivamente juicios incorrectos de inmediato; sigue funcionando normalmente en un estado "no completamente actualizado pero casi correcto")
El método de verificación manual en el navegador elimina por completo el riesgo de bloqueo y no requiere mantenimiento de infraestructura adicional (cron, configuración de envío de correos, etc.)

Método de implementación en Render

El archivo render.yaml ya está incluido, por lo que se puede implementar con unos pocos clics desde el panel de control.

1. Subir el código a GitHub (Render se conecta a repositorios de GitHub)

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

Después de crear un nuevo repositorio en GitHub (por ejemplo: product-title-checker), haz push con los comandos indicados:

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

2. Implementar en Render

Regístrate en render.com (puedes iniciar sesión con tu cuenta de GitHub)
En el panel de control, selecciona New > Blueprint
Selecciona el repositorio de GitHub que acabas de crear → Render reconocerá automáticamente render.yaml y completará los comandos de compilación/ejecución
Haz clic en Apply → la compilación e implementación se completarán en unos minutos
Una vez implementado, se te asignará una URL pública como https://product-title-checker-xxxx.onrender.com

3. Verificación de la implementación

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

Si aparece esta URL, puedes pasársela a Claude para verificar juntos que funcione correctamente.

Nota: Características del plan gratuito de Render

Si no hay tráfico, entra automáticamente en modo de suspensión, y la primera solicitud puede tardar decenas de segundos en reiniciarse (Está bien para la fase inicial de pruebas en el listado de RapidAPI, pero si aumentan los usuarios de pago, se debe considerar un plan de pago)
El plan gratuito ofrece 750 horas al mes (prácticamente suficiente para funcionamiento continuo)

Conexión vía MCP (para agentes de IA)

Esta API se expone automáticamente como un servidor MCP (Model Context Protocol) a través de RapidAPI, por lo que los agentes de IA (Claude, Cursor, etc.) pueden llamarla directamente como una herramienta sin código de integración personalizado.

Agrega esto a la configuración de tu 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"
      ]
    }
  }
}

Reemplaza YOUR_RAPIDAPI_KEY con tu propia clave. Obtén una suscribiéndote (hay plan gratuito disponible) en RapidAPI.

Una vez conectado, puedes pedirle a tu agente de IA cosas como:

"Verifica si este título de producto es válido para Amazon: 'Wireless Earbuds Best Deal!!!'"

y llamará a /check automáticamente y devolverá un resultado estructurado y determinista.

Estructura de archivos

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