Mergado Asistent

https://github.com/mergado/mergado-skills
Admin
Claude skill for Mergado Editor users that translates e-commerce problems into concrete actions via...
Tokens:96,587
Snippets:503
Trust Score:7.5
License:MIT
Update:2 months ago
Show doc for...
Tokens:
Raw
### Install additional plugins in Claude Code

Source: https://github.com/mergado/mergado-skills/blob/main/README.md

Example command for installing other available plugins like the shoptet-feed-doctor.

```text
/plugin install shoptet-feed-doctor@mergado-skills
```

--------------------------------

### Basic MQL Syntax Examples

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/element-paths-and-mql.md

Examples of basic element path queries and comparison operators.

```text
[PRICE_VAT] >= 100
```

```text
PRICE_VAT >= 100
```

--------------------------------

### Install audit-projektu skill

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/audit-projektu/README.md

Commands to add the plugin marketplace and install the audit-projektu skill.

```text
/plugin marketplace add mergado/mergado-skills
/plugin install audit-projektu@mergado-skills
```

--------------------------------

### Set Membership MQL Example

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/element-paths-and-mql.md

Example of using the IN operator for set membership.

```text
ITEM_ID IN (101,102,103)
```

--------------------------------

### Regex MQL Examples

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/element-paths-and-mql.md

Examples of using regex for pattern matching in MQL.

```text
g:gtin ~ '^\d{13}$'
```

```text
g:availability = 'in_stock' AND g:price < 500
```

```text
PRICE_VAT > "500" AND CATEGORYTEXT ~ "mikina" AND MANUFACTURER = "Adidas"
```

```text
g:title ~ '(?i)čern'
```

--------------------------------

### Run audit-projektu command

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/audit-projektu/README.md

Examples of how to execute the audit command with various flags for filtering and parallel processing.

```text
/audit-projektu Muj eshop
/audit-projektu 123456 --quick              # fixní krátký seznam kontrol pro live ukázku
/audit-projektu 123456 --only mergado,pf    # jen vybrané oblasti
/audit-projektu 123456 --values output      # posuzuj jen to, co odchází na platformu
/audit-projektu 123456 --values input       # posuzuj jen zdrojová data od dodavatele
/audit-projektu 123456 --parallel           # rozdělí kategorie mezi subagenty
```

--------------------------------

### Install Mergado plugins in Claude Code

Source: https://github.com/mergado/mergado-skills/blob/main/README.md

Use these slash commands to add and install Mergado skills in the Claude Code environment.

```text
/plugin marketplace add mergado/mergado-skills
/plugin install mergado-asistent@mergado-skills
```

--------------------------------

### XML structure of product variants

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/shoptet-feed-doctor/skills/shoptet-feed-doctor/references/variant-merging.md

Example of an XML structure showing shared elements and variant-specific parameters for a product.

```xml
<SHOP>
  <SHOPITEM>
    <!-- společné elementy (na ukázce zvýrazněny rámečkem): -->
    <NAME>Columbia Squish N' Stuff</NAME>
    <ITEM_TYPE>product</ITEM_TYPE>
    <CATEGORIES>
      <CATEGORY>Oblečení > Dětské oblečení</CATEGORY>
    </CATEGORIES>
    <IMAGES>
      <IMAGE>https://myshoptet.com/34-1_columbia-squish-n--stuff.jpg</IMAGE>
      <IMAGE>https://myshoptet.com/34-2_columbia-squish-n--stuff.jpg</IMAGE>
    </IMAGES>
    <VARIANTS>
      <VARIANT>
        <CODE>34_BIL</CODE>
        <PRICE>290</PRICE>
        <AVAILABILITY_IN_STOCK>Skladem</AVAILABILITY_IN_STOCK>
        <PARAMETERS>
          <PARAMETER>
            <NAME>Barva</NAME>
            <VALUE>Bílá</VALUE>
          </PARAMETER>
          <PARAMETER>
            <NAME>Velikost</NAME>
            <VALUE>XL</VALUE>
          </PARAMETER>
        </PARAMETERS>
      </VARIANT>
      <VARIANT>
        <CODE>34_BIL2</CODE>
        <PRICE>290</PRICE>
        <!-- zbytek ukázky na screenshotu oříznut … -->
```

--------------------------------

### Combined MQL Conditions

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/element-paths-and-mql.md

Examples of combining multiple conditions using logical operators and parentheses.

```text
PRICE > 1000 AND BRAND = "Nike"
```

```text
(PRICE > 500 AND BRAND = "Nike") OR CATEGORYTEXT CONTAINS "Sport"
```

```text
PRICE_VAT >= 1000 AND PRICE_VAT <= 2000
```

```text
g:gtin = ''
```

```text
DESCRIPTION != ''
```

--------------------------------

### Regex Matching Examples

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/element-paths-and-mql.md

Common regex patterns for matching strings, colors, digits, and numbers with optional decimal parts.

```regex
(?i)čern
```

```regex
.*?(černá|bílá|červená).*
```

```regex
^\d+$
```

```regex
\d+(?:[.,]\d+)?
```

--------------------------------

### Find and Replace Rule Patterns

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/element-paths-and-mql.md

Examples of search and replacement patterns for common text manipulation tasks like stripping HTML or swapping paragraphs.

```regex
<[^>]*>
```

```regex
\s{2,}
```

```regex
^(.*?)\n\n(.*)$
```

```regex
.*?(\d+).*
```

--------------------------------

### Inverse MQL Selections

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/element-paths-and-mql.md

Examples of using negation to define negative selections.

```text
ITEM_ID != 43
```

```text
NOT ( ITEM_ID = 43 )
```

```text
NOT ( PRODUCTNAME CONTAINS "boty" OR CATEGORY = "Doplňky" )
```

```text
NOT ( PRODUCTNAME CONTAINS "kalhoty" AND PRICE_VAT > 1100 )
```

```text
ITEM_ID NOT IN (101,102,103)
```

--------------------------------

### Shoptet feed structure with Master product

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/shoptet-feed-doctor/skills/shoptet-feed-doctor/references/variant-merging.md

Example of a Shoptet feed where individual variants are nested within a single master product using the VARIANT element.

```xml
<SHOP>
  <SHOPITEM>
    <NAME>Columbia Squish N' Stuff</NAME>
    <ITEM_TYPE>product</ITEM_TYPE>
    <CATEGORIES>
      <CATEGORY>Oblečení > Dětské oblečení</CATEGORY>
    </CATEGORIES>
    <IMAGES>
      <IMAGE>https://myshoptet.com/34-1_columbia-squish-n--stuff.jpg</IMAGE>
      <IMAGE>https://myshoptet.com/34-2_columbia-squish-n--stuff.jpg</IMAGE>
    </IMAGES>
    <VARIANTS>
      <VARIANT>
        <CODE>34_CER</CODE>
        <PRICE>290</PRICE>
        <AVAILABILITY_IN_STOCK>Skladem</AVAILABILITY_IN_STOCK>
        <PARAMETERS>
          <PARAMETER>
            <NAME>Barva</NAME>
            <VALUE>Červená</VALUE>
          </PARAMETER>
          <PARAMETER>
            <NAME>Velikost</NAME>
            <VALUE>XL</VALUE>
          </PARAMETER>
        </PARAMETERS>
      </VARIANT>
      <VARIANT>
        <CODE>34_ZEL</CODE>
        <PRICE>290</PRICE>
        <AVAILABILITY_IN_STOCK>Skladem</AVAILABILITY_IN_STOCK>
        <PARAMETERS>
          <PARAMETER>
            <NAME>Barva</NAME>
            <VALUE>Zelená</VALUE>
          </PARAMETER>
          <PARAMETER>
            <NAME>Velikost</NAME>
            <VALUE>M</VALUE>
          </PARAMETER>
        </PARAMETERS>
      </VARIANT>
      <VARIANT>
        <CODE>34_MOD</CODE>
        <PRICE>290</PRICE>
        <AVAILABILITY_IN_STOCK>Skladem</AVAILABILITY_IN_STOCK>
        <PARAMETERS>
          <PARAMETER>
            <NAME>Barva</NAME>
            <VALUE>Modrá</VALUE>
          </PARAMETER>
          <PARAMETER>
            <NAME>Velikost</NAME>
            <VALUE>XL</VALUE>
          </PARAMETER>
        </PARAMETERS>
      </VARIANT>
    </VARIANTS>
  </SHOPITEM>
</SHOP>
```

--------------------------------

### Heureka feed structure with ITEMGROUP_ID

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/shoptet-feed-doctor/skills/shoptet-feed-doctor/references/variant-merging.md

Example of a feed where variants are standalone SHOPITEM elements grouped by a shared ITEMGROUP_ID value.

```xml
<SHOP>
  <SHOPITEM>
    <ITEM_ID>34_CER</ITEM_ID>
    <PRODUCTNAME>Columbia Squish N' Stuff Barva: Červená, Velikost: XL</PRODUCTNAME>
    <DESCRIPTION>Popis položky</DESCRIPTION>
    <URL>https://myshop.com/columbia-squish-n-stuff/?variantId=49</URL>
    <IMGURL>https://myshop.com/usr/34-1_columbia-squish-n--stuff.jpg</IMGURL>
    <PRICE_VAT>290,00</PRICE_VAT>
    <PARAM>
      <PARAM_NAME>Barva</PARAM_NAME>
      <VAL>Červená</VAL>
    </PARAM>
    <PARAM>
      <PARAM_NAME>Velikost</PARAM_NAME>
      <VAL>XL</VAL>
    </PARAM>
    <CATEGORYTEXT>Oblečení | Dětské oblečení</CATEGORYTEXT>
    <ITEMGROUP_ID>34</ITEMGROUP_ID>
  </SHOPITEM>
  <SHOPITEM>
    <ITEM_ID>34_ZEL</ITEM_ID>
    <PRODUCTNAME>Columbia Squish N' Stuff Barva: Zelená, Velikost: M</PRODUCTNAME>
    <DESCRIPTION>Popis položky</DESCRIPTION>
    <URL>https://myshop.com/columbia-squish-n-stuff/?variantId=55</URL>
    <IMGURL>https://myshop.com/usr/34-1_columbia-squish-n--stuff.jpg</IMGURL>
    <PRICE_VAT>290,00</PRICE_VAT>
    <PARAM>
      <PARAM_NAME>Barva</PARAM_NAME>
      <VAL>Zelená</VAL>
    </PARAM>
    <PARAM>
      <PARAM_NAME>Velikost</PARAM_NAME>
      <VAL>M</VAL>
    </PARAM>
    <CATEGORYTEXT>Oblečení | Dětské oblečení</CATEGORYTEXT>
    <ITEMGROUP_ID>34</ITEMGROUP_ID>
  </SHOPITEM>
  <SHOPITEM>
    <ITEM_ID>34_MOD</ITEM_ID>
    <PRODUCTNAME>Columbia Squish N' Stuff Barva: Modrá, Velikost: XL</PRODUCTNAME>
    <DESCRIPTION>Popis položky</DESCRIPTION>
    <URL>https://myshop.com/columbia-squish-n-stuff/?variantId=52</URL>
    <IMGURL>https://myshop.com/orig/34-2_columbia-squish-n--stuff.jpg</IMGURL>
    <PRICE_VAT>290,00</PRICE_VAT>
    <PARAM>
      <PARAM_NAME>Barva</PARAM_NAME>
      <VAL>Modrá</VAL>
    </PARAM>
    <PARAM>
      <PARAM_NAME>Velikost</PARAM_NAME>
      <VAL>XL</VAL>
    </PARAM>
    <CATEGORYTEXT>Oblečení | Dětské oblečení</CATEGORYTEXT>
    <ITEMGROUP_ID>34</ITEMGROUP_ID>
  </SHOPITEM>
</SHOP>
```

--------------------------------

### Run audit script for domain and paths

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/ai-visibility-audit/skills/ai-visibility-audit/SKILL.md

Executes the bundled audit script against a specific domain and optional sampled paths. If no paths are provided, the script automatically fetches the sitemap to select samples.

```bash
bash scripts/audit.sh <domain> [sampled-path-1] [sampled-path-2] ...
```

--------------------------------

### Adresování konkrétního parametru v MQL

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/audit-projektu/skills/audit-projektu/references/kontroly-mergado-data.md

Syntaxe pro přístup k hodnotě konkrétního parametru podle jeho názvu.

```MQL
PARAM { PARAM_NAME = "Barva" } | VAL
```

--------------------------------

### Konfigurační soubor mergado-backup-config.json

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-project-auto-backup/skills/mergado-project-auto-backup/SKILL.md

Struktura konfiguračního souboru pro uložení nastavení zálohování projektu.

```json
{"project_id", "storage_path", "storage_type": "local"|"git", "retention": "overwrite"|"keep5"|"keep_all"}
```

--------------------------------

### Příklady zápisu vzorce nálezu

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/audit-projektu/skills/audit-projektu/references/report-template.md

Způsob definice vzorce pomocí MQL nebo funkce.

```text
list_unique_element_values(<project_id>, "HEUREKA_CPC", is_output=true)
MQL: URL ~ "\?[^?]*\?"
```

--------------------------------

### Detekce data exspirace v parametru

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/audit-projektu/skills/audit-projektu/references/kontroly-mergado-data.md

Příklad MQL podmínky pro vyhledání konkrétních formátů dat v parametru exspirace.

```MQL
PARAM { PARAM_NAME = "Datum exspirace" } | VAL ~ "\d\d\.0[1-7]\.2026"
```

--------------------------------

### Retrieve project context via Mergado MCP

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/ai-visibility-audit/skills/ai-visibility-audit/SKILL.md

Sequence of API calls to identify the shop and project domain when Mergado MCP is connected.

```text
get_current_user → list_user_eshops → list_shop_projects
```

--------------------------------

### Action plan recommendation template

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/ai-visibility-audit/skills/ai-visibility-audit/references/action-plan-template.md

A template block used for each specific recommendation selected by the user during an AI visibility audit.

```markdown
### {N}. {Recommendation title, copied from the report}

**Why it matters:** {one sentence — which platform(s)/mechanism this affects, from
references/platform-requirements.md — not a generic "improves AI visibility"}

**What to change:** {the exact field, file, or setting — e.g. "add a `gtin` value to each
product in the feed" not "improve your product data"}

**Where:**
- {If it's a Mergado-feed-side fix: name the concrete Mergado tool/workflow — e.g. "add a rule
  via `create_batch_param_rule` mapping your supplier's EAN column to the `gtin` element" — only
  if Mergado MCP is connected and this is genuinely how it'd be done; don't invent tool calls
  that don't exist.}
- {If it's a website-side fix: name the actual file/template/plugin area — e.g. "the WooCommerce
  product template" or "your theme's category-page template" — as specifically as what was
  observed during the audit allows.}
- {If it depends on an external account/platform (Google Merchant Center, ChatGPT merchant
  portal, Perplexity merchant program, etc.): say which account is needed and that this skill
  can't complete that step directly.}

**How to verify it worked:** {a concrete, repeatable check — e.g. "reload the product page and
confirm `gtin` appears in the JSON-LD block" or "re-run `scripts/audit.sh` against this page
and check row 8"}
```

--------------------------------

### Porovnání nákladů dotazů list_project_products a list_unique_element_values

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/audit-projektu/skills/audit-projektu/SKILL.md

Ukázka rozdílu v náročnosti na tokeny mezi obecným výpisem produktu a agregovaným výpisem unikátních hodnot.

```text
list_project_products(id, mql='URL ~ "\[^?]*\?"', limit=1)
→ {"total_results": 55, "data": [ …celá karta produktu… ]}         ≈ 4000 tokenů

list_unique_element_values(project_id, "SPAROVANE", is_output=true)
→ [{"value":"1","count":4852},{"value":"0","count":1217}]           ≈ 40 tokenů
```

--------------------------------

### Execute audit script in standalone mode

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/ai-visibility-audit/skills/ai-visibility-audit/SKILL.md

Command to initiate the audit process for a specific domain when Mergado MCP is not connected.

```bash
scripts/audit.sh <domain>
```

--------------------------------

### Audit command syntax

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/audit-projektu/skills/audit-projektu/SKILL.md

The command structure for initiating an audit, including optional filters and execution modes.

```bash
/audit-projektu <eshop nebo projekt> [--only …] [--skip …] [--quick] [--parallel]
```

--------------------------------

### Detekce unikátních hodnot parametrů

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/audit-projektu/skills/audit-projektu/references/kontroly-mergado-data.md

Použití funkce pro výpis unikátních hodnot názvů parametrů pro identifikaci duplicitních nebo nekonzistentních vlastností.

```MQL
list_unique_element_values on PARAM | PARAM_NAME with is_output: true
```

--------------------------------

### Repository Directory Structure

Source: https://github.com/mergado/mergado-skills/blob/main/README.md

The standard file layout for the mergado-skills repository, highlighting the placement of plugin manifests, skill definitions, and supporting documentation.

```text
mergado-skills/
├── .claude-plugin/
│   └── marketplace.json          # marketplace manifest (list of plugins)
├── plugins/
│   └── <plugin-name>/
│       ├── .claude-plugin/
│       │   └── plugin.json        # plugin manifest
│       ├── README.md              # optional, plugin-level docs
│       └── skills/
│           └── <skill-name>/
│               ├── SKILL.md       # skill entry point
│               ├── references/    # detailed playbooks and reference materials
│               ├── scripts/       # optional executable helpers
│               └── examples/      # optional sample data
├── context7.json                  # Context7 indexing configuration
├── README.md
└── LICENSE
```

--------------------------------

### Validate feed locally with scripts/validate.py

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/shoptet-feed-doctor/skills/shoptet-feed-doctor/SKILL.md

Run the validation script against a feed file using either the complete schema or the supplier-specific schema.

```bash
python scripts/validate.py feed.xml                  # complete schema (default)
python scripts/validate.py feed.xml --schema supplier
```

--------------------------------

### Spuštění auditu v paralelním režimu

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/audit-projektu/skills/audit-projektu/SKILL.md

Použijte příznak --parallel pro rozdělení katalogů mezi subagenty. Každý subagent obdrží specifické parametry a vrací nálezy ve strukturovaném formátu.

```bash
--parallel
```

--------------------------------

### Validate and update Shoptet schemas

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/shoptet-feed-doctor/skills/shoptet-feed-doctor/SKILL.md

Commands to check for schema changes against the live Shoptet validator or to refresh the local bundled copies.

```bash
python scripts/validate.py --check-schema     # report UNCHANGED/CHANGED per file
python scripts/validate.py --update-schema    # refresh bundled copies (.bak kept)
```

--------------------------------

### Audit project structure

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/audit-projektu/README.md

The file structure of the audit-projektu skill repository.

```text
SKILL.md                                  zásady, ohlášení, fáze, značení, vzorkování, chování při chybách
references/detekce-rozsireni.md           jak se zjišťuje, co je k dispozici
references/kontroly-mergado-data.md       ceny, identifikátory, názvy vs. kategorie, sezónnost, compliance
references/kontroly-mergado-konfigurace.md výběry a pravidla: názvy vs. obsah, duplicity, pořadí, mrtvá pravidla
references/kontroly-provoz.md             importy, exporty, logy, tarif, osiřelé objekty
references/kontroly-pricing-fox.md
references/kontroly-bidding-fox.md
references/kontroly-fie.md
references/kontroly-cross-app.md          rozpory mezi kanály a nástroji
references/kontroly-ai-sanity.md          volná AI pasáž a sebekontrola auditu
references/report-template.md             formát reportu a formát nálezu
```

--------------------------------

### URL odkaz do rozhraní

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/audit-projektu/skills/audit-projektu/references/report-template.md

Formát odkazu pro výběry v aplikaci Mergado.

```text
https://app.mergado.com/projects/<project_id>/queries/edit/<query_id>/
```

--------------------------------

### Google Shopping Optimization Report Template

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-google-ads-optimization/skills/mergado-google-ads-optimization/SKILL.md

The fixed format required for reporting diagnostic findings. It includes sections for project metadata, a summary verdict, a 9-pillar table, and recommended actions.

```markdown
# Obsahová optimalizace Google Shopping — {projekt}

## Vstup a metoda
| | |
|---|---|
| Projekt | {název, id} |
| Výstupní formát | {output_format} |
| Produktů | {exported_items} |
| Poslední sync | {data_synced_at — starší než 7 dní zaslouží poznámku} |
| Datum | {datum} |

**Legenda:** ✅ v pořádku / využito · ⚠️ nevyužitá příležitost · ❌ reálně omezuje výkon ·
➖ netýká se tohoto projektu · ℹ️ jen doporučení nástroje/postupu

## Verdikt
{X} z 9 pilířů v pořádku, {Y} nálezů — největší dopad má {pilíř} ({číslo/podíl}).

## Nálezy podle pilířů (vždy všech 9)
| # | Pilíř | Stav | Nález (vždy konkrétní číslo/podíl) | Kategorie |
|---|---|---|---|---|
| 1–9 | {názvy pilířů dle Kroku 1} | ✅/⚠️/❌/➖/ℹ️ | {…} | {[DATA FEEDU] apod.} |

{U ⚠️/❌ nálezů pod tabulkou krátký blok: dotčená query + navrhované pravidlo — jeden
vzorec pro celou skupinu, ne výčet produktů.}

## Doporučený postup (max 5, jedna věta, podle dopadu)
1. {…}

## Co jsme NEmohli ověřit
{vzorek vs. celý katalog; co by odemklo připojení dalšího zdroje; pixel/web mimo Mergado}

---

Které nálezy mám rozpracovat, nebo rovnou řešit? Pravidla založím až po vašem potvrzení,
v režimu review. Napište čísla pilířů, nebo „všechny".

*Tento skill pro vás s láskou vytvořil Mergado Team #MergadoFam*
```

--------------------------------

### Format and element detection

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/audit-projektu/skills/audit-projektu/SKILL.md

API calls used to determine project structure and format specifications.

```text
get_project (vstupní a výstupní formát), list_project_elements, a get_format_specification na výstupní formát
```

--------------------------------

### Struktura nálezu auditu

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/audit-projektu/skills/audit-projektu/references/report-template.md

Povinná šablona pro zápis nálezů v auditu projektu.

```markdown
#### <kód kontroly> <Titulek nálezu>
- **Závažnost:** Z1 | Z2 | Z3
- **Kategorie:** [DATA FEEDU] | [NASTAVENÍ MERGADA] | [ROZŠÍŘENÍ] | [OMEZENÍ PLATFORMY] | [MIMO FEED]
- **Rozsah:** kolik produktů, pravidel nebo šablon je zasaženo, a z kolika celkem
- **Vzorec:** čím jsou zasažené objekty společně dané, tedy dotčený výběr nebo MQL podmínka
- **Důkaz:** názvy s ID, konkrétní hodnoty, u vzorku jeho velikost, tři až pět příkladů
- **Jak ověřit:** doslovný dotaz nebo nástroj, kterým si to čtenář může přepočítat
- **Proč to vadí:** jedna až dvě věty, dopad v penězích nebo ve výkonu kanálu
- **Doporučení:** co konkrétně udělat a kde
```

--------------------------------

### Data freshness verification

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/audit-projektu/skills/audit-projektu/SKILL.md

API fields retrieved from get_project to verify if data is current and rules have been applied.

```text
is_dirty, rules_changed_at, data_synced_at, data_updated_at, is_paused, turned_off, readonly, in_testing_mode
```

--------------------------------

### AI Visibility Audit Report Template

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/ai-visibility-audit/skills/ai-visibility-audit/references/report-template.md

The standard markdown template for an AI visibility audit, including sections for data sources, audit scope, and findings.

```markdown
# AI Visibility Audit — {store domain}

> **AI Visibility Audit** — Zkontroloval jsem, jak je {store domain} připravený na to, aby ho
> AI systémy (Google AI Overviews/AI Mode, ChatGPT, Claude, Perplexity) uměly najít, správně
> popsat a doporučit. Report má vždy stejný formát, takže se dá srovnat s jinými e-shopy i s
> budoucím opakováním auditu.

## Zdroje dat pro tento běh

| Zdroj | Stav | Co dodává |
|---|---|---|
| Web (veřejná sonda) | ✅ vždy | co reálně vidí AI crawlery zvenčí |
| Mergado MCP | ✅ připojeno / ⬜ nepřipojeno | pravda o feedu napříč všemi projekty: kompletnost atributů, rozbitá pravidla, zastaralé synchronizace |
| Google Merchant Center | ✅ připojeno / ⬜ nepřipojeno | free listings opt-in, zamítnuté produkty, skóre kompletnosti, AI Performance Insights |
| Search Console | ✅ připojeno / ⬜ nepřipojeno | reálná indexace produktových URL, dotazy, pokrytí sitemap |

{One line total, only if something is missing: "Čím víc zdrojů je připojeno, tím víc řádků
reportu je z reálných dat místo odhadu zvenčí — chybějící zdroje se dají připojit a audit
spustit znovu."}

## Co jsme kontrolovali
- Stránky ({N} celkem): {plainly — "hlavní stránka, 2 kategorie (X, Y), 4 produkty napříč
  sortimentem"}
- Interní data: {which projects/samples were pulled from Mergado, or "žádná — MCP nepřipojeno"}
- Datum: {date}

Vzorek, ne celý katalog. Když se nálezy na vzorku shodují (stejný vzorec na všech stránkách),
je to silný signál — proto vzorek nikdy není jen 1 produkt.

**Legenda:** ✅ splňuje · ⚠️ částečně / stojí za zlepšení · ❌ chybí a reálně omezuje
viditelnost · ➖ chybí, ale u běžného e-shopu to dnes nic neřeší · ℹ️ jen informace

## Co jsme zjistili
```

--------------------------------

### Příklady zápisu objektů

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/audit-projektu/skills/audit-projektu/references/report-template.md

Tabulka formátů pro citování různých typů objektů v Mergadu.

```text
„Spárované produkty" (ID 7878622)
„Do URL Review URL" (ID 3600049, priorita 24)
„odpočet 🚀" (ID 1089)
ITEM_ID 1234567890 („Dětské boty ALF-010690 MUL")
PRODUCTNAME
objem_2 (regulární výraz (\d+)ml)
název (ID)
```

--------------------------------

### Struktura exportovaného JSON souboru

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-project-auto-backup/skills/mergado-project-auto-backup/SKILL.md

Formát datového souboru obsahujícího exportované nastavení projektu.

```json
{
  "exported_at": "2026-08-13T14:00:00+02:00",
  "project_id": "...",
  "rules": [...],
  "queries": [...],
  "variables": [...],
  "elements": [...]
}
```

--------------------------------

### Formát verdiktu auditu

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/audit-projektu/skills/audit-projektu/SKILL.md

Pevný formát prvního řádku reportu, který zajišťuje strojovou čitelnost a srovnatelnost výsledků.

```text
Verdikt: <N> nálezů (Z1 <a>, Z2 <b>, Z3 <c>) z <P> provedených kontrol ze <M> relevantních,
největší dopad má <kód> <titulek> (<rozsah>).
```

--------------------------------

### Heureka Optimization Report Template

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-heureka-optimization/skills/mergado-heureka-optimization/SKILL.md

The mandatory fixed-format template for reporting optimization findings. It requires all 9 pillars to be listed, regardless of whether they apply to the specific project.

```markdown
# Obsahová optimalizace Heureka — {projekt}

## Vstup a metoda
| | |
|---|---|
| Projekt | {název, id} |
| Výstupní formát | {output_format} |
| Produktů | {exported_items} |
| Poslední sync | {data_synced_at — starší než 7 dní zaslouží poznámku} |
| Datum | {datum} |

**Legenda:** ✅ v pořádku / využito · ⚠️ nevyužitá příležitost · ❌ reálně omezuje výkon ·
➖ netýká se tohoto projektu · ℹ️ jen doporučení nástroje/postupu

## Verdikt
{X} z 9 pilířů v pořádku, {Y} nálezů — největší dopad má {pilíř} ({číslo/podíl}).

## Nálezy podle pilířů (vždy všech 9)
| # | Pilíř | Stav | Nález (vždy konkrétní číslo/podíl) | Kategorie |
|---|---|---|---|---|
| 1–9 | {názvy pilířů dle Kroku 1} | ✅/⚠️/❌/➖/ℹ️ | {…} | {[DATA FEEDU] apod.} |

{U ⚠️/❌ nálezů pod tabulkou krátký blok: dotčená query + navrhované pravidlo — jeden
vzorec pro celou skupinu, ne výčet produktů.}

## Doporučený postup (max 5, jedna věta, podle dopadu)
1. {…}

## Co jsme NEmohli ověřit
{vzorek vs. celý katalog; co by odemklo připojení dalšího zdroje; pixel/web mimo Mergado}

---

Které nálezy mám rozpracovat, nebo rovnou řešit? Pravidla založím až po vašem potvrzení,
v režimu review. Napište čísla pilířů, nebo „všechny".

*Tento skill pro vás s láskou vytvořil Mergado Team #MergadoFam*
```

--------------------------------

### Audit Report Markdown Structure

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/audit-projektu/skills/audit-projektu/references/report-template.md

The standard template for creating an audit report, including placeholders for project details, findings, and status tables.

```markdown
# Audit projektu <eshop> / <projekt>

- **Datum:** <YYYY-MM-DD>
- **Projekt:** <název> (ID <project_id>), vstup <formát> → výstup <formát>
- **Počet produktů:** <N>
- **Rozsah auditu:** <plný | částečný | quick>, **provedeno <N> ze <M> kontrol**, režim hodnot: <both | input | output>
- **Stav dat:** <je_dirty / rules_changed_at vs. data_synced_at, viz Aktuálnost dat>
- **Použité zdroje:** Mergado MCP, <pricing-fox | pricing-fox-dev>, <…>

## Verdikt

**Verdikt: <N> nálezů (Z1 <a>, Z2 <b>, Z3 <c>) z <P> provedených kontrol ze <M> relevantních,
největší dopad má <kód> <titulek> (<rozsah>).**

<Tvar tohohle řádku neměň, ani když je nálezů nula. Je to jediná věta, kterou přečte i ten,
kdo report jen proletí, a je strojově srovnatelná s předchozím auditem.>

## Souhrn

<Tři až pět vět. Co nejvíc bolí, co stojí peníze, co je jen úklid. Bez seznamů.
Když je pokrytí pod dvěma třetinami katalogu, musí to být v první větě.>

| Závažnost | Počet nálezů |
|---|---|
| Z1 kritická závažnost | <N> |
| Z2 vysoká závažnost | <N> |
| Z3 hygiena | <N> |

> **Legenda.** Z1 kritická závažnost (utíkají peníze nebo je v tom právní riziko) ·
> Z2 vysoká závažnost (poškozuje výkon kanálu nebo zkresluje data) · Z3 hygiena (udržovatelnost).
>
> Kód u nálezu odkazuje na kontrolu v katalogu auditu a je mezi audity stabilní, takže se dá
> porovnat s příštím auditem. Skupiny: **A** ceny a marže · **B** dostupnost a identifikátory ·
> **C** názvy, parametry, kategorie a popisy · **D** značka · **E** sezónnost a čas ·
> **F** obrázky a adresy · **G** pravidla cílové platformy · **Q** výběry · **R** pravidla ·
> **V** proměnné a elementy · **O** provoz · **PF** Pricing Fox · **BF** Bidding Fox ·
> **FIE** Feed Image Editor · **X** rozpory napříč nástroji · **AI** volná AI pasáž.
>
> Značka v hranatých závorkách říká, čí je to práce: **[DATA FEEDU]** špatná hodnota už na vstupu ·
> **[NASTAVENÍ MERGADA]** pravidlo nebo výběr, opravitelné v Mergadu · **[ROZŠÍŘENÍ]** konfigurace
> Pricing Foxu, Bidding Foxu nebo Feed Image Editoru · **[OMEZENÍ PLATFORMY]** platforma to tak
> vyžaduje · **[MIMO FEED]** řeší se na webu, v administraci nebo v měření.
>
> ℹ️ označuje doporučení nebo otázku, ne nález, a do počtů výše se nezahrnuje.

## Rychlé výhry

<Nálezy, které se dají opravit v editoru do pěti minut a mají nejlepší poměr dopadu k vynaložené práci.
Maximálně pět položek, každá jednou větou s kódem kontroly a kategorií. **Řaď je podle dopadu, ne podle
pořadí v katalogu ani podle toho, co je nejsnazší.** Kdo má málo času, čte jen tuhle sekci.>

## Pokrytí auditu

| | Oblast | Stav | Detail |
|---|---|---|---|
| ✅ | Mergado data | k dispozici | |
| ✅ | Mergado konfigurace | k dispozici | |
| ✅ | Provoz | k dispozici | |
| ❌ | Pricing Fox | nelze zkontrolovat | <technický důvod> |
| ➖ | Bidding Fox | nainstalováno, nepoužívá se | <ověřeno: 0 strategií, 0 produktů na vstupu> |
| ⚠️ | Feed Image Editor | vynecháno | <rozhodnutí, ne omezení nástroje> |
| ⚠️ | Cross-app | částečně | <které kontroly byly vynechány> |
| ✅ | Volná AI pasáž | k dispozici | |

Tabulka má **vždy všech osm řádků**. Oblast, která se tohohle projektu netýká, dostane ➖ a jednovětý
důvod, nikdy se nevynechává: vynechaný řádek se čte jako „zkontrolováno a v pořádku".

Provedeno <N> ze <M> kontrol v relevantních katalogech. Jmenovatel nikdy nevynechávej.
Stavy `nelze zkontrolovat` a `vynecháno` znamenají různé věci a nesmí se slévat: první je
omezení nástroje nebo dat, druhé je rozhodnutí auditora.

## Aktuálnost dat

<Kdy proběhl poslední import, apply a export. Jestli je projekt is_dirty, tedy jestli mezi
poslední změnou pravidel a posledním přepočtem je mezera. Pravidla vytvořená po posledním
přepočtu se ve výstupu ještě neprojevila a jejich kontroly patří do sekce Nezkontrolováno.>

## Z1 Kritická závažnost

<nálezy podle struktury výše, řazené podle rozsahu>

## Z2 Vysoká závažnost

## Z3 Hygiena a udržovatelnost

## Další nálezy

<nálezy z kontrol AI1 až AI5, které obstály v sebekontrole AI6>

## Nezkontrolováno

| Kontrola | Stav | Důvod |
|---|---|---|
| <kód a název> | nelze zkontrolovat | <element v projektu není / rozšíření nedostupné / pravidlo ještě nebylo aplikováno / nástroj vrátil chybu X> |
| <kód a název> | vynecháno | <rozhodnutí auditora, například rozpočet nebo `--skip`> |

## Návrhy do katalogu auditu

<Nálezy s kódem NEW-*, tedy věci, které katalog ještě nepokrývá. Slouží k ladění skillu.
Když žádné nejsou, sekci vynech.>

## Přehled nálezů pro srovnání

| Kód | Závažnost | Kategorie | Titulek | Rozsah |
|---|---|---|---|---|
| <A1> | <Z1> | <[DATA FEEDU]> | <titulek> | <N produktů> |

<Tabulka obsahuje všechny nálezy na jednom místě. Slouží ke strojovému srovnání s příštím
auditem (kontrola X7): stejný kód s jiným rozsahem znamená posun, chybějící kód znamená,
že je nález vyřešený, a nový kód znamená regresi.>

## ℹ️ Doporučené nástroje a otevřené otázky

<Tipy, ne nálezy. Nemají závažnost a nepočítají se do počtů výše.
```

--------------------------------

### Create Rewriting Rule Data Structure

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-heureka-optimization/skills/mergado-heureka-optimization/SKILL.md

Correct structure for the create_rewriting_rule API call, ensuring element_path and new_content are nested within the data.rows array.

```json
{"rows": [{"element_path": "...", "new_content": "..."}]}
```

--------------------------------

### JSON struktura zálohy kampaně

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-campaign-backup/skills/mergado-campaign-backup/SKILL.md

Formát JSON souboru používaný pro ukládání dat kampaně, včetně pravidel, dotazů, proměnných a poznámek.

```json
{
  "campaign": "Black Friday 2026",
  "saved_at": "2026-11-28T10:00:00+01:00",
  "project_id": "...",
  "rules": [...],
  "queries": [...],
  "variables": [...],
  "notes": {
    "what_worked": "...",
    "what_to_change_next_time": "..."
  },
  "attachments": ["results-export.csv"]
}
```

--------------------------------

### Mode B Advisory Answer Template

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/shoptet-feed-doctor/skills/shoptet-feed-doctor/references/report-template.md

Template for providing an advisory answer from the knowledge base without feed data. It includes a snapshot date, a restated question with a label, and a direct answer with the cause and fix.

```text
**Shoptet Feed Doctor** — odpovídám z ověřené znalostní báze skillu (snapshot {date}).

**{1) Question restated briefly} — [LABEL]**

{Direct answer: real cause first, then the concrete fix — where exactly in Shoptet admin /
which Mergado rule. Same evidence discipline as Mode A, no tables.}

---

Chcete k některému bodu konkrétní kroky? Napište číslo.

*Tento skill pro vás s láskou vytvořil Mergado Team #MergadoFam*
```

--------------------------------

### Join values under one ID

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/shoptet-feed-doctor/skills/shoptet-feed-doctor/references/variant-merging.md

Joins multiple values belonging to the same ID into a single delimiter-separated string using TEXTJOIN.

```Excel
=TEXTJOIN(";"; PRAVDA; KDYŽ($E$2:$E$100=E2; $G$2:$G$100; ""))
```

--------------------------------

### Nabídka pokračování auditu

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/audit-projektu/skills/audit-projektu/SKILL.md

Standardizovaný text pro uzavření reportu, který nabízí další kroky v souladu se zásadou read-only.

```text
Který nález mám rozpracovat? Napište kódy kontrol, nebo „Z1" pro všechny kritické.
Audit sám nic v projektu nemění, takže můžu: rozepsat nález do detailu s dalšími důkazy,
připravit postup opravy krok za krokem, nebo vypsat pravidla a výběry, kterých se oprava dotkne.
```
Tokens:
Raw