Automatiza tu abastecimiento en Vinted con la API, el MCP y los webhooks de Vinotify

Si buscas artículos en Vinted para revenderlos, la automatización útil suele ser sencilla: guarda tus búsquedas en Vinotify, lleva las nuevas coincidencias a tu propio flujo de trabajo y decide tú qué revisar o comprar. Vinotify ofrece el feed de búsqueda gestionado; tu bot o tu agente de código puede encargarse del resto del traspaso.

Las integraciones están disponibles para las cuentas Pro. Incluyen tokens bearer vinculados a la cuenta, un feed de eventos REST, un endpoint MCP directo para agentes compatibles, webhooks salientes y un feed de eventos duradero. Empieza por la documentación para desarrolladores completa cuando estés listo para conectar un cliente.

¿Cuál necesitas?

Hay tres formas de entrar, y cada una sirve para un trabajo distinto. Elige la fila que encaje con lo que estás construyendo; cada una enlaza a la guía que la explica a fondo.

Un flujo de trabajo de revendedor que se entiende

1. Crea búsquedas guardadas para los artículos, marcas, tallas, precios y palabras clave que realmente buscas.
2. Crea un token de integración de solo lectura en Integraciones y guárdalo en tu entorno local o en tu gestor de secretos.
3. Descubre las búsquedas activas y lee después cada flujo de eventos desde un cursor guardado.
4. Deduplica con event_id, convierte una coincidencia en tu propio registro de inventario o de revisión y abre la URL de Vinted cuando quieras revisarla.

La entrega de eventos es de al menos una vez. Eso es útil para un bot resistente, pero significa que tu consumidor debe guardar next_cursor e ignorar un event_id repetido que ya haya procesado.

REST para un poller o bot pequeño

Un agente de código puede construir un pequeño worker en torno a dos llamadas: actualizar las búsquedas activas con /api/v1/integrations/discovery/v2 y después hacer long poll sobre /api/v1/integrations/events?search_id=…&cursor=…&wait=30. La respuesta incluye los eventos y el siguiente cursor de esa búsqueda.

Authorization: Bearer $VINOTIFY_TOKEN

GET https://vinotify.me/api/v1/integrations/discovery/v2
GET https://vinotify.me/api/v1/integrations/events?search_id=42&cursor=0-0&wait=30

Guarda un cursor por búsqueda. Si el feed indica que el cursor ha caducado, reinicia con el valor reset_cursor devuelto. Si la API devuelve 429, espera el tiempo indicado en Retry-After; si devuelve 503, espera un poco más sin descartar el cursor guardado.

MCP para un agente de código, en breve

El MCP encaja bien cuando quieres que un agente consulte tus alertas en lenguaje natural. Apunta un cliente compatible a https://vinotify.me/api/v1/mcp y añade el token bearer en la configuración local de ese cliente. Las herramientas de lectura son list_searches, get_new_items y whats_new.

Las herramientas de escritura son independientes y acotadas. Un token puede crearse con acceso de escritura, y además el servidor debe tener activada su función de escritura, antes de que un agente pueda crear, actualizar, pausar, reanudar o eliminar una búsqueda. Deja el token en solo lectura salvo que tengas un motivo claro para delegar cambios en las búsquedas.

{
  "mcpServers": {
    "vinotify": {
      "url": "https://vinotify.me/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

La configuración de los clientes, la lista completa de herramientas y el modelo de tokens se explican en conectar el servidor MCP de Vinotify a herramientas de IA.

Push o pull, en breve

El push es la vía más rápida. Define un destino en una búsqueda Pro con PUT /api/v1/searches/<search_id>/webhook/external-url y Vinotify envía un POST con un cuerpo new_items en el momento en que una búsqueda encuentra algo. El destino debe ser un endpoint HTTPS público, y Vinotify lo comprueba tanto cuando lo guardas como de nuevo antes de cada entrega.

Eso sí, el push funciona con el mejor esfuerzo. No hay cola de reintentos, así que si tu receptor está caído, la entrega se pierde. El contenido sigue disponible durante 24 horas en /api/v1/searches/<search_id>/webhook/latest, y el feed de eventos autenticado con bearer bajo /api/v1/integrations guarda 48 horas de historial tras un cursor. Si no puedes permitirte perder un artículo, ejecuta el feed junto con el push y deduplica con event_id.

La estructura del contenido, el comportamiento de los reintentos y varias configuraciones de ejemplo se explican en la guía de automatización con webhooks.

Mantén claro el límite

Vinotify aporta pruebas del anuncio, como la hora de captura, el precio pedido y la moneda, el título, la URL, el id del artículo y los detalles disponibles. No compra artículos, no exige credenciales de Vinted y no convierte una alerta en una venta confirmada. Tu propio flujo de trabajo puede puntuar candidatos o ponerlos en cola, pero mantén esas decisiones separadas de lo que el evento realmente demuestra.

Guarda el token fuera del control de versiones, actualiza el descubrimiento cuando cambien tus búsquedas y revoca el token desde Integraciones cuando ya no lo necesites. Para conocer los parámetros exactos, los límites, los campos de respuesta y los errores, consulta la documentación para desarrolladores de Vinotify.