Instrukcja użytkownika · serwer MCP · tylko do odczytu

Pytaj swój czat AI o Allegro.
Marzi szuka odpowiedzi.

Marzi to pomocnik, którego podłączasz do Claude, ChatGPT, Claude Code albo Codex. Potem po prostu wpisujesz pytania typu „kto sprzedaje to taniej niż ja?” — a twoje AI czyta prawdziwe strony Allegro i twoje konto Marzi, żeby odpowiedzieć. Nigdy niczego nie zmienia na Allegro. Tylko czyta.

https://mcp.marzi.ai/mcp

To jedyny adres, którego kiedykolwiek potrzebujesz. Wklej go tam, gdzie twoje AI pyta o „serwer MCP” albo „custom connector”.

Co to jest — w minutę

🧠 Twoje AI dostaje oczy

Zwykły czat AI wie tylko to, na czym został wytrenowany. Po podłączeniu Marzi może od razu otwierać aktualne wyniki wyszukiwania Allegro, karty produktów, sklepy sprzedawców i dane twojego sklepu, a potem odczytywać z nich liczby.

🔒 Tylko odczyt, tylko twoje konto

Marzi może patrzeć, ale nie może nic zmieniać: żadnych zmian cen, wiadomości ani zamówień. I widzi tylko to konto Marzi, na które ty się zalogujesz. Żadnych cudzych obserwatorów ani produktów.

👀 Obserwatorzy działają bez ciebie

Powiedz AI „sprawdzaj cenę tego konkurenta co 6 godzin”, a Marzi będzie robić to samodzielnie — nawet gdy twój czat jest zamknięty. Później zapytaj „co się zmieniło?” i dostaniesz listę.

Co ludzie naprawdę wpisują

Przeanalizuj mój sklep na Allegro i powiedz, które 3 rzeczy mam poprawić najpierw.
Kto sprzedaje ten produkt taniej ode mnie, razem z dostawą? https://allegro.pl/oferta/…
Czy „powerbank 20000 mah” to dobry produkt na start sprzedaży? Ile biorą najlepsi sprzedawcy?
Obserwuj tę ofertę i powiedz mi, gdy stan magazynowy spadnie poniżej 5.
Co zrobili moi konkurenci w tym tygodniu?

Połącz — wybierz swoje AI

Połączenie zajmuje około minuty. Logujesz się raz, a AI to zapamięta.

Zanim zaczniesz

  • Konto Marzi — e-mail i hasło, których używasz w serwisie Marzi (utwórz konto; każde nowe konto zaczyna z darmowymi zapytaniami).
  • W panelu sekcja Integracja AI służy do wyboru funkcji, które twoje AI może wywoływać, a w przypadku skryptów także do wygenerowania tokenu osobistego. Jeśli jeszcze nic nie wybierzesz, włączone są wszystkie funkcje.
  • Jeden z klientów poniżej. Aplikacje czatowe i agenci do kodowania logują się przez przeglądarkę — bez client ID, bez secret, bez klucza do wklejania. Skrypty i SDK wysyłają zamiast tego token osobisty.

Adres jest wszędzie ten sam: https://mcp.marzi.ai/mcp. Transport: Streamable HTTP. Stary transport SSE nie jest dostępny.

Strona Integracja AI w panelu: endpoint MCP, przyciski Copy endpoint i Regenerate token oraz wybór klienta z krokami dla każdego z nich
Panel, Integracja AI → Configure & integrate: endpoint do skopiowania, token osobisty dla skryptów i te same kroki co tutaj dla każdego klienta.

Claude.ai i aplikacja desktopowa Claude

  1. W czacie otwórz tools menu (ikona suwaków pod polem wiadomości) i kliknij Add connectors. Ta sama strona jest też w Settings → Connectors (twoje zdjęcie profilowe w lewym dolnym rogu).
    Pole wiadomości Claude z otwartym tools menu: Web search, Drive, Gmail and Calendar search, a niżej Add connectors pod kursorem
    Tools menu pod polem wiadomości: Add connectors na dole.
  2. Na stronie Connectors kliknij Add custom connector.
    Settings → Connectors: lista konektorów oraz przyciski Browse connectors i Add custom connector
    Settings → Connectors → Add custom connector.
  3. Name: Marzi for AI. Remote MCP server URL: https://mcp.marzi.ai/mcp. Zostaw Advanced settings (client ID i secret) puste — Marzi rejestruje się samo. Kliknij Add.
    Okno Add custom connector: nazwa Marzi for AI, URL https://mcp.marzi.ai/mcp, zwinięte Advanced settings, przycisk Add
    Dwa pola — nazwa i adres. Nic w Advanced settings.
  4. Marzi for AI pojawi się na liście jako custom connector. Kliknij Connect: otworzy się strona logowania Marzi — wpisz e-mail i hasło do Marzi, naciśnij Allow. Po powrocie do listy w wierszu będzie Connected.
    Lista Connectors z nowym wierszem: Marzi for AI, etykieta CUSTOM, https://mcp.marzi.ai/mcp i przycisk Connect
    Nowy wiersz. Connect otwiera stronę logowania Marzi.
    Strona logowania Marzi: nazwa aplikacji AI, która prosi o dostęp, zakres read-only, pola e-mail i hasło, przycisk Allow access
    Strona logowania, którą otwiera każdy klient. Pokazuje nazwę aplikacji, która prosi o dostęp, oraz to, co otrzyma — dostęp tylko do odczytu do twojego konta Marzi.
  5. Wróć do czatu, ponownie otwórz tools menu i upewnij się, że Marzi for AI jest włączone.
    Tools menu z Marzi for AI na liście pod Web search, z włączonym przełącznikiem
    Marzi for AI w tools menu, włączone.
  6. Sprawdź, czy działa — zadaj pytanie poniżej. Claude raz zapyta, czy Marzi może uruchomić narzędzie; pozwól na to. Prawdziwa odpowiedź poda sprzedawców z cenami ze strony i powie, kiedy strona została odczytana.
Pokaż, kto sprzedaje https://allegro.pl/oferta/13147824356 i kto ma Buy Box.

Działa w planach Claude Pro, Max, Team i Enterprise. Aplikacja desktopowa współdzieli konektory z claude.ai — konfigurujesz raz.

Po podłączeniu: zobacz, ile to kosztuje

Strona Integracja AI w panelu pokazuje każde żądanie wykonane przez twoje AI — według dnia, funkcji i klienta — razem z ceną w momencie wywołania, liczbą darmowych żądań do wykorzystania i saldem przedpłaty. Ponowne odczytanie tej samej strony w ciągu kilku minut i nieudany odczyt nic nie kosztują. Ustaw tam limit dzienny, jeśli chcesz mieć górną granicę: po jej osiągnięciu wywołania są odrzucane do jutra, a nic więcej się nie zmienia.

Panel Integracja AI: żądania z 30 dni podzielone na płatne, darmowy okres próbny, z pamięci podręcznej i błędy; ruch; koszt; pozostałe żądania; wykres dzienny; ruch i koszt według rodzaju
Panel po kilku dniach używania: żądania płatne, próbne, z pamięci podręcznej i nieudane są liczone osobno — tylko pierwsze kosztują.
Coś nie zadziałało?
  • Strona logowania mówi „zły e-mail lub hasło”. Chodzi o login do Marzi (ten do strony Marzi), a nie login do Allegro ani konto AI.
  • Klient chce identyfikator klienta i sekret. Zostaw je puste — Marzi samo rejestruje klienta podczas łączenia. Tylko klient bez przeglądarki potrzebuje zamiast tego tokena osobistego.
  • Klient oferuje tylko SSE. Marzi obsługuje Streamable HTTP; wybierz „HTTP” / „Streamable HTTP” tam, gdzie klient pyta o transport, albo zaktualizuj klienta.
  • AI mówi, że narzędzie jest niedostępne. Otwórz menu narzędzi / konektorów w czacie i włącz Marzi. W Claude Code wpisz /mcp i sprawdź, czy pokazuje „connected”.
  • Prosi mnie o ponowne zalogowanie. Dostęp jest przyznawany na pewien czas i odnawiany automatycznie; jeśli poprosi, po prostu się zaloguj — nic nie zginęło.
  • Chcę się rozłączyć. Usuń konektor w ustawieniach swojego AI. Marzi zapomni tego klienta w tym samym momencie.

Jak pytać — bank pytań

Skopiuj dowolny z nich, zmień link albo frazę. Chipy pokazują, po które narzędzie sięgnie AI — nie musisz nigdy podawać jego nazwy.

🛒 Zanim kupisz stan magazynowy

Trafiasz na produkt i zastanawiasz się, czy go sprzedawać.

  • Myślę o sprzedaży tego: https://allegro.pl/oferta/… — pokaż mi wszystko, co powinienem wiedzieć przed zakupem stanu magazynowego.
  • Czy ten produkt jest teraz popularny albo był popularny wcześniej? https://allegro.pl/oferta/…
  • Ilu sprzedawców jest na tym produkcie i czy któryś zgarnia większość kupujących?
  • Ile kosztuje wejście w „mata do jogi”: ile opinii, jaka cena, kto dominuje?
  • Znajdź kod kreskowy GTIN/EAN 5904031549871 na Allegro i powiedz mi, kto go sprzedaje i w jakich cenach.
  • Która z tych trzech ofert ma za sobą najmocniejszego sprzedawcę? (wklej trzy linki)

💰 Cennik

Chcesz wiedzieć, jak wypada twoja cena.

  • Kto sprzedaje to taniej niż ja, razem z dostawą? https://allegro.pl/oferta/…
  • Jaki jest realnie najtańszy koszt całkowity dla kupującego ten produkt — produkt plus dostawa?
  • Jeśli wyrównam cenę z Buy Box na tej karcie, o ile będzie niższa od mojej obecnej ceny?
  • Które z moich produktów są o ponad 5% droższe od najtańszej oferty na swojej karcie produktu?
  • Pokaż rozpiętość cen dla „słuchawki bluetooth” — najtaniej, najpopularniej i ile biorą top 10.

🥊 Konkurenci

Jeden sprzedawca, jedna karta produktu albo cały sklep.

  • Kto ma Buy Box na karcie mojego produktu i co robi inaczej (cena, dostawa, Super Sprzedawca)?
  • Czy https://allegro.pl/uzytkownik/… to wiarygodny sprzedawca? Ile ma ocen, czy to firma?
  • Co sprzedaje ten sprzedawca i jakie ma 10 najczęściej kupowanych produktów?
  • Przejdź cały sklep tego sprzedawcy i powiedz mi, ile ma produktów poniżej 50 PLN.
  • Porównaj moją ofertę z liderem karty pod kątem ceny, czasu dostawy i kupujących.
  • Ile sztuk zostało w ofercie konkurenta i co obiecuje jej opis?

🔎 Co widzą kupujący

Wyniki wyszukiwania i strony kategorii takie, jakie są teraz.

  • Co wyskakuje jako pierwsze dla „powerbank 20000 mah”? Które z nich są sponsorowane?
  • Pokaż nowe produkty poniżej 100 zł w tej kategorii, od najnowszych: https://allegro.pl/kategoria/…
  • Wyszukaj trzy frazy naraz — „patelnia”, „patelnia do naleśników”, „patelnia indukcyjna” — i powiedz mi, gdzie powtarzają się te same produkty.
  • Czy Allegro naprawdę dopasowało moją frazę, czy zgadywało? (zapytaj po wyszukaniu)

🏠 Mój sklep

Twoje produkty w Marzi My Products.

👀 Obserwatorzy

Co Marzi ma dalej sprawdzać po zamknięciu czatu.

  • Monitoruj cenę https://allegro.pl/oferta/… co 6 godzin i daj mi znać o zmianach powyżej 5%.
  • Powiedz mi, gdy w tej ofercie zostanie mniej niż 5 sztuk.
  • Ostrzeż mnie, jeśli moje sneakersy spadną o więcej niż 10 miejsc dla „sneakersy męskie big star”.
  • Obserwuj sprzedawcę X na karcie mojego produktu i powiedz mi, jeśli zejdzie poniżej mojej ceny.
  • Co 12 godzin sprawdzaj, czy u tego konkurenta skończył się stan magazynowy.
  • Co moi obserwatorzy wyłapali w ostatnich 24 godzinach?
  • Pokaż moich obserwatorów i ile kosztują miesięcznie. Wstrzymaj cenowych do poniedziałku.
  • Usuń obserwatora GRYJAK-BUY.

🧮 Szacunki (obliczenia Marzi)

Rzeczy, których Allegro nie pokazuje wprost, ale Marzi potrafi je wyliczyć — zawsze oznaczone jako szacunki.

  • Mniej więcej ile sztuk miesięcznie sprzedaje ta oferta i jaka jest wiarygodność tej liczby?
  • Ile mniej więcej przychodu miesięcznie daje ta karta produktu?
  • Jeśli przejmę 10% kupujących z tej karty produktu przy cenie 39.90 PLN, ile to da miesięcznie? Oznacz, co jest faktem, a co twoim wyliczeniem.

Narzędzia — co każde z nich ustala, z przykładami

Nigdy nie wpisujesz nazw narzędzi. Zadajesz pytanie, a AI wybiera narzędzie; ta sekcja pokazuje, co jest możliwe i co zawiera prawdziwa odpowiedź. Każdy blok: czego narzędzie pomaga się dowiedzieć → przykładowe pytanie → co odpowiada AI → JSON otrzymany przez AI (skrócona prawdziwa odpowiedź z 14 Sep 2026) → pola, które warto znać.

szybkie poniżej 2 sekund · wolne Marzi otwiera prawdziwą stronę Allegro, 5–40 sekund (powtórzenia w ciągu kilku minut są natychmiastowe) · działa samo Marzi sprawdza dalej po zamknięciu czatu.

Każda odpowiedź zawiera blok source — skąd pochodzą dane, stronę Allegro, czas (scraped_at), informację, czy dane pochodzą z krótkiej pamięci podręcznej Marzi — oraz note, która przypomina AI, jak czytać liczby. Ceny są zawsze w PLN. null oznacza „Allegro tego nie pokazuje”, nigdy zero.

🔍 Przeglądanie Allegro (strony na żywo)

🔎

Szukaj na Allegro wolno

search_allegro

To, co widzi kupujący, gdy wpisze frazę w wyszukiwarkę Allegro — listing live, karta po karcie. Sortuj tak jak Allegro (trafność, najtańsze, najdroższe, najnowsze, najpopularniejsze), filtruj po cenie i stanie nowe/używane, przechodź kolejne strony za pomocą kursora i odpytaj do pięciu fraz naraz.

Co pomoże ci sprawdzić

  • które produkty pojawiają się na daną frazę i w jakiej kolejności — także które z nich są sponsorowane
  • cena na każdej karcie produktu, informacje o dostawie, sprzedawca i jego % pozytywnych opinii, ile osób kupiło w 30 dni, ocena
  • jak duży jest listing: łączna liczba produktów i ofert oraz ile ma stron
  • czy Allegro naprawdę dopasowało twoją frazę (match_type: MAIN), czy wróciło do luźno powiązanych wyników (FUZZY)

Przykład

Co pojawia się dla „rękawiczki nitrylowe”, najpierw najpopularniejsze? Które z nich są sponsorowane?
„Pasuje 4 395 produktów; pierwsza strona ma 20 kart. Najwyższa pozycja to sponsorowany Medicov 100-pack za 12,99 zł (4 698 osób kupiło w 30 dni, ocena 4,87 z 1 221 ocen) — powtarza się na pozycji 15 jako wynik organiczny. Trzy z pierwszych dziesięciu kart to reklamy…”
Co otrzymała AI (skrócona prawdziwa odpowiedź)
{
 "status": "ok",
 "source": {
  "type": "search",
  "query": "rękawiczki nitrylowe",
  "url": "https://allegro.pl/listing?string=r%C4%99kawiczki%20nitrylowe&order=qd",
  "page": 1,
  "scraped_at": "2026-09-14T19:24:28+00:00",
  "cached": false,
  "page_reads": 1,
  "bytes_read": 1287660
 },
 "currency": "PLN",
 "items": [
  {
   "offer_id": "18135974039",
   "product_id": "1b5a0a6a-7cb7-40e2-a256-c02e4f4653e1",
   "title": "Rękawiczki Nitrylowe CZARNE Jednorazowe Bezpudrowe Medicov Black 100 szt M",
   "url": "https://allegro.pl/oferta/18135974039",
   "category_id": 259899,
   "price": {
    "amount": 12.99,
    "currency": "PLN"
   },
   "original_price": null,
   "price_with_delivery": null,
   "delivery": {
    "free": false,
    "free_return": false,
    "lowest_cost": null,
    "label": "dostawa pojutrze"
   },
   "seller": {
    "login": "MEDICOV",
    "display_name": null,
    "company": true,
    "super_seller": true,
    "positive_feedback_percent": 99.7,
    "storefront_url": "https://allegro.pl/uzytkownik/MEDICOV"
   },
   "flags": {
    "sponsored": true,
    "promoted": true,
    "smart": false,
    "best_price_guarantee": false
   },
   "popularity": {
    "label": "4 698 osób kupiło ostatnio",
    "recent_buyers": 4698,
    "window_days": 30
   },
   "rating": {
    "value": 4.87,
    "count": 1221
   },
   "product_offers_count": 1,
   "parameters": [
    {
     "name": "Rodzaj",
     "value": "nitrylowe"
    },
    "… 4 more"
   ],
   "images": [
    "https://a.allegroimg.com/s360/…",
    "… 11 more"
   ],
   "position": 1,
   "duplicate_of_position": 15
  },
  "… 19 more cards"
 ],
 "next_cursor": "eyJraW5kIjoic2VhcmNo…",
 "has_more": true,
 "page": 1,
 "last_page": 74,
 "total_products": 4395,
 "total_offers": 34181,
 "sort": "popularity",
 "filters": {
  "price_min": null,
  "price_max": null,
  "condition": "all"
 },
 "match_type": "MAIN",
 "note": "Allegro's live search listing at scraped_at. recent_buyers = people who bought in 30 days …"
}

Pola, które warto znać

poleznaczenie
items[].flags.sponsoredtrue = płatne miejsce. Reklamy są na górze i powtarzają się na każdej stronie.
items[].duplicate_of_positionoferta z tej reklamy pojawia się też na tej pozycji na stronie — policz ją raz
items[].popularity.recent_buyersosoby, które kupiły w ostatnich 30 dniach (nie sztuki)
items[].price_with_deliverytylko gdy Allegro to pokazuje; w przeciwnym razie null
items[].seller.login / display_namelogin (używany w linku do sklepu) i nazwa sklepu, którą Allegro pokazuje, gdy jest inna
total_products / total_offers / last_pagerozmiar całego listingu, a nie tej strony
next_cursor / has_moreprzekaż kursor z powrotem, aby pobrać kolejne elementy; null = koniec
match_typeMAIN = rzeczywiste dopasowanie; FUZZY = Allegro zgadło
🗂️

Strona kategorii wolno

get_category_products

Jedna strona kategorii Allegro — taki sam układ kart i filtry jak w wyszukiwaniu, ale start od linku do kategorii zamiast frazy. Dobre do sprawdzenia „co sprzedaje się w tym zakątku Allegro”.

Co pomoże ci sprawdzić

  • najpopularniejsze / najtańsze / najnowsze produkty w kategorii
  • poziomy cen i to, kto jest tam dużym sprzedawcą
  • jak duża jest kategoria (produkty, oferty, strony)

Przykład

Pokaż najpopularniejsze nowe powerbanki poniżej 100 zł w https://allegro.pl/kategoria/powerbanki-252023
„W kategorii jest 31 210 produktów. Po zawężeniu do nowych i poniżej 100 zł najpopularniejsze karty produktu z pierwszej strony to: Xiaomi 20000 mAh za 67,99 zł (1 165 kupujących w 30 dni)…“
Co otrzymała AI (skrócona prawdziwa odpowiedź)
{
 "status": "ok",
 "source": {
  "type": "category",
  "url": "https://allegro.pl/kategoria/powerbanki-252023?order=qd",
  "page": 1,
  "scraped_at": "2026-09-14T18:52:51+00:00",
  "cached": false,
  "page_reads": 1
 },
 "items": [
  "… cards in the same shape as search_allegro"
 ],
 "next_cursor": "…",
 "has_more": true,
 "page": 1,
 "last_page": 100,
 "total_products": 31210,
 "total_offers": 65800,
 "sort": "popularity",
 "filters": {
  "price_min": null,
  "price_max": 100.0,
  "condition": "new"
 }
}

Pola, które warto znać

poleznaczenie
source.urldokładna strona Allegro z zastosowanym sortowaniem i filtrami
filtersco zostało zastosowane — sprawdź, czy zgadza się z twoją prośbą
items[] …te same pola co w search_allegro
🏪

Sklep sprzedawcy wolno

get_seller_products

Wszystko, co wystawia jeden sprzedawca, strona po stronie, z ceną z dostawą z jego sklepu. Posortowane według trafności (własna kolejność sklepu Allegro) da się przejść do ostatniej strony. Posortowane według popularności Allegro podaje tylko pierwszą stronę — taka jest zasada Allegro, więc dla „całego asortymentu tego sprzedawcy według sprzedaży” AI przechodzi sklep w normalnej kolejności i samo sortuje po kupujących.

Co pomoże ci sprawdzić

  • co sprzedaje konkurent i ile produktów wystawia
  • ich bestsellery (pierwsza strona według popularności albo cały sklep posortowany według recent_buyers)
  • ich poziomy cen i warunki dostawy

Przykład

Co sprzedaje https://allegro.pl/uzytkownik/Baseus-Polska i jakie są ich 10 najczęściej kupowanych produktów?
„Sklep ma wystawione 512 produktów (Allegro pokazuje go jako ‘Oficjalny sklep Baseus’). Najlepsze według liczby kupujących w 30 dni: ładowarka 65W GaN za 89.00 PLN (812 kupujących), …”
Co otrzymała AI (skrócona prawdziwa odpowiedź)
{
 "status": "ok",
 "source": {
  "type": "seller",
  "url": "https://allegro.pl/uzytkownik/Baseus-Polska",
  "page": 1,
  "scraped_at": "2026-09-14T18:49:37+00:00",
  "cached": false,
  "page_reads": 1
 },
 "items": [
  {
   "offer_id": "…",
   "title": "Ładowarka Baseus 65W GaN",
   "price": {
    "amount": 89.0,
    "currency": "PLN"
   },
   "price_with_delivery": {
    "amount": 89.0,
    "currency": "PLN"
   },
   "seller": {
    "login": "Baseus-Polska",
    "display_name": "Oficjalny sklep Baseus"
   },
   "popularity": {
    "recent_buyers": 812,
    "window_days": 30
   },
   "…": "…"
  },
  "… 59 more"
 ],
 "next_cursor": "…",
 "has_more": true,
 "page": 1,
 "last_page": 9,
 "total_products": 512,
 "sort": "relevance",
 "note": "One storefront page at scraped_at. … Allegro shows a storefront sorted by popularity on its first page only."
}

Pola, które warto znać

poleznaczenie
total_productsliczba kart produktu sprzedawcy według Allegro
seller.display_namenazwa sklepu pokazywana, gdy różni się od loginu
sorttrafność (można przechodzić dalej) albo popularność (tylko pierwsza strona: has_more true, next_cursor null)
items[].price_with_deliverysklep sprzedawcy to pokazuje, więc zwykle jest tutaj dostępne

Reputacja sprzedawcy wolno

get_seller_profile

To, co publiczne o sprzedawcy: odznaka Super Sprzedawca, udział i liczby pozytywnych/negatywnych ocen z ostatniego roku, czy jest zarejestrowaną firmą i jaka jest jej zweryfikowana nazwa, ile produktów wystawia oraz jego dziesięć najpopularniejszych kart.

Co pomoże ci sprawdzić

  • czy temu sprzedawcy można ufać — procent pozytywnych ocen i ile ocen za tym stoi
  • czy to firma (i jaka), czy osoba prywatna
  • jak duża jest nisza i co sprzedaje się w niej najlepiej

Przykład

Czy https://allegro.pl/uzytkownik/MMFashionCenter to wiarygodny sprzedawca?
„100% pozytywnych z 59 ocen w ostatnim roku (0 negatywnych); zweryfikowana firma, Only Sport Marcin Charko; nie jest Super Sprzedawcą; 216 wystawionych produktów. Jego najczęściej kupowana karta: Nike Air Max Alpha Trainer 5 za 269,99 zł, 314 kupujących w 30 dni.”
Co otrzymała AI (skrócona prawdziwa odpowiedź)
{
 "status": "ok",
 "source": {
  "type": "seller",
  "url": "https://allegro.pl/uzytkownik/MMFashionCenter",
  "scraped_at": "2026-09-14T19:22:50+00:00",
  "page_reads": 2
 },
 "seller": {
  "id": "17954458",
  "login": "MMFashionCenter",
  "name": "MMFashionCenter",
  "company": true,
  "super_seller": false,
  "positive_feedback_percent": 100.0,
  "feedback_count": 59,
  "positive_count": 59,
  "negative_count": 0,
  "company_name": "Only Sport Marcin Charko",
  "company_verified": true,
  "storefront_url": "https://allegro.pl/uzytkownik/MMFashionCenter"
 },
 "products_listed": 216,
 "is_active": true,
 "top_products": [
  {
   "title": "Buty Męskie Sportowe Nike Air Max Alpha Trainer 5 …",
   "price": {
    "amount": 269.99,
    "currency": "PLN"
   },
   "popularity": {
    "recent_buyers": 314,
    "window_days": 30
   },
   "rating": {
    "value": 4.73,
    "count": 335
   }
  },
  "… 9 more"
 ]
}

Pola, które warto znać

poleznaczenie
seller.positive_feedback_percent / positive_count / negative_countdane o ocenach z ostatniego roku w takiej formie, w jakiej pokazuje je Allegro
seller.company_name / company_verifiedzarejestrowana firma stojąca za loginem, jeśli Allegro ją zweryfikowało
seller.super_sellerodznaka Super Sprzedawca
products_listedile kart produktu ma sklep
top_products[]dziesięć kart produktu z pierwszej strony sklepu sprzedawcy według popularności
🏷️

Znajdź po kodzie kreskowym GTIN/EAN wolno

get_product_by_gtin

Wpisz 8–14-cyfrowy kod z opakowania i dostaniesz kartę lub karty produktu Allegro, które Allegro z nim łączy, razem z ich ofertami. Z verify Marzi otwiera oferty i sprawdza kod kreskowy GTIN/EAN wydrukowany na stronie; jeśli kod prowadzi do kilku różnych kart, status to ambiguous i AI nie może zgadywać.

Co pomoże ci sprawdzić

  • która karta produktu na Allegro jest „moim” produktem, bez wyszukiwania po słowach
  • kto sprzedaje dokładnie ten produkt i w jakiej cenie
  • czy kod jest naprawdę opublikowany w ofertach (gtin_verified), czy tylko powiązany przez wyszukiwarkę Allegro

Przykład

Znajdź 6934177716874 na Allegro — która to karta produktu i kto sprzedaje najtaniej?
„Jedna karta produktu: Powerbank Xiaomi 20000 mAh (kod kreskowy GTIN/EAN zweryfikowany na ofercie). Najtańsza widziana oferta: eltrox_pl za 61.94 PLN, sponsorowane, 1,165 kupujących w 30 dni…”
Co otrzymała AI (skrócona prawdziwa odpowiedź)
{
 "status": "ok",
 "source": {
  "type": "gtin",
  "query": "6934177716874",
  "scraped_at": "2026-09-14T19:15:17+00:00",
  "page_reads": 1
 },
 "gtin": "6934177716874",
 "currency": "PLN",
 "matches": [
  {
   "product_id": "a3f2463b-942d-4b10-8d6f-3a7b77621d53",
   "product_url": "https://allegro.pl/produkt/a3f2463b-…",
   "title": "Powerbank Xiaomi 20000 mAh czarny 4x USB, szybkie ładowanie 18W",
   "association": "allegro_search",
   "published_gtin": "6934177716874",
   "gtin_verified": true,
   "offers": [
    {
     "offer_id": "18316404730",
     "price": {
      "amount": 61.94,
      "currency": "PLN"
     },
     "seller": {
      "login": "eltrox_pl",
      "super_seller": true
     },
     "popularity": {
      "recent_buyers": 1165,
      "window_days": 30
     },
     "flags": {
      "sponsored": true
     }
    },
    "… more offers"
   ]
  }
 ],
 "note": "Cards Allegro associates with the code; with verify=true the published GTIN of the offers was read. status=ambiguous means several distinct cards — do not pick one."
}

Pola, które warto znać

poleznaczenie
statusok / not_found (Allegro miało tylko dopasowanie przybliżone) / ambiguous (kilka różnych kart)
matches[].associationjak powiązano kartę: allegro_search = własne dopasowanie Allegro
matches[].published_gtin / gtin_verifiedkod odczytany ze strony oferty i czy jest taki sam jak ten, o który pytasz
matches[].offers[]oferty z tej karty produktu we wspólnym formacie karty
📦

Jedna oferta, podstawy wolno

get_product

Wszystko, co kupujący widzi od razu na stronie oferty: cena i cena z dostawą, koszt i termin dostawy, sprzedawca i jego ocena, ile osób kupiło tę ofertę w 30 dni (i osobno: całą kartę produktu), ocena i opinie, parametry — plus miejsce tej oferty wśród innych sprzedawców tego samego produktu (jej pozycja cenowa, Buy Box, lider).

Co pomoże ci sprawdzić

  • czy ta oferta się sprzedaje i jak wypada na tle innych sprzedawców na karcie produktu
  • łączna cena, którą płaci kupujący (z dostawą), i kiedy przesyłka dotrze
  • jaką część popytu na produkt zgarnia ten sprzedawca (share_of_product_pct)

Przykład

Opowiedz mi o https://allegro.pl/oferta/18861837252 — czy ta oferta się sprzedaje i jak wypada na tle innych?
„Lavazza Qualita Oro 1 kg od GRYJAK-BUY: 69,79 zł, 80,28 zł z dostawą. 2 009 osób kupiło tę ofertę w 30 dni z 3 047 na całej karcie produktu (66%) — jest liderem karty produktu po liczbie kupujących, ale nie ma Buy Box; pozycja cenowa 2 z 60 sprzedających ofert, 0,1% powyżej najtańszej (69,74 zł).”
Co otrzymała AI (skrócona prawdziwa odpowiedź)
{
 "status": "ok",
 "source": {
  "type": "offer",
  "url": "https://allegro.pl/oferta/18861837252",
  "scraped_at": "2026-09-14T19:06:25+00:00",
  "cached": true,
  "page_reads": 0
 },
 "data_source": "live",
 "currency": "PLN",
 "offer_id": 18861837252,
 "product_id": "f6b706a3-217c-4172-b0d6-27e6dce0d969",
 "title": "Kawa ziarnista Arabica Lavazza Qualita Oro 1 kg",
 "brand": "Lavazza",
 "category_path": "Allegro / Supermarket / Produkty spożywcze / Kawa / Kawa ziarnista",
 "price": {
  "amount": 69.79,
  "currency": "PLN"
 },
 "price_with_delivery": {
  "amount": 80.28,
  "currency": "PLN"
 },
 "delivery": {
  "free": false,
  "lowest_cost": 10.49,
  "eta_label": "czw. 17 wrz. w punkcie",
  "handling_label": "2 dni robocze"
 },
 "condition": "new",
 "seller": {
  "login": "GRYJAK-BUY",
  "super_seller": false,
  "positive_feedback_percent": 98.5,
  "feedback_count": 134
 },
 "popularity": {
  "recent_buyers": 2009,
  "window_days": 30
 },
 "product_popularity": {
  "recent_buyers": 3047,
  "window_days": 30
 },
 "share_of_product_pct": 65.93,
 "units_30d": 3579,
 "rating": {
  "value": 4.79,
  "count": 105448,
  "reviews_count": 14113
 },
 "product_offers_count": 489,
 "parameters": [
  {
   "name": "Stan",
   "value": "Nowy"
  },
  "… 26 more"
 ],
 "card": {
  "sellers_on_card": 72,
  "selling_on_card": 60,
  "cheapest_price": 69.74,
  "median_price": 92.45,
  "this_offer_price_rank": 2,
  "premium_over_cheapest_pct": 0.1,
  "holds_buybox": false,
  "leader_seller": "GRYJAK-BUY",
  "leader_share_pct": 24.58,
  "super_sellers_on_card": 47,
  "card_buyers_30d": 8174,
  "card_revenue_estimate": 681611.27
 },
 "estimates": null,
 "notes": [
  "popularity.recent_buyers counts people who bought in the last 30 days, as Allegro displays …",
  "…"
 ]
}

Pola, które warto znać

poleznaczenie
popularity.recent_buyerskupujący, którzy kupili TĘ ofertę w 30 dni
product_popularity.recent_buyerskupujący z całej karty produktu (u wszystkich sprzedawców)
units_30dliczba sztuk, którą Allegro podaje na stronie (pokazują ją tylko niektóre strony; w przeciwnym razie null)
share_of_product_pctkupujący tej oferty jako udział w kupujących z karty produktu
card.this_offer_price_rank / premium_over_cheapest_pctgdzie ta cena plasuje się wśród ofert na karcie
card.holds_buybox / leader_sellerkogo Allegro wyróżnia i kto sprzedaje najwięcej
card.card_revenue_estimateSZACUNEK Marzi (kupujący × cena), nigdy fakt
rating.count vs rating.reviews_countoceny w gwiazdkach a pisemne opinie
🔬

Jedna oferta, wszystko (dogłębna analiza) wolno

get_product_details

Pełna strona oferty: wszystko z get_product plus dokładny stan magazynowy, gdy Allegro pokazuje liczbę, kod kreskowy GTIN/EAN, rozkład ocen gwiazdkowych z wyróżnioną opinią i aspektami opinii, zasady zwrotów i gwarancję, breadcrumbs, pogrupowane parametry, cały opis i zdjęcia w pełnym rozmiarze, nazwę handlową sprzedawcy oraz liczby ocen. AI wywołuje to tylko wtedy, gdy pytasz o którąś z tych rzeczy.

Co pomoże ci sprawdzić

  • ile sztuk zostało (jeśli to widać) — podstawa dla obserwatorów „jak szybko to się sprzedaje”
  • kod kreskowy GTIN/EAN, aby dopasować twój własny produkt
  • co kupujący chwalą albo na co narzekają, gwiazdka po gwiazdce
  • warunki zwrotu i gwarancji

Przykład

Ile sztuk zostało w ofercie https://allegro.pl/oferta/18784227019 i jak wyglądają oceny?
„350 sztuk na stanie (Allegro podaje dokładną liczbę). 46 281 ocen, średnia 4,92: 41 200 pięciogwiazdkowych, 3 400 czterogwiazdkowych… „Trwałość” ma 96% pozytywnych w aspektach opinii. Strona podaje też, że 131 osób kupiło 617 sztuk w 30 dni.”
Co otrzymała AI (skrócona prawdziwa odpowiedź)
{
 "status": "ok",
 "source": {
  "type": "offer",
  "url": "https://allegro.pl/oferta/18784227019",
  "scraped_at": "2026-09-14T19:06:23+00:00",
  "cached": true
 },
 "product": {
  "title": "Rękawice jednorazowe nitrylowe Mercator Medical r. M czarne 100 szt.",
  "price": {
   "amount": 14.64,
   "currency": "PLN"
  },
  "popularity": {
   "label": "131 osób kupiło 617 sztuk",
   "recent_buyers": 131,
   "window_days": 30
  },
  "units_30d": 617,
  "…": "everything get_product gives"
 },
 "stock": {
  "available": 350,
  "exact": true,
  "label": "350 sztuk"
 },
 "gtin": "5906615105510",
 "rating_distribution": {
  "5": 41200,
  "4": 3400,
  "3": 900,
  "2": 300,
  "1": 481
 },
 "featured_review": {
  "rating": 5,
  "text": "Dobre rękawice, mocne…"
 },
 "review_aspects": [
  {
   "name": "Wytrzymałość",
   "positive_pct": 96
  },
  "…"
 ],
 "return_policy": {
  "days": 14,
  "free_return": false
 },
 "warranty": {
  "label": "…"
 },
 "breadcrumbs": [
  "Allegro",
  "Zdrowie",
  "…"
 ],
 "parameter_groups": [
  "…"
 ],
 "description_text": "… up to 20 000 characters …",
 "images_full": [
  "https://a.allegroimg.com/original/…"
 ],
 "seller_extra": {
  "trading_name": "GLOVMED Sp. z o.o.",
  "positive_count": 207,
  "negative_count": 0
 }
}

Pola, które warto znać

poleznaczenie
stock.available / exactliczba sztuk; exact=false oznacza, że Allegro pokazało tylko zakres albo etykietę
gtinkod kreskowy GTIN/EAN podany na stronie
rating_distributionile ocen przypada na każdą gwiazdkę
review_aspects[]co Allegro podsumowuje z opinii (np. trwałość 96% pozytywnych)
return_policy / warrantytak jak podano na stronie
description_textspłaszczone, ograniczone do 20 000 znaków
🥊

Konkurenci na tej samej karcie produktu wolno

get_competitors

Wszyscy sprzedawcy z tej samej karty produktu (strona „wszystkie oferty tego produktu”): ich cena, cena z dostawą, stan magazynowy, kupujący w 30 dni, oznaczenia i informacja, kto ma Buy Box. Sortuj według kolejności na karcie, ceny, ceny z dostawą albo popularności; przy dużych kartach wyniki są podzielone na strony.

Co pomoże ci sprawdzić

  • kto jest tańszy od ciebie — po cenie produktu i po łącznej cenie z dostawą
  • kto ma Buy Box i jak daleko twoja cena jest od jego ceny
  • ile ofert faktycznie się sprzedaje (selling_on_card) i jaki mają stan magazynowy

Przykład

Kto jeszcze sprzedaje https://allegro.pl/oferta/18752936304 i kto jest najtańszy z dostawą?
„60 ofert na karcie, 6 z nich z kupującymi w ostatnich 30 dniach. Najtańsza z dostawą: FunshipTroopers za 55,70 zł (66,19 z dostawą), 98 sztuk na stanie i ma Buy Box…”
Co otrzymała AI (skrócona prawdziwa odpowiedź)
{
 "status": "ok",
 "source": {
  "type": "product_card",
  "url": "https://allegro.pl/oferty-produktu/p-34ab3c29-…",
  "scraped_at": "2026-09-14T19:21:04+00:00",
  "page_reads": 1
 },
 "currency": "PLN",
 "product_id": "34ab3c29-afa5-42b2-a913-17032c04ca88",
 "product_offers_count": 60,
 "selling_on_card": 6,
 "buybox_offer_id": "18752936304",
 "rating": {
  "value": 4.81,
  "count": null
 },
 "product_reviews_count": 140,
 "competitors": [
  {
   "offer_id": "18752936304",
   "url": "https://allegro.pl/oferta/18752936304",
   "seller": {
    "login": "FunshipTroopers",
    "company": true,
    "super_seller": false,
    "positive_feedback_percent": 98.5,
    "feedback_count": 403
   },
   "price": {
    "amount": 55.7,
    "currency": "PLN"
   },
   "price_with_delivery": {
    "amount": 66.19,
    "currency": "PLN"
   },
   "stock": 98,
   "popularity": {
    "recent_buyers": 2,
    "window_days": 30
   },
   "flags": {
    "sponsored": false,
    "promoted": true
   },
   "position_on_card": 1,
   "is_buybox": true
  },
  "… 49 more"
 ],
 "truncated": true,
 "next_cursor": "o:50:price_with_delivery",
 "has_more": true,
 "note": "Offers 1-50 of 60 on one Allegro product card at scraped_at …"
}

Pola, które warto znać

poleznaczenie
product_offers_countoferty na karcie (bez weryfikacji unikalnych sprzedawców)
selling_on_cardoferty z co najmniej jednym kupującym w 30 dni
buybox_offer_id / competitors[].is_buyboxoferta wyróżniana przez Allegro
competitors[].stockpozostałe sztuki, gdy Allegro to pokazuje
competitors[].position_on_cardkolejność, w jakiej Allegro je wyświetla
next_cursor / has_morewięcej ofert poza 50 wyświetlonymi

🏠 Twój sklep (z twojego konta Marzi)

🩺

Przegląd sklepu wolno

analyze_store

Największe narzędzie. Bierze twoje produkty z „Moich produktów” w Marzi, czyta kartę produktu każdego z nich (kto jeszcze go sprzedaje, w jakiej cenie, kto ma Buy Box) oraz widoczność w wyszukiwarce (top 10, poza limitem, w ogóle poza listingiem, spadki), a potem zwraca problemy i okazje w kolejności priorytetu. Przy każdym wniosku podaje konkretne fakty, na których się opiera (pole, wartość, czas), pokazuje obliczenia, sugeruje działanie i mówi, jak bardzo jest go pewne. W środku nie działa żadna AI — dla tych samych danych dostaniesz zawsze tę samą odpowiedź.

Co pomoże ci sprawdzić

  • co poprawić najpierw: zbyt drogie produkty, przegrane Buy Box, produkty niewidoczne w wyszukiwarce, spadki pozycji
  • gdzie masz pole manewru: najtaniej na karcie produktu, sam na karcie produktu, w top 10
  • czego nie da się powiedzieć na podstawie danych (unknowns) — szacunek nigdy nie jest przedstawiany jako liczba zamówień

Przykład

Przeanalizuj mój sklep. Co poprawić najpierw?
„Sprawdzone produkty: 3, odczytane karty: 3. Problemy P2: sneakersów BIG STAR nie ma w listingu dla 1 z 10 śledzonych wyszukiwań (przejrzano całą listę wyników Allegro); 5 wyszukiwań spadło w tym tygodniu… Szansa: patelnia Tefal jest najtańsza z 10 ofert na swojej karcie produktu i nie ma miejsca na kolejną obniżkę ceny. Nie wiadomo: sprzedaż w sztukach — Marzi nie ma danych o zamówieniach.”
Co otrzymała AI (skrócona prawdziwa odpowiedź)
{
 "status": "ok",
 "source": {
  "type": "my_products",
  "cached": true
 },
 "currency": "PLN",
 "summary": {
  "products": 3,
  "assessed": 3,
  "cards_read": 3,
  "queries_monitored": 35,
  "queries_measured": 35,
  "top10": 15,
  "outside_top100": 10,
  "not_in_results": 1,
  "declines": 5,
  "needs_attention": 1,
  "monitors_active": 15,
  "problems_by_priority": {
   "P1": 0,
   "P2": 3,
   "P3": 2
  }
 },
 "problems": [
  {
   "priority": "P2",
   "kind": "not_in_results",
   "product_id": 3,
   "product_title": "SNEAKERSY męskie BIG STAR … NN174282 101 41",
   "problem": "1 of 10 measured searches: Allegro's whole listing was walked and the offer is not in it.",
   "evidence": [
    {
     "field": "get_product_positions.positions[big star nn174282].found / organic_scanned",
     "value": "false / 1 of limit 100",
     "observed_at": "2026-09-14T16:53:39+00:00"
    }
   ],
   "derived": [],
   "recommended_action": "Check whether the phrase matches the offer's title and parameters …",
   "expected_impact": "Presence in the results for those phrases.",
   "confidence": "high"
  },
  "… 4 more"
 ],
 "opportunities": [
  {
   "priority": "P3",
   "kind": "cheapest_on_card",
   "product_id": 2,
   "product_title": "Patelnia do naleśników TEFAL UNLIMITED 25cm …",
   "problem": "The seller's offer is the cheapest item price on a card of 10 offers.",
   "evidence": [
    {
     "field": "get_competitors.competitors[mine].price",
     "value": "129.00 PLN",
     "observed_at": "2026-09-14T19:01:04+00:00"
    },
    "…"
   ],
   "derived": [
    "headroom to the next price = 0.00 PLN"
   ],
   "recommended_action": "Interpretation: … test a small increase only if …",
   "confidence": "medium"
  },
  "… 2 more"
 ],
 "products": [
  {
   "product_id": 4,
   "title": "LAVINIA Elegancka … SUKIENKA …",
   "price": {
    "amount": 129.99,
    "currency": "PLN"
   },
   "card_read": true,
   "card_offers": 1,
   "card_cheapest_price": 129.99,
   "my_price_rank": 1,
   "premium_over_cheapest_pct": 0.0,
   "holds_buybox": true,
   "my_recent_buyers": 11,
   "queries_monitored": 10,
   "top10": 4,
   "outside_top100": 0,
   "not_in_results": 0,
   "declines": 4,
   "avg_sponsored_above": 5.7,
   "status": "needs_attention",
   "findings": [
    "alone_on_card",
    "… 3 more"
   ]
  },
  "… 2 more"
 ],
 "unknowns": [
  "Sales volume, revenue and margin: Marzi has no order data; a buyer counter is people who bought …",
  "…"
 ],
 "cards_read": [
  4,
  2,
  3
 ],
 "note": "Deterministic assessment from My Products, the tracked searches and each product's card …"
}

Pola, które warto znać

poleznaczenie
summaryliczniki na poziomie sklepu: produkty, odczytane karty produktu, śledzone wyszukiwania, top-10, brak w wynikach, spadki, problemy według priorytetu
problems[] / opportunities[]ustalenia, P1 (działaj teraz) → P3; każde ma kind, evidence, derived, recommended_action, expected_impact, confidence
evidence[].field / value / observed_atfakty — które pole narzędzia, jego wartość i kiedy zostało zauważone
products[]pozycja każdego produktu: ranking ceny, dopłata względem najtańszej oferty, Buy Box, liczby dotyczące widoczności, wnioski
unknowns[]czego ta analiza nie była w stanie ustalić — AI powinno ci to powtórzyć
cards_read[]które produkty zużywają odczyt strony (rozliczany według użycia)
📋

Moje produkty szybko

get_my_products

Twoja lista z „My Products” w Marzi (produkty dodane linkiem w panelu) z podsumowaniem widoczności dla każdego produktu: w ilu wyszukiwaniach kupujących jest śledzony, ile z nich umieszcza go w top 10 / 20 / 100, jego średnia i najlepsza pozycja, największy wzrost i spadek od ostatniego sprawdzenia.

Co pomoże ci sprawdzić

  • które z twoich produktów są widoczne, a które nie
  • który wymaga uwagi właśnie teraz (needs_attention)
  • identyfikatory, których AI potrzebuje do pozycji, obserwatorów i sprawdzenia sklepu

Przykład

Wypisz moje produkty i powiedz, które są niewidoczne w wyszukiwarce.
„3 produkty. Sukienka LAVINIA jest śledzona w 10 wyszukiwaniach: w top 10 dla 4, najlepsza pozycja #1 dla „sukienka elegancka wizytowa”, największy spadek −10 miejsc dla „sukienka elegancka” (teraz #25). Sneakersy BIG STAR są poza top 100 w 9 z 10 wyszukiwań…”
Co otrzymała AI (skrócona prawdziwa odpowiedź)
{
 "status": "ok",
 "source": {
  "type": "my_products"
 },
 "currency": "PLN",
 "products": [
  {
   "id": 4,
   "offer_id": 18547900032,
   "url": "https://allegro.pl/oferta/18547900032",
   "title": "LAVINIA Elegancka Klasyczna Wizytowa SUKIENKA …",
   "title_en": "LAVINIA Elegant Classic Dressy DRESS …",
   "brand": "Mabaje",
   "price": {
    "amount": 129.99,
    "currency": "PLN"
   },
   "seller": {
    "login": "womanonline"
   },
   "product_offers_count": 1,
   "status": "active",
   "synced_at": "2026-09-14T16:04:42+00:00",
   "monitoring": {
    "queries_monitored": 10,
    "queries_measured": 10,
    "top10": 4,
    "top20": 6,
    "top100": 10,
    "outside_top100": 0,
    "avg_position": 21.4,
    "best_position": 1,
    "biggest_improvement": {
     "query": "sukienka",
     "delta": 1,
     "position": 44
    },
    "biggest_decline": {
     "query": "sukienka elegancka",
     "delta": 10,
     "position": 25
    },
    "last_checked_at": "2026-09-14T16:56:08+00:00",
    "needs_attention": false
   }
  },
  "… 2 more"
 ],
 "total": 3,
 "next_cursor": null,
 "has_more": false,
 "plan_limit": 10,
 "organic_limit": 100,
 "note": "Products the person added to My Products by link; Marzi does not verify Allegro ownership …"
}

Pola, które warto znać

poleznaczenie
products[].monitoring.top10 / top20 / top100 / outside_top100w ilu śledzonych wyszukiwaniach produkt mieści się w każdym limicie
products[].monitoring.avg_position / best_positionpozycje organiczne (sponsorowane nie są liczone)
products[].monitoring.biggest_decline / biggest_improvementwyszukiwanie z największą zmianą i jej deltą
products[].statusaktywna / wstrzymana / niedostępna (oferta się zakończyła)
plan_limitile produktów może śledzić twój plan
organic_limitjak głęboko Marzi sprawdza (100 wyników organicznych)
📈

Pozycje w wynikach wyszukiwania szybko

get_product_positions

Dla każdego śledzonego wyszukiwania kupującego: twoja pozycja organiczna (miejsce wśród wyników niesponsorowanych, do 100), surowa pozycja z reklamami, ile miejsc sponsorowane było nad tobą, która to strona, zmiana od ostatniego pomiaru, najlepsza pozycja w historii i historia dzień po dniu. Pozycje są mierzone raz dziennie.

Co pomoże ci sprawdzić

  • gdzie dokładnie twój produkt pojawia się dla każdej frazy i czy zmienił pozycję
  • czy reklamy spychają cię niżej (sponsored_above)
  • kiedy „nie znaleziono” oznacza, że listing skończył się przed tobą (not_in_listing), a kiedy po prostu jesteś głębiej niż 100

Przykład

Które z moich produktów spadły w wynikach wyszukiwania w tym tygodniu i czy nad nimi były oferty sponsorowane?
„Sneakersy BIG STAR, „sneakersy męskie big star”: organicznie #93 (surowo #117 — 24 miejsca sponsorowane wyżej), strona 2, bez zmian od wczoraj. Dla „big star nn174282” oferty w ogóle nie ma w listingu: lista wyników Allegro skończyła się po 1 karcie organicznej.”
Co otrzymała AI (skrócona prawdziwa odpowiedź)
{
 "status": "ok",
 "source": {
  "type": "my_products"
 },
 "organic_limit": 100,
 "products": [
  {
   "product_id": 3,
   "offer_id": 18803353421,
   "title": "SNEAKERSY męskie BIG STAR … NN174282 101 41",
   "price": {
    "amount": 109.99,
    "currency": "PLN"
   },
   "status": "active",
   "monitoring": {
    "queries_monitored": 10,
    "top10": 0,
    "top100": 1,
    "outside_top100": 9,
    "avg_position": 93.0,
    "needs_attention": false
   },
   "positions": [
    {
     "query_id": 31,
     "query": "sneakersy męskie big star",
     "measured": true,
     "found": true,
     "position": 93,
     "raw_position": 117,
     "sponsored_above": 24,
     "page": 2,
     "previous_position": 93,
     "previous_at": "2026-09-13T16:53:09+00:00",
     "change": "same",
     "change_delta": 0,
     "best_position": 93,
     "last_checked_at": "2026-09-14T16:53:14+00:00",
     "next_check_at": "2026-09-15T16:53:14+00:00",
     "organic_scanned": 93,
     "not_in_listing": null,
     "history": [
      {
       "at": "2026-09-14T16:53:14+00:00",
       "found": true,
       "position": 93,
       "raw_position": 117,
       "sponsored_above": 24,
       "page": 2
      },
      "… 1 more"
     ]
    },
    {
     "query_id": 32,
     "query": "big star nn174282",
     "measured": true,
     "found": false,
     "position": null,
     "organic_scanned": 1,
     "not_in_listing": true,
     "…": "…"
    },
    "… 8 more"
   ]
  }
 ],
 "unresolved": [],
 "note": "Organic position = rank among non-sponsored results within the first organic_limit; null = not found …"
}

Pola, które warto znać

poleznaczenie
positions[].positionpozycja w wynikach organicznych; null = nie znaleziono w ramach organic_limit
positions[].raw_position / sponsored_abovepozycja w wynikach wyszukiwania z uwzględnieniem sponsorowanych i liczba sponsorowanych powyżej
positions[].change / change_delta / previous_positionzmiana od poprzedniego pomiaru
positions[].not_in_listingtrue = cały listing został przejrzany i nie ma w nim oferty; false = jest poza limitem; null = nie wiadomo
positions[].organic_scannedile organicznych kart produktu przeszedł Marzi
positions[].history[]codzienne pomiary (z include_history)
🌍

Przegląd rynku wolno

get_market_overview

To nie jest strona live — to tygodniowy indeks Marzi dla całego rynku na daną frazę: ile podobnych produktów się sprzedaje, łączna liczba kupujących, szacunek przychodu (GMV), poziomy cen, koncentracja (czy top 10 zgarnia wszystko?), ile opinii potrzebujesz, żeby wejść do top 10, indeksy konkurencji i dostępności. Opatrzone datą as_of — AI musi powiedzieć, którego tygodnia dotyczy.

Co pomoże ci sprawdzić

  • czy warto wejść w ten rynek i jak jest duży
  • kto w niej dominuje i w jakiej cenie
  • jak trudno wejść (bariera opinii, udział płatnych wyników, trudność wejścia)

Przykład

Czy warto wejść w rynek czarnych rękawic nitrylowych 100 szt.? Kto dominuje?
„Indeks z 11 wrz 2026: sprzedaje się 6 podobnych kart, 6 242 kupujących w 30 dni, szacunek GMV ~159 tys. zł. Jedna karta (Mercator Medical, 24,95 zł, 5 905 kupujących, Buy Box Orgellax) zgarnia prawie wszystko; żeby wejść do top 10, potrzebowałbyś ~46 opinii; trudność wejścia: wysoka.”
Co otrzymała AI (skrócona prawdziwa odpowiedź)
{
 "status": "ok",
 "source": {
  "type": "marzi_index",
  "query": "Rękawice nitrylowe czarne 100 szt Mercator M",
  "scraped_at": "2026-09-11"
 },
 "as_of": "2026-09-11",
 "currency": "PLN",
 "understanding": {
  "concept": "Black nitrile gloves, 100 pcs, Mercator M",
  "product_type": "nitrile gloves",
  "brand": "Mercator",
  "categories": [
   {
    "id": 259377,
    "path_en": "Tools / Protective & Work Clothing / Gloves"
   },
   "… 1 more"
  ]
 },
 "market": {
  "similar_products_selling": 6,
  "buyers_30d_total": 6242,
  "gmv_30d_estimate": 158991.92,
  "price_median": 28.49,
  "price_median_buyer_weighted": 24.95,
  "price_p25": 24.95,
  "price_p75": 24.95,
  "top10_revenue_share_pct": 100.0,
  "top5_sellers_share_pct": 100.0,
  "paid_share_top50_pct": 33.3,
  "reviews_to_reach_top10": 46.0,
  "offers_per_top_card": 14.5,
  "competition_index": 69,
  "competition_level": "weak",
  "accessibility_index": 24,
  "entry_difficulty": "high"
 },
 "top_products": [
  {
   "title": "Rękawice jednorazowe nitrylowe Mercator Medical czarne 100 szt.",
   "price": 24.95,
   "buyers_30d": 5905,
   "gmv_30d_estimate": 147329.75,
   "rating": 4.92,
   "reviews_count": 46249,
   "product_offers_count": 634,
   "buybox_seller": "Orgellax",
   "promoted": true
  },
  "… 5 more"
 ],
 "total_matched": 6,
 "note": "Weekly index of Allegro listings dated as_of; product cards, not single offers …"
}

Pola, które warto znać

poleznaczenie
as_oftydzień indeksu — zacytuj go
market.similar_products_selling / buyers_30d_totalwielkość rynku w kartach produktu i kupujących
market.gmv_30d_estimateSZACUNEK przychodu (kupujący × cena)
market.price_median / p25 / p75poziomy cen
market.top10_revenue_share_pct / top5_sellers_share_pctkoncentracja
market.reviews_to_reach_top10 / paid_share_top50_pctbariera opinii i ile miejsc na górze jest sponsorowane
market.competition_index / accessibility_index / entry_difficultywskaźniki Marzi, 0–100, i werdykt
top_products[]najmocniejsze karty produktu z kupującymi, ceną, ofertami i sprzedawcą w Buy Box

Obserwatorzy — Marzi sprawdza za ciebie

Obserwator („monitor” w JSON-ie) to reguła typu „sprawdzaj to co 6 godzin i zapamiętaj, czy coś się zmieniło”. Marzi uruchamia ją według własnego harmonogramu; twój chat AI nie musi być otwarty. Później pytasz „co się zmieniło?” i dostajesz listę zdarzeń.

⏰ Harmonogram

hourly, every 2 hours, every 4 hours, every 6 hours, daily. Częściej niż raz na godzinę się nie da. Obserwatorzy pozycji są zawsze codzienni — Marzi mierzy pozycje w wynikach wyszukiwania raz dziennie.

🎯 Warunek

Cena: dowolna zmiana, zmiana o co najmniej N % / N zł, spadek albo „poniżej mojej ceny”. Stan magazynowy: dowolna zmiana, poniżej N, wyprzedane. Pozycja: spadek / poprawa o N miejsc. Pierwsze uruchomienie tylko zapisuje wartość startową (baseline); zdarzenia zaczynają się od drugiego uruchomienia.

🎟️ Koszt

Każde uruchomienie zużywa operacje z twojego planu (strona, którą Marzi ma już w cache, kosztuje jedną czwartą). Odpowiedź pokazuje estimated_ops_month, zanim się zgodzisz, a usage mówi, ile planu jeszcze zostało. Każdy plan ma też limit liczby obserwatorów.

Typ (type)ObserwujeZapisuje zdarzenieNarzędzie skrótu
product_pricecenę jednej ofertyprice_changedwatch_product_price
product_stockstan magazynowy jednej ofertystock_changed, stock_below, out_of_stockwatch_stock
product_positiontwój produkt we wszystkich śledzonych wyszukiwaniachposition_dropped / position_improvedwatch_product_position
keyword_positiontwój produkt dla jednej frazy wyszukiwaniato samowatch_product_position z keyword
competitor_pricecenę jednego sprzedawcy na tej samej karcie produktucompetitor_price_changed, competitor_below_my_pricewatch_competitor
competitor_stockstan magazynowy jednego sprzedawcy na tej samej karciecompetitor_stock_changedwatch_competitor z watch: stock

Gdy poprosisz dwa razy o tego samego obserwatora, dostaniesz istniejącego (status: "exists") — bez duplikatów. Wstrzymanie zatrzymuje uruchomienia i zostawia historię; wznowienie utrzymuje rytm; usunięcie kasuje obserwatora, jego historię i zdarzenia.

👀 Narzędzia obserwatora po kolei

💸

Obserwuj cenę działa samo

watch_product_price

Sprawdza cenę jednej oferty według harmonogramu i zapisuje zdarzenie, gdy cena się ruszy. Podaj, jak często (co godzinę … codziennie) i co uznawać za zmianę: co najmniej N % albo N zł; bez progu liczy się każda zmiana. Pierwsze uruchomienie zapisuje tylko cenę startową.

Co pomoże ci sprawdzić

  • kiedy konkurent (albo oferta twojego dostawcy) zmienia cenę i o ile
  • historia cen, której nie musiałeś zbierać samodzielnie

Przykład

Monitoruj cenę https://allegro.pl/oferta/18861837252 co 6 godzin i zapisuj zmiany powyżej 5%.
„Gotowe — obserwator #24 „Cena Lavazza Qualita Oro 1kg”: co 6 godzin, uruchamia się przy zmianie o ≥ 5%. Pierwsze sprawdzenie o 15:04 UTC zapisze wartość bazową; to około 120 operacji miesięcznie (5 622 zostały w twoim planie Growth).”
Co otrzymała AI (skrócona prawdziwa odpowiedź)
{
 "status": "created",
 "monitor": {
  "id": 24,
  "name": "Lavazza Qualita Oro 1kg price",
  "type": "product_price",
  "status": "active",
  "tool": "get_product",
  "target": {
   "url": "https://allegro.pl/oferta/18861837252",
   "offer_id": "18861837252"
  },
  "schedule_minutes": 360,
  "condition": {
   "metric": "change",
   "op": "gte_pct",
   "value": 5.0,
   "event": "price_changed"
  },
  "unit": "PLN",
  "ai_analysis": false,
  "estimated_ops_month": 120,
  "created_at": "2026-09-14T15:04:18+00:00",
  "last_run_at": null,
  "next_run_at": "2026-09-14T15:04:18+00:00",
  "last_error": null,
  "current": null,
  "previous": null,
  "executions": 0,
  "events": 0
 },
 "warnings": [],
 "usage": {
  "used": 4377.5,
  "included": 10000,
  "remaining": 5622.5,
  "plan": "growth"
 },
 "note": "Marzi runs the checks on its own schedule; no AI client needs to stay open. The first run records the baseline …"
}

Pola, które warto znać

poleznaczenie
statusutworzono albo istnieje, gdy taki sam obserwator już tam był
monitor.schedule_minutesjak często się uruchamia
monitor.conditionmetryka / op / wartość / zdarzenie — co uruchamia regułę
monitor.estimated_ops_monthile to będzie kosztować z twojego planu
monitor.current / previousostatnie dwie zaobserwowane wartości z czasem ich odczytu oraz informacją, czy strona pochodziła z pamięci podręcznej
monitor.next_run_at / last_errorkiedy uruchomi się następnym razem i czy ostatnie uruchomienie się nie powiodło
usageoperacje wykorzystane / uwzględnione / pozostałe w twoim planie
📉

Obserwuj stan magazynowy działa samo

watch_stock

Sprawdza, ile sztuk zostało w ofercie (głęboki odczyt strony) i uruchamia się przy warunku, który wybierzesz: stock_below N, out_of_stock albo stock_change (dowolna zmiana). „Poniżej N” i „wyprzedane” uruchamiają się, gdy wartość przekroczy granicę, a nie przy każdym uruchomieniu, gdy nadal tam jest.

Co pomoże ci sprawdzić

  • gdy konkurentowi kończy się stan magazynowy — albo go uzupełnił
  • jak szybko sprzedaje się oferta (stan magazynowy spada między sprawdzeniami)

Przykład

Powiedz mi, kiedy https://allegro.pl/oferta/18784227019 zostanie mniej niż 5 sztuk.
„Obserwator #25 „Stan magazynowy rękawic Mercator”: co godzinę, uruchamia się, gdy stan magazynowy spadnie poniżej 5 sztuk. To do 720 operacji miesięcznie — powiedz tylko, a zmienię na co 6 godzin (120).”
Co otrzymała AI (skrócona prawdziwa odpowiedź)
{
 "status": "created",
 "monitor": {
  "id": 25,
  "name": "Mercator gloves stock",
  "type": "product_stock",
  "status": "active",
  "tool": "get_product_details",
  "target": {
   "url": "https://allegro.pl/oferta/18784227019",
   "offer_id": "18784227019"
  },
  "schedule_minutes": 60,
  "condition": {
   "metric": "stock",
   "op": "lt",
   "value": 5,
   "event": "stock_below"
  },
  "unit": "units",
  "estimated_ops_month": 720,
  "next_run_at": "2026-09-14T15:04:19+00:00",
  "current": null,
  "previous": null,
  "executions": 0,
  "events": 0
 },
 "warnings": [],
 "usage": {
  "used": 4377.5,
  "included": 10000,
  "remaining": 5622.5,
  "plan": "growth"
 }
}

Pola, które warto znać

poleznaczenie
monitor.condition.metric / op / valuestock lt 5 = poniżej pięciu; op changed = dowolna zmiana
monitor.unitsztuki
monitor.toolget_product_details — stan magazynowy wymaga głębokiego odczytu, więc każde uruchomienie to odczyt strony, chyba że dane są w cache
🎯

Śledź moją pozycję w wynikach wyszukiwania działa samo

watch_product_position

Twój własny produkt (z My Products) w jednej frazie wyszukiwania — albo we wszystkich śledzonych frazach, jeśli nie podasz słowa kluczowego. Dziennie, bo pozycje są mierzone raz dziennie. Uruchamia się, gdy pozycja organiczna spadnie (albo wzrośnie, jeśli o to poprosisz) o co najmniej N miejsc. Fraza, której Marzi jeszcze nie śledzi, zostanie dla ciebie dodana do My Products.

Co pomoże ci sprawdzić

  • alert, gdy wypadasz z czołówki ważnego wyszukiwania
  • zapis tego, kiedy nastąpił wzrost albo spadek

Przykład

Ostrzeż mnie, jeśli moje sneakersy spadną o więcej niż 10 miejsc dla „sneakersy męskie big star”.
„Obserwator #57: codzienne sprawdzanie produktu #3 dla „sneakersy męskie big star”, uruchamia się przy zmianie o 10 lub więcej miejsc w dowolną stronę. Dzisiejsza pozycja organiczna to #93; pierwsze uruchomienie dziś w nocy ustawi punkt odniesienia.”
Co otrzymała AI (skrócona prawdziwa odpowiedź)
{
 "status": "created",
 "monitor": {
  "id": 57,
  "name": "BIG STAR NN174282 — pozycja sneakersy męskie big star",
  "type": "keyword_position",
  "status": "active",
  "tool": "get_product_positions",
  "target": {
   "url": "https://allegro.pl/oferta/18803353421",
   "offer_id": "18803353421",
   "marzi_product_id": 3,
   "keyword": "sneakersy męskie big star"
  },
  "schedule_minutes": 1440,
  "condition": {
   "metric": "position",
   "op": "moved",
   "value": 10,
   "event": "position_dropped|position_improved",
   "any": [
    "dropped",
    "improved"
   ]
  },
  "unit": "places",
  "estimated_ops_month": 30,
  "next_run_at": "2026-09-14T19:12:44+00:00",
  "current": null,
  "executions": 0,
  "events": 0
 },
 "warnings": [],
 "usage": {
  "used": 4890.0,
  "included": 10000,
  "remaining": 5110.0,
  "plan": "growth"
 }
}

Pola, które warto znać

poleznaczenie
monitor.typekeyword_position (jedna fraza) albo product_position (wszystkie śledzone frazy)
monitor.target.marzi_product_id / keywordktóry produkt i która fraza
monitor.condition.value / anypozycje oraz to, czy uruchamiają się spadki, poprawy albo oba typy zdarzeń
monitor.unitmiejsca
🕵️

Śledź konkurenta działa samo

watch_competitor

Jeden konkretny sprzedawca na tej samej karcie produktu co twoja oferta: jego cena (price_drop, price_change albo below_my_price — porównana z twoją własną ofertą na tej karcie) albo jego stan magazynowy. Podaj sprzedawcę po loginie albo po id jego oferty.

Co pomoże ci sprawdzić

  • gdy sprzedawca, z którym konkurujesz na karcie produktu, schodzi poniżej twojej ceny
  • gdy stan magazynowy spada albo jest uzupełniany

Przykład

Obserwuj GRYJAK-BUY na karcie Lavazza i powiedz mi, jeśli obniży cenę.
„Obserwator #36 na ofercie GRYJAK-BUY karty produktu Lavazza: co 4 godziny, uruchamia się przy każdym spadku ceny. ~180 operacji miesięcznie.”
Co otrzymała AI (skrócona prawdziwa odpowiedź)
{
 "status": "created",
 "monitor": {
  "id": 36,
  "name": "Spadek ceny GRYJAK-BUY Lavazza Qualita Oro 1kg",
  "type": "competitor_price",
  "status": "active",
  "tool": "get_competitors",
  "target": {
   "url": "https://allegro.pl/oferta/18861837252",
   "offer_id": "18861837252",
   "competitor_offer_id": "18861837252",
   "seller_login": "GRYJAK-BUY",
   "my_offer_id": null
  },
  "schedule_minutes": 240,
  "condition": {
   "metric": "change",
   "op": "lt",
   "value": 0.0,
   "event": "competitor_price_changed"
  },
  "unit": "PLN",
  "estimated_ops_month": 180,
  "next_run_at": "2026-09-14T17:31:40+00:00",
  "current": null,
  "executions": 0,
  "events": 0
 },
 "warnings": [],
 "usage": {
  "used": 2921.0,
  "included": 10000,
  "remaining": 7079.0,
  "plan": "growth"
 }
}

Pola, które warto znać

poleznaczenie
monitor.target.seller_login / competitor_offer_idkto jest obserwowany
monitor.target.my_offer_idtwoja oferta na tej samej karcie produktu — potrzebna do below_my_price
monitor.condition.oplt 0 = spadek; changed = dowolna zmiana; below_my = poniżej twojej ceny
monitor.toolget_competitors — strona karty produktu jest odczytywana przy każdym uruchomieniu
🧰

Dowolny obserwator, po twojemu działa samo

create_monitor

Ogólny formularz stojący za czterema skrótami: wybierz type (sześć typów, patrz tabela wyżej), link, harmonogram, progi i warunki, nazwę. AI używa go, gdy twoja prośba nie pasuje do skrótu — na przykład „co 12 godzin” albo warunek łączony.

Co pomoże ci sprawdzić

  • dokładnie taki obserwator, jaki opisałeś, gdy skróty są zbyt wąskie

Przykład

Co 12 godzin sprawdzaj, czy ta oferta jest wyprzedana: https://allegro.pl/oferta/…
„Utworzono obserwator #58: product_stock, co 12 godzin, uruchamia się, gdy stan magazynowy osiągnie 0 (out_of_stock). ~60 operacji miesięcznie.”
Co otrzymała AI (skrócona prawdziwa odpowiedź)
{
 "status": "created",
 "monitor": {
  "id": 58,
  "type": "product_stock",
  "status": "active",
  "tool": "get_product_details",
  "target": {
   "url": "https://allegro.pl/oferta/…",
   "offer_id": "…"
  },
  "schedule_minutes": 720,
  "condition": {
   "metric": "stock",
   "op": "eq",
   "value": 0,
   "event": "out_of_stock"
  },
  "unit": "units",
  "estimated_ops_month": 60,
  "…": "…"
 },
 "warnings": [],
 "usage": {
  "used": 4890.0,
  "included": 10000,
  "remaining": 5110.0,
  "plan": "growth"
 }
}

Pola, które warto znać

poleznaczenie
typeproduct_price / product_stock / product_position / keyword_position / competitor_price / competitor_stock
scheduleco godzinę | co 2 godziny | co 4 godziny | co 6 godzin | codziennie (własna liczba minut ≥ 60)
threshold_percent / threshold_absolute / valuelinia, która to odpala
status: existstaki sam obserwator już istnieje — zwracamy go zamiast kopii

🧾 Zarządzanie obserwatorami i sprawdzanie, co się zmieniło

🗒️

Co się zmieniło? szybko

get_monitor_events

Lista rzeczy, które zauważyli twoi obserwatorzy: dla każdego zdarzenia wartość przed i po, zmiana w jednostkach i procentach, kierunek, kiedy to się stało, jednozdaniowe podsumowanie oraz (jeśli to włączyłeś) krótkie wyjaśnienie AI. Filtruj po jednym obserwatorze, ostatnich N godzinach, typie zdarzenia albo tylko nieprzeczytanych; oznaczaj je jako przeczytane.

Co pomoże ci sprawdzić

  • podsumowanie wszystkiego, co zmieniło się od twojego ostatniego sprawdzenia
  • dokładne liczby sprzed → po dla każdego alertu

Przykład

Co moi obserwatorzy wyłapali w ostatnich 24 godzinach?
„Jedno zdarzenie: stan magazynowy rękawic Mercator spadł z 356 → 350 sztuk (−6, −1.7%) o 16:04 UTC. Brak zdarzeń cenowych. Wszystko inne bez zmian.”
Co otrzymała AI (skrócona prawdziwa odpowiedź)
{
 "status": "ok",
 "events": [
  {
   "id": 1,
   "monitor_id": 25,
   "monitor_name": "Mercator gloves stock",
   "monitor_type": "product_stock",
   "event_type": "stock_changed",
   "severity": "info",
   "triggered_at": "2026-09-14T16:04:47+00:00",
   "previous": 356.0,
   "current": 350.0,
   "change": -6.0,
   "change_percent": -1.69,
   "direction": "down",
   "summary": "units: 356 → 350 (-6, -1.7%)",
   "ai_analysis": null,
   "read": false,
   "target": {
    "url": "https://allegro.pl/oferta/18784227019",
    "offer_id": "18784227019"
   }
  },
  "…"
 ],
 "total": 1,
 "next_cursor": null,
 "has_more": false,
 "note": "Events are written only when a monitor's condition held. change = current - previous …"
}

Pola, które warto znać

poleznaczenie
events[].event_typeprice_changed, stock_changed, stock_below, out_of_stock, position_dropped, position_improved, competitor_price_changed, competitor_below_my_price, …
events[].previous / current / change / change_percent / directionliczby stojące za zdarzeniem
events[].summarykrótki opis po ludzku w jednej linijce
events[].ai_analysisopcjonalne wyjaśnienie (tylko gdy ai_analysis było włączone dla obserwatora)
events[].readczy jest już przez ciebie odczytane; mark_read=true przełącza ten stan
🧾

Wyświetlaj listę, sprawdzaj, zmieniaj, wstrzymuj, wznawiaj, usuwaj szybko

list_monitors

list_monitors pokazuje wszystkich twoich obserwatorów (możesz filtrować po statusie lub typie); get_monitor pokazuje jednego obserwatora w całości, z ostatnimi wartościami; update_monitor zmienia harmonogram, próg lub nazwę; pause_monitor zatrzymuje uruchomienia i zachowuje historię; resume_monitor wznawia na dotychczasowym rytmie; delete_monitor usuwa obserwatora, jego historię i zdarzenia. Wszystkie widzą tylko twoje własne konto — obce id to po prostu „nie znaleziono”.

Co pomoże ci sprawdzić

  • co działa, ile każde kosztuje miesięcznie, kiedy ostatnio się uruchomiło i co ostatnio zobaczyło
  • prosty sposób, żeby dostroić albo wyłączyć obserwatorów

Przykład

Pokaż moich obserwatorów. Wstrzymaj cenowych do poniedziałku i usuń tego dla GRYJAK-BUY.
„4 obserwatorów, wszyscy aktywni. Wstrzymałem #33 i #24 (obserwatory cen; historia zachowana, bez uruchomień do wznowienia). Usunąłem #36 (GRYJAK-BUY) — jego zdarzenia też zniknęły. Wykorzystanie w tym miesiącu: 2 660 z 10 000 operacji.”
Co otrzymała AI (skrócona prawdziwa odpowiedź)
{
 "status": "ok",
 "monitors": [
  {
   "id": 33,
   "name": "Price of https://allegro.pl/oferta/18179200866",
   "type": "product_price",
   "status": "active",
   "schedule_minutes": 1440,
   "condition": {
    "metric": "change",
    "op": "changed",
    "event": "price_changed"
   },
   "unit": "PLN",
   "estimated_ops_month": 30,
   "last_run_at": "2026-09-14T17:17:36+00:00",
   "next_run_at": "2026-09-15T17:17:14+00:00",
   "last_error": null,
   "current": {
    "value": 39.99,
    "observed_at": "2026-09-14T17:17:36+00:00",
    "cache_hit": false
   },
   "previous": null,
   "executions": 1,
   "events": 0
  },
  "… 3 more"
 ],
 "total": 4,
 "next_cursor": null,
 "has_more": false,
 "usage": {
  "used": 2659.75,
  "included": 10000,
  "remaining": 7340.25,
  "plan": "growth"
 }
}

Pola, które warto znać

poleznaczenie
monitors[].statusaktywne / wstrzymane
monitors[].executions / eventsile razy się uruchomił i ile zdarzeń zapisał
monitors[].current.value / observed_at / cache_hitostatnia zaobserwowana wartość, kiedy ją widziano i czy strona pochodziła z pamięci podręcznej (ćwierć operacji)
monitors[].last_errordlaczego ostatnie uruchomienie się nie udało, jeśli tak było — w zamkniętym słowniku błędów
usageoperacje w twoim planie: wykorzystane / uwzględnione / pozostałe

Czytaj liczby tak, żeby nie dać się nabrać

Allegro pokazuje część liczb, a część ukrywa. Marzi przekazuje dokładnie to, co pokazuje Allegro, a resztę oznacza. Dobra odpowiedź od twojej AI używa czterech etykiet:

EtykietaZnaczeniePrzykład
FAKTOdczytane ze strony Allegro albo z twoich danych Marzi, w podanym czasie.„Cena 67,99 zł, odczyt 2026-09-14 19:05.”
WYLICZENIEMatematyka na faktach. Działanie jest pokazane.„Jesteś 14% drożej niż najtańsza oferta: 39,90 / 35,00.”
INTERPRETACJAOpinia albo rada AI. Może być błędna.„Prawdopodobnie warto obniżyć cenę.”
NIEZNANEAllegro tego nie pokazuje i nie ma z czego tego wyliczyć.„Dlaczego Allegro przesunęło ofertę niżej — nieznane.”

Pułapki, po ludzku

👥 „Kupili ostatnio” = ludzie, nie sztuki

Licznik Allegro mówi, ile osób kupiło w ostatnich 30 dniach. Nie ile sztuk i nie za ile pieniędzy.

🧮 Dwie różne liczby „popularności”

Karta produktu ma własny licznik (product_popularity), a każda oferta na niej też ma swój (popularity). AI musi powiedzieć, którą liczbę cytuje.

⭐ Oceny ≠ opinie

rating.count = ile osób zostawiło gwiazdki; reviews_count = pisemne opinie. To różne rzeczy.

🏬 „158 ofert” ≠ 158 sprzedawców

product_offers_count liczy oferty na karcie, nie zweryfikowanych unikalnych sprzedawców. Żeby poznać sprzedawców, sprawdź kartę produktu narzędziem konkurencji.

💰 Cena vs. cena z dostawą

Gdy Allegro pokazuje price_with_delivery, Marzi ją przekazuje; gdy jest null, AI nie może wymyślać łącznej kwoty.

📢 Reklamy się powtarzają

Wyniki sponsorowane (flags.sponsored) są na górze każdej strony i się powtarzają. duplicate_of_position oznacza powtórkę; policzenie jej dwa razy zawyża wszystko.

🔢 Pozycja w wynikach wyszukiwania = widoczność, nie sprzedaż

Bycie #3 dla frazy oznacza, że kupujący widzą cię jako trzecią pozycję wśród wyników niesponsorowanych. Nie mówi to nic o tym, ile osób kupi.

📅 Liczy się „stan na”

Strony live są z teraz (albo z ostatnich kilku minut, jeśli są z cache). Przegląd rynku to tygodniowy indeks — sprawdź as_of.

🚫 null oznacza nieznane, nigdy zero

Jeśli liczby brakuje, AI powinna powiedzieć „nieznane”, a nie „0”.

Zobacz, co Marzi liczy za ciebie — poza tym, co pokazuje Allegro

Allegro nigdy nie pokazuje tekstu „ten sprzedawca sprzedał 617 sztuk w tym miesiącu”. Pokazuje jednak dane, które po połączeniu dają bliski wynik — i Marzi wykonuje tę arytmetykę za ciebie, zawsze oznaczoną jako obliczenie, nigdy jako fakt z Allegro. To duża część tego, co sprawia, że Marzi jest czymś więcej niż czytnikiem stron.

WartośćJak Marzi ją wyliczaJak jest oznaczona
Sprzedane sztuki w 30 dni, dokładnieNa niektórych stronach ofert widać „131 osób kupiło 617 sztuk”. Gdy Allegro podaje ilość, Marzi bierze ją taką, jaka jest.units_30d — FACT ze strony
Sprzedane sztuki w 30 dni, szacunekDla ofert, które Marzi sprawdza codziennie (cele Spy), odczytuje, o ile zmienił się stan magazynowy między sprawdzeniami, i porównuje to z licznikiem kupujących. Stan magazynowy zmienia się też z powodów innych niż sprzedaż, więc każda wartość ma status (poziom wiarygodności) i podstawę (metodę).estimates.sold_30d, sold_24h + *_status, basis — ESTIMATE
Przychód jednej ofertySzacowana liczba sztuk × cena oferty.estimates.revenue_30d — ESTIMATE
Przychód całej karty produktuLicznik kupujących każdej oferty × jej cena, zsumowane w ramach karty.card.card_revenue_estimate — ESTIMATE
Udział sprzedawcy w popycie na produktKupujący tej oferty ÷ kupujący na karcie (oba liczniki pochodzą z Allegro).share_of_product_pct — DERIVED
Wielkość rynkuTygodniowy indeks sumuje liczniki kupujących ze wszystkich podobnych kart i mnoży je przez ich ceny.market.gmv_30d_estimate, buyers_30d_total — ESTIMATE / FACT na tydzień indeksu
Sztuki dla oferty, której Marzi nie śledzi codziennieAI może połączyć kupujących z oferty ze wskaźnikiem sztuk na kupującego widocznym w innych ofertach tej samej karty albo rynku (tam, gdzie Allegro podaje ilości) oraz z sumą dla karty. To własna arytmetyka AI na faktach z Marzi — uczciwy szacunek, który musi być tak opisany.DERIVED przez AI, pokazane z formułą
Jak o to zapytać: „mniej więcej ile sztuk miesięcznie i jak pewne to jest?” Dobra odpowiedź wygląda tak: FACT 2 009 osób kupiło tę ofertę w 30 dni (14 Sep). FACT inna oferta na karcie podaje 617 sztuk dla 131 kupujących ≈ 4,7 sztuki na kupującego. DERIVED ≈ 9 400 sztuk miesięcznie, jeśli proporcja się utrzyma — to orientacyjny szacunek, proporcja pochodzi od jednego innego sprzedawcy. Jeśli odpowiedź podaje liczbę sztuk bez etykiety, zapytaj „czy to z Allegro, czy twoje obliczenie?”

Sprawdź limity, czas oczekiwania i komunikaty błędów

⏱️ Dlaczego czasem działa wolno?

Otwarcie prawdziwej strony Allegro zajmuje 5–40 sekund — Marzi ładuje ją w prawdziwej przeglądarce, tak jak ty. Strony są przez jakiś czas zapamiętywane (strony wyszukiwania przez 10 minut, strony produktów przez 1 godzinę), więc gdy pytasz o to samo drugi raz, odpowiedź jest natychmiastowa.

🎟️ Limit w twoim planie

Każde pytanie, które wymaga odczytania strony, zużywa „operacje” z twojego planu Marzi (zapamiętana strona kosztuje jedną czwartą). Obserwatorzy też zużywają operacje, zgodnie ze swoim harmonogramem. Okres próbny: 300 operacji i 3 obserwatorów miesięcznie; płatne plany mają większe limity. Gdy godzinny limit się wyczerpie, AI dostaje komunikat „spróbuj ponownie za N minut” — nic się nie psuje.

🗺️ Pamiętaj o limitach samego Allegro

Allegro pokazuje maksymalnie 100 stron każdej listy, a sklep sprzedawcy posortowany według popularności tylko na pierwszej stronie. Marzi nie udaje, że jest inaczej — AI powie ci „dalej Allegro już nie pozwala”.

Sprawdź, co oznaczają komunikaty błędów

AI mówi…Co to znaczyCo zrobić
not_an_offerLink nie prowadzi do strony allegro.pl takiego typu, jakiego potrzebuje to narzędzie (albo w ogóle nie prowadzi do allegro.pl — Allegro Lokalnie to inny serwis).Skopiuj link z paska adresu strony Allegro.
not_foundAllegro nie ma już takiej oferty / sklepu / karty albo produktu nie ma na twojej liście Marzi.Sprawdź link; dodaj produkt w Moich produktach Marzi.
allegro_unavailableAllegro w tej chwili nie pokazało tej strony.Odczekaj tyle minut, ile podano, i zapytaj ponownie. Przy długiej liście już odczytane strony zostają zachowane.
rate_limitedGodzinny limit dla tego typu narzędzia został wykorzystany.Poczekaj albo przejdź na wyższy plan.
invalid_inputAI przekazała coś nietypowego (błędne sortowanie, zły kursor strony, 5-cyfrowy „kod kreskowy”).Sformułuj pytanie inaczej; AI zwykle sama to naprawia.
backend_error / backend_timeoutCoś po stronie Marzi chwilowo zadziałało nie tak.Spróbuj ponownie za minutę. Błąd jest zapisany; sprawdzamy każdy taki przypadek.

Zadbaj o bezpieczeństwo w trzech zdaniach

Marzi nie może nic zmienić na Allegro — ani cen, ani listingów, ani wiadomości. Odczytuje publiczne strony i twoje własne dane z Marzi, i tylko tyle mogą zrobić narzędzia.
Tylko twoje konto. AI widzi konto Marzi, na które się zalogowałeś. Obserwatorzy, produkty czy zdarzenia innej osoby po prostu dla niej nie istnieją — pytanie o nie zwraca „nie znaleziono”.
Tytuły produktów nie są poleceniami. Jeśli listing na Allegro zawiera tekst „zignoruj swoje instrukcje”, Marzi przekazuje go jako tekst, a twoja AI dostaje polecenie, żeby traktować go jak tekst.

Najczęściej zadawane pytania

Czy muszę znać nazwy narzędzi?

Nie. Pytaj tak, jak pytasz człowieka. Nazwy na tej stronie są tylko po to, żebyś wiedział, co istnieje i co oznaczają pola JSON.

Czy to działa na telefonie?

Claude: tak — podłączasz raz w webie, a aplikacja Claude na telefonie korzysta z tego samego połączenia. ChatGPT: niestandardowe aplikacje MCP są na razie tylko w wersji web (zasada OpenAI), więc używaj ChatGPT w przeglądarce.

Czy może mi powiedzieć, ile sztuk sprzedał konkurent?

Tak — z etykietą. Gdy Allegro podaje liczbę na stronie, jest to dokładne units_30d. Gdy jej nie podaje, Marzi szacuje liczbę sztuk na podstawie ruchu stanu magazynowego między codziennymi sprawdzeniami (dla ofert, które śledzi) oraz licznika kupujących, ze statusem wiarygodności; AI może też wyliczyć wartość z liczby kupujących w ofercie i liczby sztuk na kupującego widocznej na tej samej karcie produktu lub rynku. Każda taka liczba jest oznaczona jako SZACUNEK albo WYLICZENIE, nigdy jako fakt z Allegro. Zobacz co oblicza Marzi.

Czy mogę sprawdzić liczbę kupujących i przychód całego produktu?

30-dniowy licznik kupujących na karcie produktu to fakt z Allegro (product_popularity). Przychód to szacunek: kupujący × cena dla każdej oferty, zsumowane (card_revenue_estimate); tygodniowy indeks robi to samo dla całego rynku (gmv_30d_estimate).

Dlaczego AI czasem potrzebuje 30–40 sekund?

Otwiera prawdziwą stronę Allegro w przeglądarce, tak jak ty, a niektóre strony (karta produktu z setkami ofert, profil sprzedawcy) wymagają dwóch odczytów. Ponowne pytanie o to samo w ciągu kilku minut działa od razu — strona jest zapamiętana.

Czy obserwatorzy napiszą do mnie e-mailem?

Jeszcze nie. Zapytaj AI „co się zmieniło?” albo spójrz na dzwonek w panelu Marzi. Dostarczanie e-mailem/Slackiem jest planowane.

Ile kosztuje mnie obserwator?

Odpowiedź na każde żądanie obserwatora pokazuje estimated_ops_month (operacje miesięcznie z twojego planu) i usage (ile zostało). Co godzinę na zimnej stronie to drogi wariant (~720 miesięcznie); dziennie to ~30. Strona, którą Marzi ma już w cache, kosztuje jedną czwartą.

Co się stanie, gdy skończy się limit w moim planie?

AI dostaje informację rate_limited wraz z liczbą minut oczekiwania; obserwatorzy pomijają swoje uruchomienie i wracają, gdy limit się odnowi. Nic nie jest usuwane.

Czy mogę używać tego z dwiema aplikacjami AI naraz?

Tak. Każda aplikacja łączy się osobno; obserwatorzy, których tworzysz, są ci sami we wszystkich, bo znajdują się na twoim koncie Marzi.

Czy mój współpracownik może używać mojego konektora?

Nie — konektor jest powiązany z kontem Marzi, które się zalogowało. Daj im ich własny login do Marzi, a połączą się w minutę.

AI podała twierdzenie, którego nie widzę w danych. Co teraz?

Zapytaj: „Z którego wyniku narzędzia to pochodzi?” Dobra odpowiedź podaje pole i czas. Jeśli AI nie potrafi tego wskazać, to była interpretacja — traktuj ją jak opinię.

Dlaczego AI mówi „unknown” zamiast liczby?

Bo Allegro tego nie pokazuje, a Marzi nie będzie zmyślać: sztuki, gdy nie podano ilości i nie ma historii stanu magazynowego, powód zmiany pozycji, marża sprzedawcy. To „nie wiadomo” jest uczciwą odpowiedzią i AI ma polecenie tak odpowiedzieć.

Czy może zmieniać moje ceny albo odpowiadać kupującym za mnie?

Nie. Każde narzędzie jest tylko do odczytu. Nic, co powiesz AI, nie sprawi, że Marzi wykona działanie na Allegro.

Czy Marzi widzi moje hasło do Allegro?

Nie. Marzi nigdy nie loguje się do Allegro w twoim imieniu; czyta publiczne strony. Twoje logowanie do Marzi to jedyne logowanie i prowadzi na własną stronę Marzi, nigdy przez AI.

Czy moje dane są udostępniane dostawcy AI?

AI, którego używasz (Claude, ChatGPT…), dostaje odpowiedzi narzędzi, bo musi je dostać, żeby ci odpowiedzieć — zgodnie z warunkami tego dostawcy. Marzi nie wysyła niczego nikomu innemu.

Który link mam wkleić?

Dowolna strona allegro.pl właściwego typu: oferta (/oferta/…), karta produktu (/produkt/…), sprzedawca (/uzytkownik/…), kategoria (/kategoria/…). Skopiuj ją z paska adresu. Linki do Allegro Lokalnie są odrzucane — to inny marketplace z innymi licznikami.

Login sprzedawcy i nazwa sklepu są różne. Która jest właściwa?

Oba: seller.login to login techniczny (w URL-u sklepu), display_name to nazwa sklepu pokazywana przez Allegro. AI powinno cytować login przy linkowaniu, a nazwę w rozmowie.

Czy może czytać Allegro w innym kraju (allegro.cz, allegro.sk)?

Nie w tej wersji — tylko allegro.pl.

Jak stare są dane?

Strony na żywo: moment, w którym zapytałeś (albo do 10 minut dla strony wyszukiwania, 1 godzina dla oferty/karty, z cache — scraped_at podaje dokładnie). Pozycje Moich produktów: raz dziennie. Przegląd rynku: tygodniowy indeks, datowany as_of.

Gdzie jest dokumentacja techniczna?

Endpoint MCP to https://mcp.marzi.ai/mcp (Streamable HTTP, OAuth 2.1 z dynamiczną rejestracją klienta, PKCE). Health: /health. Każde narzędzie opisuje samo siebie w tools/list; dokumentacja dla developerów jest w repozytorium Marzi w docs/mcp/.