Automatize o abastecimento na Vinted com a API, o MCP e os webhooks do Vinotify

Se procura artigos na Vinted para revender, a automatização útil costuma ser simples: mantenha as suas pesquisas guardadas no Vinotify, leve as novas correspondências para o seu próprio fluxo de trabalho e decida por si o que analisar ou comprar. O Vinotify fornece o feed de pesquisa gerido; o seu bot ou agente de código pode tratar do resto da passagem de testemunho.

As integrações estão disponíveis para contas Pro. Incluem tokens bearer associados à conta, um feed de eventos REST, um endpoint MCP direto para agentes compatíveis, webhooks de saída e um feed de eventos duradouro. Comece pela documentação para programadores completa quando estiver pronto para ligar um cliente.

De qual precisa?

Há três formas de entrar, adequadas a tarefas diferentes. Escolha a linha que corresponde ao que está a construir; cada uma remete para o guia que a trata a fundo.

Um fluxo de trabalho de revendedor que se mantém claro

1. Crie pesquisas guardadas para os artigos, marcas, tamanhos, preços e palavras-chave que realmente procura.
2. Crie um token de integração só de leitura em Integrações e guarde-o no seu ambiente local ou no seu gestor de segredos.
3. Descubra as pesquisas ativas e leia depois cada fluxo de eventos a partir de um cursor guardado.
4. Elimine duplicados com event_id, transforme uma correspondência num registo seu de inventário ou de revisão e abra o URL da Vinted quando quiser analisá-la.

A entrega de eventos é feita pelo menos uma vez. Isso é útil para um bot resiliente, mas significa que o seu consumidor deve guardar next_cursor e ignorar um event_id repetido que já tenha tratado.

REST para um pequeno poller ou bot

Um agente de código pode construir um pequeno worker em torno de duas chamadas: atualizar as pesquisas ativas com /api/v1/integrations/discovery/v2 e depois fazer long poll em /api/v1/integrations/events?search_id=…&cursor=…&wait=30. A resposta traz os eventos e o cursor seguinte dessa pesquisa.

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

Mantenha um cursor por pesquisa. Se o feed indicar que o cursor expirou, reponha-o com o valor reset_cursor devolvido. Se a API devolver 429, aguarde o tempo indicado em Retry-After; se devolver 503, espere mais tempo sem descartar o cursor guardado.

MCP para um agente de código, em resumo

O MCP é uma boa opção quando quer que um agente consulte os seus alertas em linguagem natural. Aponte um cliente compatível para https://vinotify.me/api/v1/mcp e adicione o token bearer na configuração local desse cliente. As ferramentas de leitura são list_searches, get_new_items e whats_new.

As ferramentas de escrita são separadas e restritas. Um token pode ser criado com acesso de escrita, e o servidor também tem de ter a função de escrita ativada, antes de um agente poder criar, atualizar, pausar, retomar ou eliminar uma pesquisa. Deixe o token só de leitura, a menos que tenha um motivo claro para delegar alterações às pesquisas.

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

A configuração dos clientes, a lista completa de ferramentas e o modelo de tokens estão em ligar o servidor MCP do Vinotify a ferramentas de IA.

Push ou pull, em resumo

O push é a via mais rápida. Defina um destino numa pesquisa Pro com PUT /api/v1/searches/<search_id>/webhook/external-url e o Vinotify envia um POST com um corpo new_items no momento em que uma pesquisa encontra algo. O destino tem de ser um endpoint HTTPS público, e o Vinotify verifica-o tanto quando o guarda como novamente antes de cada entrega.

O push funciona, no entanto, em regime de melhor esforço. Não há fila de novas tentativas, por isso, se o seu recetor estiver em baixo, a entrega perde-se. O conteúdo fica disponível durante 24 horas em /api/v1/searches/<search_id>/webhook/latest, e o feed de eventos autenticado por bearer em /api/v1/integrations guarda 48 horas de histórico atrás de um cursor. Se não pode dar-se ao luxo de perder um artigo, execute o feed em paralelo com o push e elimine duplicados com event_id.

A estrutura do conteúdo, o comportamento das novas tentativas e exemplos de configuração estão em o guia de automatização com webhooks.

Mantenha o limite bem claro

O Vinotify fornece elementos do anúncio, como a hora de captura, o preço pedido e a moeda, o título, o URL, o id do artigo e os detalhes disponíveis. Não compra artigos, não exige credenciais da Vinted e não transforma um alerta numa venda confirmada. O seu próprio fluxo de trabalho pode pontuar candidatos ou colocá-los em fila, mas mantenha essas decisões separadas do que o evento realmente prova.

Guarde o token fora do controlo de versões, atualize a descoberta à medida que as suas pesquisas mudam e revogue o token em Integrações quando já não precisar dele. Para os parâmetros exatos, limites, campos de resposta e erros, consulte a documentação para programadores do Vinotify.