Feed marketplace z Claude Code: od eksportu do walidacji

Feed produktowy na Google Merchant albo marketplace przygotujesz Claude Code w kilku kontrolowanych przejściach: mapujesz kolumny katalogu na pola wymagane przez kanał, uzupełniasz braki tam, gdzie da się je wyprowadzić z danych, walidujesz typy i wartości (ceny, waluta, dostępność, adresy obrazów, jednostki), a na końcu wskazujesz oferty, które kanał odrzuci, zanim w ogóle wgrasz plik. Claude Code to asystent AI pracujący na Twoich plikach w terminalu, więc przekształca realny eksport, a nie tekst w oknie czatu, o czym szerzej piszemy w przewodniku po Claude Code w eCommerce. Warunek jest jeden i wraca w całym tekście: pracujesz na kopii eksportu i przeglądasz każdą różnicę, zanim cokolwiek zapiszesz. Poniżej cały proces i zasady zlecania.

Feed to nie jest ten sam problem co czysty katalog

Łatwo pomylić dwa zadania, które wyglądają podobnie, a rządzą się innymi regułami. Czyszczenie katalogu to porządkowanie źródła: rozbicie wariantów, walidacja kodów, ujednolicenie jednostek i kolorów, usunięcie duplikatów. Opisaliśmy je osobno w tekście o czyszczeniu katalogu CSV i to dobry punkt wyjścia, bo brudnego katalogu żaden feed nie uratuje. Przygotowanie feedu zaczyna się dokładnie tam, gdzie tamto się kończy: masz już czyste dane, ale musisz je przetłumaczyć na język konkretnego kanału. A każdy kanał mówi innym językiem.

Ten sam produkt Google Merchant chce widzieć jako identyfikator, tytuł, opis, link, adres obrazu, dostępność, cenę i GTIN, z kategorią z własnej taksonomii i atrybutami zależnymi od typu produktu. Inny marketplace nazwie te pola inaczej, oczekuje innego formatu ceny albo innej listy kategorii i odrzuci ofertę z powodu, którego Google w ogóle by nie zauważył. Dlatego jeden „uniwersalny” plik nie istnieje. Feed to zawsze przekład katalogu na wymagania jednego, nazwanego kanału, a przekład jest dokładnie tą powtarzalną, żmudną pracą, w której Claude Code jest użyteczny.

Co Claude Code robi z feedem, a czego nie

Różnica między Claude Code a czatem sprowadza się do jednego: czat zwraca tekst, który sam kopiujesz, a Claude Code czyta Twój eksport, proponuje przekształcenia i po Twojej akceptacji zapisuje wynik do pliku. Powtarzalne operacje na tysiącach ofert wykonuje tak samo cierpliwie jak na dziesięciu, i to jest jego realna wartość przy feedach. Nie jest jednak wyrocznią: nie zna Twojego asortymentu lepiej niż Ty, nie wie, do której kategorii kanału należy niejednoznaczny produkt, i nie zgadnie GTIN-u, którego w danych nie ma. Granica jest ostra i warto ją trzymać: Claude Code oznacza i proponuje, a decyzję o wartości, której nie da się wyprowadzić z danych, zostawia Tobie. Poprawnego kodu GTIN ani właściwej kategorii przy wątpliwym produkcie nie wymyśli, i dobrze, bo zmyślona wartość w feedzie to albo dezaprobata, albo cichy błąd, który zobaczysz dopiero po spadku sprzedaży.

Zasada numer jeden: pracuj na kopii i wersjonuj mapowanie

Jak zlecać: wejście i oczekiwane wyjście

Jakość feedu zależy nie od tego, jak „inteligentne” jest narzędzie, tylko od tego, jak precyzyjnie opiszesz przekład. Nie zlecaj „przygotuj feed na Google”, bo dostaniesz cudzą interpretację specyfikacji. Zamiast tego opisz trzy rzeczy: co masz na wejściu (jakie kolumny katalogu, w jakim stanie), jak ma wyglądać wyjście (docelowe pola kanału, ich nazwy, format i separator) oraz reguły przekształcenia (które kolumna katalogu odpowiada któremu polu kanału, jak formatować cenę i walutę, jak mapować dostępność, jak zbudować adres obrazu). Najskuteczniej działa jeden przykład: bierzesz jeden realny wiersz katalogu i piszesz obok, jak ma wyglądać ten sam produkt jako pozycja feedu, pole po polu. Taki przykład mówi więcej niż akapit opisu specyfikacji.

Do tego dokładasz jedno zdanie, które warto powtarzać przy każdym zadaniu: „pokaż mi różnice i oznacz wszystko, czego nie jesteś pewien, zamiast zgadywać”. Ono zamienia ryzykowną automatyzację w kontrolowany proces. Nie prosisz Claude Code o gotowe komendy ani o to, żeby sam zdecydował, co jest wymagane. Prosisz o wykonanie jasno opisanych reguł i o rzetelne oznaczenie wszystkiego, co wymaga Twojej decyzji. Specyfikację pól kanału zawsze bierzesz z oficjalnej dokumentacji danego kanału i to Ty jesteś jej źródłem, bo wymagania i nazwy atrybutów bywają aktualizowane, a narzędzie nie ma powodu znać ich lepiej niż aktualny dokument dostawcy.

Proces krok po kroku

Poniższe kroki układają się w naturalnej kolejności: od mapowania struktury, przez uzupełnianie i walidację, po wykrywanie ofert skazanych na odrzucenie. Rób je przejściami i sprawdzaj różnice po każdym, zamiast puszczać wszystko naraz.

Mapowanie kolumn katalogu na pola kanału

Punkt wyjścia to tabela odwzorowania: która kolumna katalogu trafia do którego pola kanału i w jakiej formie. Podajesz to mapowanie, a Claude Code przepisuje dane do docelowej struktury, zmienia nazwy pól, składa wartości złożone (na przykład tytuł z marki, nazwy i wariantu według Twojej reguły) i pomija kolumny, których kanał nie używa. Sprawdzasz jedno: czy każde pole wymagane przez kanał ma źródło w katalogu, a jeśli nie ma, to jest to pierwsza lista braków do rozwiązania, zanim ruszysz dalej.

Uzupełnianie braków: GTIN, kategoria, atrybuty

Część braków da się wyprowadzić z danych, które już masz, i tu Claude Code pomaga: proponuje kategorię kanału na podstawie kategorii wewnętrznej według Twojego mapowania, uzupełnia atrybuty wyliczalne z innych pól, składa brakujący identyfikator według reguły. Części braków wyprowadzić się nie da i to jest granica, której nie wolno przekraczać. GTIN produktu, który go po prostu nie ma w źródle, albo kategoria przy produkcie niejednoznacznym to wartości do uzupełnienia z prawdziwego źródła, nie do zgadnięcia. Claude Code ma je zebrać w czytelną listę „do decyzji”, a nie wypełnić prawdopodobnie brzmiącą wartością. Zmyślony GTIN nie jest brakiem mniej, jest błędem więcej.

Walidacja typów i wartości

Gdy pola są już na miejscu, sprawdzasz, czy ich zawartość ma sens dla kanału. Cena musi być liczbą w oczekiwanym formacie i z walutą, dostępność jedną z dozwolonych wartości, adres obrazu poprawnym linkiem, a nie ścieżką lokalną, jednostki i wymiary w formacie, którego kanał oczekuje. Claude Code przechodzi feed i oznacza pola, które nie mieszczą się w typie albo dozwolonym zbiorze wartości: cenę zapisaną z przecinkiem tam, gdzie ma być kropka, pustą dostępność, link do obrazu bez protokołu, ujemny albo zerowy stan przy ofercie oznaczonej jako dostępna. To jest przesunięcie błędów w lewo: łapiesz je w pliku, a nie w panelu kanału.

Wykrywanie ofert, które zostaną odrzucone

Ostatnie przejście jest najcenniejsze, bo dotyka pieniędzy. Wiele odrzuceń ma powtarzalne, przewidywalne przyczyny: brak pola wymaganego dla danego typu produktu, konflikt między polami (na przykład dostępność „w magazynie” przy zerowym stanie), tytuł albo opis łamiący limit długości kanału, brak GTIN tam, gdzie kanał go wymaga i nie akceptuje kombinacji marki z numerem producenta. Claude Code, mając opisane reguły kanału, oznacza oferty, które z tych powodów najpewniej dostaną dezaprobatę, i grupuje je według przyczyny. Nie zastępuje to walidacji po stronie kanału, ale pozwala naprawić najczęstsze odrzucenia, zanim plik w ogóle trafi do Merchant Center czy panelu marketplace.

Ściąga: problem w feedzie, działanie, kontrola

Cały proces zbiera się w jednej tabeli. Kolumna po prawej jest najważniejsza, bo to ona pilnuje, żeby automatyzacja feedów nie zamieniła jednego problemu w drugi.

Zasada wspólna dla całej tabeli: Claude Code oznacza i proponuje, decyzję o wartości i o zapisie zostawia Tobie.

Zanim wgrasz plik: przeglądaj różnice, nie efekt

Od jednorazowego eksportu do stałej automatyzacji feedów

Jednorazowe przygotowanie feedu to dobry początek, ale katalog zmienia się codziennie: ceny, stany, nowe produkty, wycofania. Jeśli za każdym razem ręcznie powtarzasz to samo mapowanie i tę samą walidację, marnujesz czas na pracę, która jest z definicji powtarzalna. Te same reguły (mapowanie pól, uzupełnianie wyprowadzalnych braków, walidacja typów, wykrywanie odrzuceń) da się zamknąć w powtarzalny workflow, który przetwarza kolejne eksporty według raz ustalonych zasad, z tym samym przeglądem różnic przed wysyłką i osobnym feedem na każdy kanał z jednego źródła. To dokładnie praca, którą w Seedlight bierzemy na etapie AI Automation, a szerzej opisujemy w ofercie automatyzacji AI w commerce: zamieniamy jednorazowe przygotowanie feedu w proces, który działa sam i zostawia człowiekowi decyzje, a nie mrówczą robotę.

Dobry feed nie jest celem samym w sobie, tylko warunkiem, żeby produkty w ogóle dało się wystawić i znaleźć w każdym kanale bez fali odrzuceń. Claude Code skraca drogę od surowego eksportu do zwalidowanego pliku z godzin ręcznego dopasowywania do kilku kontrolowanych przejść. Cała sztuka jest w dyscyplinie: pracuj na kopii, opisuj mapowanie i reguły zamiast liczyć na domysły narzędzia, waliduj typy i wartości u siebie i przeglądaj różnice, zanim wgrasz plik. Reszta to już tylko powtarzalność, którą warto zautomatyzować.