Zautomatyzuj zakupy na Vinted dzięki API, MCP i webhookom Vinotify

Jeśli kupujesz przedmioty na Vinted z myślą o odsprzedaży, przydatna automatyzacja zwykle jest prosta: trzymaj swoje zapisane wyszukiwania w Vinotify, wczytuj nowe dopasowania do własnego procesu i sam decyduj, co sprawdzić lub kupić. Vinotify dostarcza zarządzany kanał wyszukiwań; Twój bot lub agent programistyczny może zająć się resztą przekazania.

Integracje są dostępne dla kont Pro. Obejmują tokeny bearer przypisane do konta, kanał zdarzeń REST, bezpośredni punkt końcowy MCP dla zgodnych agentów, wychodzące webhooki oraz trwały kanał zdarzeń. Zacznij od pełnej dokumentacji dla programistów, gdy będziesz gotowy podłączyć klienta.

Którego potrzebujesz?

Są trzy sposoby, by zacząć, i pasują do różnych zadań. Wybierz wiersz, który odpowiada temu, co budujesz; każdy prowadzi do poradnika, który omawia temat dokładnie.

Proces odsprzedawcy, który pozostaje zrozumiały

1. Utwórz zapisane wyszukiwania dla przedmiotów, marek, rozmiarów, cen i słów kluczowych, których naprawdę szukasz.
2. Utwórz w sekcji Integracje token integracji tylko do odczytu i trzymaj go w lokalnym środowisku lub w magazynie sekretów.
3. Pobierz aktywne wyszukiwania, a następnie czytaj każdy strumień zdarzeń od zapisanego kursora.
4. Usuwaj duplikaty według event_id, zamień dopasowanie na własny wpis magazynowy lub do weryfikacji i otwórz adres URL Vinted, gdy chcesz je obejrzeć.

Zdarzenia są dostarczane co najmniej raz. To przydatne dla odpornego bota, ale oznacza, że Twój konsument powinien zapisywać next_cursor i ignorować powtórzony event_id, który już obsłużył.

REST dla małego pollera lub bota

Agent programistyczny może zbudować małego workera wokół dwóch wywołań: odświeżyć aktywne wyszukiwania przez /api/v1/integrations/discovery/v2, a następnie wykonać long poll na /api/v1/integrations/events?search_id=…&cursor=…&wait=30. Odpowiedź zawiera zdarzenia i kolejny kursor dla tego wyszukiwania.

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

Trzymaj osobny kursor dla każdego wyszukiwania. Jeśli kanał zgłosi, że kursor wygasł, zresetuj go do zwróconej wartości reset_cursor. Jeśli API zwróci 429, poczekaj czas podany w Retry-After; jeśli zwróci 503, odczekaj dłużej, nie odrzucając zapisanego kursora.

MCP dla agenta programistycznego, w skrócie

MCP sprawdza się, gdy chcesz, by agent przeglądał Twoje alerty zwykłym językiem. Wskaż zgodnemu klientowi adres https://vinotify.me/api/v1/mcp i dodaj token bearer w lokalnej konfiguracji tego klienta. Narzędzia do odczytu to list_searches, get_new_items i whats_new.

Narzędzia zapisu są oddzielne i wąsko zakrojone. Zanim agent będzie mógł utworzyć, zaktualizować, wstrzymać, wznowić lub usunąć wyszukiwanie, token musi zostać utworzony z dostępem do zapisu, a serwer musi mieć włączoną funkcję zapisu. Pozostaw token tylko do odczytu, chyba że masz wyraźny powód, by delegować zmiany w wyszukiwaniach.

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

Konfigurację klientów, pełną listę narzędzi i model tokenów opisujemy w artykule łączenie serwera MCP Vinotify z narzędziami AI.

Push czy pull, w skrócie

Push to najszybsza droga. Ustaw miejsce docelowe dla wyszukiwania Pro przez PUT /api/v1/searches/<search_id>/webhook/external-url, a Vinotify wyśle na nie POST z treścią new_items w chwili, gdy wyszukiwanie coś znajdzie. Miejsce docelowe musi być publicznym punktem końcowym HTTPS, a Vinotify sprawdza je zarówno przy zapisie, jak i ponownie przed każdą dostawą.

Push działa jednak w trybie „najlepszej staranności”. Nie ma kolejki ponowień, więc jeśli Twój odbiorca nie działa, dostawa przepada. Dane pozostają dostępne przez 24 godziny pod adresem /api/v1/searches/<search_id>/webhook/latest, a kanał zdarzeń uwierzytelniany tokenem bearer pod /api/v1/integrations przechowuje 48 godzin historii za kursorem. Jeśli nie możesz sobie pozwolić na pominięcie przedmiotu, uruchom kanał obok pusha i usuwaj duplikaty według event_id.

Strukturę danych, zachowanie przy ponowieniach i przykładowe konfiguracje opisujemy w poradniku o automatyzacji z webhookami.

Zachowaj wyraźną granicę

Vinotify dostarcza dowody dotyczące ogłoszenia, takie jak czas przechwycenia, cena wywoławcza i waluta, tytuł, adres URL, identyfikator przedmiotu i dostępne szczegóły przedmiotu. Nie kupuje przedmiotów, nie wymaga danych logowania do Vinted i nie zamienia alertu w potwierdzoną sprzedaż. Twój własny proces może oceniać kandydatów lub ustawiać ich w kolejce, ale oddziel te decyzje od tego, co zdarzenie faktycznie dowodzi.

Trzymaj token poza kontrolą wersji, odświeżaj discovery, gdy zmieniają się Twoje wyszukiwania, i unieważnij token w sekcji Integracje, gdy przestanie być potrzebny. Dokładne parametry, limity, pola odpowiedzi i błędy znajdziesz w dokumentacji dla programistów Vinotify.