Kontext do popisků
Postup pro agentury · Mergado

Kontext do popisků

Jak u nového klienta dostat do feedu to, co o produktech vědí zákazníci a jeho vlastní články. Z recenzí a návodů se nejdřív vytáhnou tvrzení, ta se zkontrolují a teprve z nich vznikne doplněk popisku, který Mergado připojí pod stávající text.

ZDROJE KONTEXTU POČÍTAČ AGENTURY MERGADO Recenze produktů Články a návody Zákaznická podpora Produktová data Heureka, e-shop blog klienta FAQ, časté dotazy vstupní feed export, API Recenze a metriky umí dodat i Mergado Depots Skript deterministické kroky sběr, normalizace agregace na produkt slití, kontrola délky zapíše data Složka klienta lokálně, nebo Mergado Contexts CLAUDE.md kontext-klienta.md ton-komunikace.md brief-popisky.md data/recenze.jsonl data/clanky/ tvrzeni.csv doplnek-popisu.csv historie-zmen.md Agent Claude Code v terminálu vytáhne tvrzení napíše doplňky nastaví pravidla ověří na vzorku čte píše Vy schválíte tvrzení a vzorek doplňků ke schválení Depots recenze Heureka, GA, Search Console, Sklik Contexts kontext klienta uložený u e-shopu MCP: data Projekt pro kanál pravidla běží při každém přegenerování Vstupní feed e-shopu Import dat Přepisování popisku Výstupní feed → skrytý element DOPLNEK_POPISU popisek + nadpis + doplněk Google Nákupy, ChatGPT, srovnávače MCP doplnek-popisu.csv na stálé adrese import si ji načte při každém přegenerování
Kde co leží a kdo co dělá. Skript stahuje a skládá data, agent z nich píše, vy schvalujete a Mergado jen připojí hotový doplněk k popisku. Oranžově je cesta doplňku do feedu, modře práce agenta přes Mergado MCP. Čárkovaně Contexts jako alternativa k lokální složce.

Kdo co dělá

Zdrojeu klienta a na webu
Recenze, články a návody z blogu, odpovědi zákaznické podpory a produktová data z feedu. Recenze z Heureky a metriky z GA, Search Console nebo Skliku umí dodat i rozšíření Mergado Depots, agent je pak čte přímo přes MCP a odpadá export.
Složka klientalokálně, nebo Contexts
Jedno místo, kde leží všechno o klientovi: pravidla agentury, kontext klienta, tón, brief k popiskům, surová data a výstupy (tvrzení, doplňky). Místo lokální složky jde použít Mergado Contexts, pak kontext vidí každý, kdo s e-shopem pracuje.
SkriptPython ve složce
Všechno, co má vyjít pokaždé stejně: stažení dat, sjednocení formátu, seskupení recenzí k produktům, vyhodnocení selektorů segmentů, slití doplňků do jedné tabulky a kontrola délky. Model na to není potřeba a skript se dá otestovat.
AgentClaude Code v terminálu
Práce s jazykem a s Mergadem: vytáhne tvrzení, napíše doplňky, navrhne a založí pravidla přes Mergado MCP a ověří je na sledovaných produktech. Řídí se souborem CLAUDE.md agentury.
Vydvě kontrolní místa
Schválíte tvrzení, než se z nich začne psát, a vzorek doplňků, než se škáluje. Přegenerování feedu spouštíte vy.
Mergadoprojekt pro kanál
Import dat nahraje tabulku doplňků do skrytého elementu, jedno pravidlo Přepisování ho připojí k popisku. Při aktualizaci se jen vymění tabulka, pravidla zůstávají.

Postup u nového klienta

  1. Posbírejte kontext na jedno místo vy

    Založte složku klienta podle šablon v přílohách: pravidla agentury (CLAUDE.md), kontext klienta, tón komunikace a brief k popiskům. Pak do data/ stáhněte recenze a 3 až 5 článků nebo návodů, které vysvětlují, jak vybírat a používat sortiment. Víc článků ze začátku nepotřebujete.

  2. Sjednoťte a seskupte data skript

    Recenze z různých zdrojů převeďte na jeden formát, odfiltrujte prázdné („spokojenost“, „funguje“) a seskupte je k produktům podle ID nebo EAN. Když recenze nesou jen název produktu, skript je páruje podle normalizovaného názvu a nespárované vypíše. Pozor na recenze, které visí u víc produktů najednou. Jsou slabším dokladem a skript by je měl označit.

    Ověřte, že máte všechny zdroje. Recenze bývají na víc místech: v exportu ze současné platformy, v tabulce po migraci, u srovnávače. Jeden zdroj snadno chybí. V testu měla tabulka k jednomu produktu 3 recenze s textem a projekt v Mergadu 8.

  3. Vytáhněte tvrzení agent vy

    Tvrzení je věta o tom, co o produktu platí, se sedmi poli: entita, vlastnost, důsledek, podmínka, vymezení, jazyk zákazníka a zdroj. Z recenzí vznikají tvrzení na produkt, z článků tvrzení na segment se selektorem, podle kterého agent ve feedu najde produkty, kterých se týká.

    PoleUkázka
    entitaTrekové boty s membránou
    vlastnostMembrána nepropustí vodu ani při celodenním dešti
    důsledekNa vícedenní trek zůstanou nohy suché
    podmínkaSvršek se musí pravidelně impregnovat
    vymezeníV horkém létě se noha potí víc než v botě bez membrány
    jazyk zákazníka„promokají?“, „dají se nosit v létě?“
    zdrojčlánek „Jak vybrat trekové boty“

    Dvě pravidla platí bez výjimky: čísla se negenerují, jen přenášejí, a každé tvrzení má zdroj. Tvrzení si projděte a schvalte, než se z nich začne psát. Tady se chyby chytají nejlevněji.

    • Selektor nestavte jen na kategorii. V kategorii bývají i doplňky, dárkové poukazy nebo příbuzné produkty, na které tvrzení neplatí. Agent má u každého selektoru vypsat, co do něj spadlo, a vyloučit to podle názvu, typu nebo značky.
    • Články si můžou odporovat navzájem i s popisky. Takové tvrzení se nepoužije, dokud ho klient nerozhodne.
    • Bezpečnostní a zdravotní tvrzení (jak dlouho nosit, kdy přestat) schvaluje klient a nepřenášejí se na produkty se zvláštním určením, třeba zdravotní pomůcky.

  4. Napište doplněk popisku agent vy

    Stávající popisek se nepřepisuje. Pod něj přibude krátký blok s tím, co popisek výrobce neříká: co zákazník k produktu potřebuje, kdy se nehodí, na co si dát pozor. Nejvýš 4 odrážky a 600 znaků. Co už v popisku je, se neopakuje. Když si tvrzení s popiskem odporuje, nepíše se ani jedno.

    Opakování a rozpor s popiskem musí agent posoudit po smyslu u každého produktu zvlášť. Kontrola podle klíčových slov nestačí: „po pár hodinách tlačí v patě“ ji projde, i když popisek tvrdí „pohodlná na celodenní túry“.

    Treková bota s membránou a gumovou špičkou. Svršek z broušené kůže, podrážka s hlubokým vzorkem…
    Co je dobré vědět před nákupem - Membrána nepropustí vodu ani při celodenním dešti, pokud je svršek pravidelně impregnovaný. V horkém létě se v ní noha potí víc.
    - Čistěte jen vodou a měkkým kartáčem, bez pračky a bez prostředků se silikonem.
    - Bota se nemusí rozchodit. Na úzkou nohu je v patě volnější.

    Agent výsledek zapíše do tabulky doplnek-popisu.csv: jeden řádek na produkt, sloupce g:id a DOPLNEK_POPISU, jen odrážky. Odrážky ze segmentu i z recenzí jsou u produktu v jedné buňce, takže nadpis vyjde vždycky jen jednou. Začněte vzorkem 20 až 50 produktů v méně důležité kategorii.

  5. Dostaňte doplněk do feedu agent Mergado

    Na celý katalog stačí jeden import, jedno pravidlo a jeden výběr. Agent je založí přes Mergado MCP, až plán odsouhlasíte:

    1. skrytý element DOPLNEK_POPISU,
    2. Import dat z tabulky, párování přes g:id, importuje se jen tenhle element,
    3. výběr „DOPLNEK_POPISU není prázdný“,
    4. Přepisování výstupního popisku nad tím výběrem:
    %g:description%

Co je dobré vědět před nákupem
%DOPLNEK_POPISU%

    Pravidlo zapisujte do výstupního elementu (u Googlu g:description), ne do vstupního description, převod formátu ho přepisuje dřív. Import musí v pořadí pravidel běžet před přepisováním. Před přegenerováním nechte agenta ověřit tři sledované produkty: jeden s doplňkem, jeden s odrážkami ze segmentu i z recenze a jeden bez doplňku, který se nesmí změnit.

    VariantaPravidlaVýběryCo roste s katalogem
    Pravidlo na každý segment a produktjedno na každýjeden na každýpravidla i výběry
    Hromadná pravidla s tabulkou řádků2jeden na segmentvýběry a řádky v pravidlech
    Import a připojení21jen řádky v importní tabulce

    Párujte podle skupiny, když to jde. U oblečení je každá velikost samostatná položka, ale doplněk se liší jen mezi modely. Import pak páruje přes item_group_id a tabulka má řádek na model, ne na velikost (v testu 28 řádků pro 215 položek). Produkty bez skupiny se párují přes vlastní ID.

    Na začátek stačí tabulku do importu nahrát jako soubor. Pro pravidelné aktualizace ji vystavte na stálé adrese (třeba export z Google Tabulek nebo vlastní server), import si ji pak načte při každém přegenerování sám.

  6. Kontrolujte a škálujte skript vy

    • Délka: původní popisek a doplněk se dohromady musí vejít do limitu kanálu, u Googlu 5 000 znaků. Skript to ověří před nahráním.
    • Opakování: doplněk nesmí zopakovat, co už výrobce napsal. Skript zná původní popisek, takže to může porovnat.
    • Rozpory v segmentu: do segmentu patří jen to, co platí bez výjimky pro celou skupinu. Vlastnost, která se mezi produkty liší, patří k produktu.
    • Po přegenerování: počet produktů s doplňkem ve výstupu se musí rovnat počtu řádků v tabulce a nadpis bloku se nesmí objevit dvakrát.
Ověřeno v listopadu 2026 Na katalogu e-shopu s technickým sortimentem (3 167 produktů): tabulka se 153 doplňky z 6 článků a recenzí, jeden import, jedno přepisování a jeden výběr. Přegenerování proběhlo bez chyb, doplněk má ve výstupu právě 153 produktů, nadpis je u každého jednou a žádný popisek nepřekročil 5 000 znaků. Produkty bez doplňku zůstaly beze změny.
Ověřeno na druhém katalogu E-shop s oblečením a doplňky (375 položek, každá velikost zvlášť): 30 tvrzení ze 4 návodů, 3 tabulek velikostí a 91 recenzí, z toho 6 zamítnutých kvůli rozporům nebo slabému dokladu. Doplněk dostalo 215 položek ve 28 modelech. Zbylých 160 nemá v žádném zdroji doložené tvrzení, takže doplněk nedostalo, a to je správně. Jeden produkt s popiskem dlouhým 4 994 znaků kontrola délky vyřadila.

Totéž se hodí i pro další pole

Ze stejných schválených tvrzení jde napsat otázky a odpovědi (g:question_and_answer), product highlights a product details. Titulky naopak stačí řídit best practices kanálu, tedy strukturou, parametry a délkou. Recenze ani velký kontext tam potřeba nejsou.

Přílohy

Šablony jsou v Markdownu, stačí je zkopírovat do složky klienta a vyplnit hranaté závorky. Ukázková data jsou ze smyšleného e-shopu s outdoorovým vybavením.