### Recommended Path for Global Lists

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/mcp-recepty.md

Instead of direct calls to 'list_shops' or 'list_projects', use the navigation chain starting with 'list_user_eshops' and then 'list_shop_projects'.

```text
Navigation chain: `list_user_eshops(user_id)` → `list_shop_projects(shop_id)`
```

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

### Recommended Path for Project Rebuild

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/mcp-recepty.md

To trigger a project rebuild, navigate to Mergado UI → project → Settings → Regenerate → 'Start export'.

```text
Mergado UI → projekt → Nastavení → Přegenerování → "Spustit export"
```

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

### Get Import Logs

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/pravidla-cookbook.md

Retrieves the latest import logs for a project to verify if recent data was imported. This is a prerequisite check before triggering a rebuild.

```python
get_import_logs(projekt_id, limit=3)
```

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

### Mergado MCP Navigation Chain

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

This illustrates the mandatory top-down navigation path when interacting with Mergado MCP. Always start from the user ID and progressively list shops, projects, and then elements within a project. If user ID is unknown, prompt the user for their email or use list_users.

```text
[user_id] → list_user_eshops 
         → list_shop_projects 
         → list_project_apps / list_project_rules / list_project_elements / list_project_products
         → get_rule / get_element / get_apply_logs / ...
```

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

### Get Export Logs

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/pravidla-cookbook.md

Retrieves the latest export logs for a project. This helps in understanding the status of exports and if a rebuild is necessary or will be effective.

```python
get_export_logs(projekt_id, limit=3)
```

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

### Map E-shop Categories to Google Product Category (Fixed Mapping)

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/pravidla-cookbook.md

Assign a specific Google Product Category to products based on their e-shop category. This example maps products containing 'Boty' or 'Tenisky' to 'Apparel & Accessories > Shoes > Athletic Shoes'.

```Mergado Rules
Typ:   Přepsat
Element: g:google_product_category
Nová hodnota: Apparel & Accessories > Shoes > Athletic Shoes
Výběr:   produkty kde CATEGORYTEXT obsahuje "Boty" nebo "Tenisky"
```

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

### Onboarding New Output/Platform - Create Project

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/workflows.md

Command to create a new output for a chosen platform within Mergado. Requires shop ID, name, source feed URL, and format slugs.

```bash
create_project(shop_id, name, url, input_format, output_format)
```

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

### Recommended Path for Project Creation

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/mcp-recepty.md

To create a project, use the Mergado UI: eshop → Projects → '+ New project'.

```text
Mergado UI: eshop → Projekty → "+ Nový projekt"
```

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

### Recommended Path for Product Query

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/mcp-recepty.md

For 'query_products(project_id, query_id)', use 'list_project_products(project_id, mql=...)' with an MQL filter instead.

```text
Použij `list_project_products(project_id, mql=...)` s MQL filtrem
```

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

### Construct Product Descriptions from Brand, Category, and Parameters

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/pravidla-cookbook.md

Build a structured product description by combining manufacturer, name, category, and material. Use 'Doplnit' instead of 'Přepsat' if you want to preserve existing descriptions and only fill in missing ones.

```Mergado Rules
Typ:   Přepsat
Element: g:description
Nová hodnota: %manufacturer% %name%. Kategorie: %CATEGORYTEXT%. Materiál: %material%. Barva: %color%.
Výběr:   produkty kde g:description je prázdný
```

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

### Recommended Path for Product List Pagination

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/mcp-recepty.md

For 'list_project_products(per_page=int)', omit the 'per_page' parameter.

```text
Vynech `per_page`
```

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

### Fallback for get_user and get_project

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/mcp-recepty.md

Workaround for 'get_user(id)' and 'get_project(id)' when they have schema issues. Suggests using 'list_users' and 'list_shop_projects'.

```text
Použij `list_users`, `list_shop_projects(shop_id)`
```

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

### GMC Product Disapproval Audit Sequence (with Audit App)

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/mcp-recepty.md

Sequence for auditing product disapprovals when the Mergado Audit app is enabled. It involves getting audit results, identifying problematic validators, searching the knowledge base for solutions, querying products with specific conditions, and then creating/applying rules.

```sequence
3a. get_project_app(projekt_id, app="audit") → výsledky auditu
4a. Identifikuj problematické validátory (kterých produktů, kolik)
5a. search-in-knowledgebase("[konkrétní chyba GMC]") → doporučené řešení
6a. query_products(projekt_id, podmínka='element X je prázdný') → 5 ukázek
7a. Navrhni opravné pravidlo → POČKEJ NA POTVRZENÍ
8a. create_project_query, create_rule, assign_query_to_rule, update_queried_products
9a. trigger_project_rebuild → propsat změny do výstupu
10a. get_apply_log(latest) → ověř, kolik produktů bylo opraveno
```

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

### Recommended Path for Project Update

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/mcp-recepty.md

For updating project settings, including 'update_project' and 'update_project(is_dirty=true)', use the Mergado UI.

```text
Mergado UI → projekt → Nastavení
```

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

### Recommended Path for Event Logs

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/mcp-recepty.md

For 'get_shop_event_logs', 'get_access_logs(project_id)' provides partial visibility.

```text
`get_access_logs(project_id)` má částečnou viditelnost
```

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

### Recommended Path for Product List Extraction

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/mcp-recepty.md

When using 'list_project_products(values_to_extract=...)', omit 'values_to_extract' and fetch values separately.

```text
Vynech `values_to_extract`, načti hodnoty samostatně
```

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

### Fallback for get_app_by_name

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/mcp-recepty.md

Workaround for 'get_app_by_name(name)' when the schema requires 'latest_release_date'. Suggests using 'list_project_apps'.

```text
Použij `list_project_apps(project_id)`
```

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

### New Output Creation Sequence

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/mcp-recepty.md

Sequence for creating a new output project for platforms like Google Shopping, Heureka, or Glami. It involves navigating to the shop, listing existing projects, fetching platform specifications, analyzing input elements, explaining the plan to the user, and then creating the project with necessary rules.

```sequence
1. Navigation chain → shop_id (kde má být nový výstup)
2. list_shop_projects(shop_id) → ověř, zda už výstup pro tuto platformu neexistuje
3. get_format(slug) → načti specifikaci platformy
   slugy: "google.cz", "google.sk", "heureka.cz", "heureka.sk", "zbozi.cz.1", 
          "glami.cz", "facebook.cz", "allegro.pl"
4. list_project_elements(zdrojový_projekt_id) → co máš ve vstupu
5. (Gap analysis v hlavě) → které GMC/Heureka povinnosti chybí
6. Vysvětli plán uživateli: "Vytvořím nový výstupní projekt formátu X, ten už bude napojený na tvůj vstupní feed. Chybí ti tyto povinnosti: ... — doplníme pravidly."
7. POČKEJ NA POTVRZENÍ
8. create_project (formát, shop_id, název) → output_project_id
9. Pro každou chybějící povinnost: create_rule + případně create_project_query + assign_query_to_rule
10. trigger_project_rebuild(output_project_id) → ať se hned vygeneruje výstup
11. Vrať uživateli URL výstupního feedu (najdeš ji v project objektu po vytvoření)
```

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

### Fallback for Rule Creation with Array Parameters

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/mcp-recepty.md

If calling 'create_rule.queries' with an array fails, create the rule using the Mergado UI.

```text
Pokud volání s array selže, vytvoř pravidlo v Mergado UI
```

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

### Add 'SALE' to Titles for Discounted Products

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/pravidla-cookbook.md

Prepend 'AKCE - ' to the existing product title for items that are on sale (price is less than original price). Be cautious about using promotional words in titles, as it may lead to Google Merchant Center warnings.

```Mergado Rules
Typ:   Přepsat
Element: g:title
Nová hodnota: AKCE - %g:title%
Výběr:   produkty kde PRICE_VAT < ORIGINAL_PRICE
```

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

### Fallback for element_values_post

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/mcp-recepty.md

Workaround for 'element_values_post' when the schema requires a non-existent 'path'. Suggests using 'list_project_products' for practical value reading.

```text
Pro praktické čtení hodnot zkus `list_project_products(project_id, mql=...)`
```

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

### Fallback for list_supported_formats

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/mcp-recepty.md

Workaround for 'list_supported_formats' when it returns a schema error. Suggests using 'get_format(slug)' with specific slugs.

```text
Použij `get_format(slug)` s konkrétním slugem (`google.cz`, `heureka.cz`, `zbozi.cz.1`, `glami.cz`, `facebook.cz`, `allegro.pl`)
```

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

### Recommended Path for Billing Data

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/mcp-recepty.md

For 'get_user_billing', redirect the user to the 'app.mergado.com/billing' URL.

```text
Přesměruj uživatele na `app.mergado.com/billing`
```

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

### Project Lifecycle Management

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/mcp-recepty.md

Sequence of steps for pausing, deleting, or restarting a project. Includes user confirmation and handling of schema errors.

```text
1. Navigation chain → najdi konkrétní projekt
2. Ověř aktuální stav v list_shop_projects: is_paused, deleted_at
3. ROZLIŠ A POTVRĎ S UŽIVATELEM:
   - Pozastavit (is_paused=true) — export se zastaví, fakturace pokračuje, lze kdykoli znovu zapnout
   - Smazat (delete_project) — NEVRATNÉ, fakturace končí, projekt zmizí
   - Snížit tarif — alternativa pokud uživatel chce ušetřit, ne ztratit
4. Pokud get_project(id) má schema error → použij info z list_shop_projects (má vše potřebné)
5. update_project(id, is_paused=true) NEBO delete_project(id) PO POTVRZENÍ
6. Pokud pozastavujeme: upozorni na měsíční fakturaci ("Tarif jede dál — pokud chceš ušetřit, je rozdíl mezi pozastavit a smazat.")
7. Pokud znovuspouštíme: trigger_project_rebuild po unpause, ať se výstup obnoví
```

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

### Fallback for Batch Rewriting Rule

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/mcp-recepty.md

For 'create_rule.data' (array for 'batch_rewriting'), use the Mergado UI for creating batch rewriting rules.

```text
Pro `batch_rewriting` rule použij Mergado UI
```

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

### Map E-shop Categories to Google Product Category (CSV Import)

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/pravidla-cookbook.md

Import a custom CSV file to map e-shop categories to Google Product Categories. This is suitable for projects with many unique categories, using 'shop_kategorie' and 'google_kategorie' columns.

```Mergado Rules
Typ:   Import datového souboru
Soubor: kategorie_mapa.csv  (sloupce: shop_kategorie, google_kategorie)
Klíč:    CATEGORYTEXT  →  shop_kategorie
Cíl:     g:google_product_category  ←  google_kategorie
```

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

### Fallback for get_current_user

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/mcp-recepty.md

Workaround for the 'get_current_user' tool when it requires a 'user' wrapper but returns a flat structure. Suggests asking for email or using 'list_users'.

```text
Zeptej se na e-mail nebo použij `list_users`
```

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

### Trigger Project Rebuild

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/pravidla-cookbook.md

Use this tool to manually trigger a project rebuild. This is useful when changes are made to pricing, rules, or if exports have stopped. Always verify import/export logs and the project's dirty status before triggering.

```text
Tool:       trigger_project_rebuild(projekt_id)
Trigger:    "snížil jsem ceny, ale v Googlu jsou pořád staré"
            "změnil jsem pravidlo, chci ho hned vidět ve feedu"
            "exporty se zastavily, hni s tím"
```

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

### Project Deletion Confirmation Prompt

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/mcp-recepty.md

A safety prompt to ensure user understanding before irreversible project deletion. It highlights the consequences and offers pausing as an alternative.

```text
"Můžu smazat — ale chci se ujistit. Smazání je nevratné: ztratíme historii, statistiky, pravidla, URL výstupního feedu. Pokud je to jen na pár měsíců, doporučím raději pozastavit. Co preferuješ?"
```

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

### Sekvence Volání pro Diagnostiku Feedů

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/mcp-recepty.md

Použijte tuto sekvenci pro diagnostiku problémů s feedem. Zahrnuje kontrolu počtu produktů, importních a exportních logů a stavu pravidel.

```plaintext
1. Navigation chain → projekt_id
2. list_project_products(projekt_id) → count produktů (porovnej s tím, co uživatel čeká)
3. get_import_logs(projekt_id) → posledních 5–10 importů, status
4. get_export_logs(projekt_id) → posledních 5–10 exportů, status
5. get_apply_logs(projekt_id) → kdy se naposled aplikovala pravidla
6. Pokud nějaký log podezřele selhává → get_import_log(log_id) nebo get_export_log(log_id) pro detail
```

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

### Set Availability Based on Stock

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/pravidla-cookbook.md

Sets product availability to 'in stock' if the STOCK element is greater than 0.

```text
Typ:   Přepsat
Element: g:availability
Nová hodnota: in stock
Výběr:   produkty kde STOCK > 0
```

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

### Format Price

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/pravidla-cookbook.md

Changes the price format from '1290 Kč' to '1290.00 CZK' using regex.

```text
Typ:   Najít a nahradit  (regex)
Element: g:price
Najít:   (\d+)\s*Kč
Nahradit: $1.00 CZK
```

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

### Získání User ID pro Mergado MCP

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/mcp-recepty.md

Při problémech se schématem get_current_user, použijte tyto workaroundy pro získání user_id. Nikdy nepokračujte bez znalosti user_id.

```plaintext
1. Pokud znáš user_id z předchozí konverzace nebo z `list_users` → použij ho rovnou.
2. Zeptej se uživatele na e-mail nebo user_id (typicky to ví — vidí ho v Mergado UI).
3. Jako poslední možnost zavolej `list_users` (na test účtech vrátí jediného usera; v produkci větší).
```

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

### Základní Navigační Řetězec v Mergado MCP

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/mcp-recepty.md

Toto je výchozí trasa pro všechna volání API. Vždy se propracovávejte k cíli přes specifické seznamy na úrovni uživatele, e-shopu a projektu, nikoli globální seznamy.

```plaintext
[uživatel] → list_user_eshops(user_id) 
          → list_shop_projects(shop_id) 
          → list_project_apps / list_project_rules / list_project_elements / list_project_products
          → get_rule / get_element / ...
```

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

### Structure Product Titles

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/pravidla-cookbook.md

Create structured product titles by combining manufacturer, name, and color. Use a follow-up rule to clean up extra spaces if any component is missing.

```Mergado Rules
Typ:   Přepsat
Element: g:title  (resp. TITLE pro Heureka, NAME pro Sklik)
Nová hodnota: %manufacturer% %name% %color%
Výběr:   Všechny produkty   (případně omez na konkrétní kategorie)
```

```Mergado Rules
Typ:   Najít a nahradit  s regex `\s+` → ` ` jako follow-up.
```

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

### Sekvence Volání pro Případ Prázdného Feedu

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/mcp-recepty.md

Tato sekvence se používá, když projekt neobsahuje žádné produkty nebo se feed nestáhl. Zahrnuje ověření počtu produktů a analýzu importních logů.

```plaintext
1. Navigation chain → projekt_id
2. list_project_products(projekt_id) → ověř, zda je opravdu 0
3. get_import_logs(projekt_id, limit=10)
4. Identifikuj poslední úspěšný + první neúspěšný log
5. get_import_log(last_failed_id) → konkrétní chyba (HTTP 404, parse error, timeout)
6. (Pokud podezření na změnu URL feedu) zjisti current input URL: navigate v project objektu
```

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

### Hide Products Without Image

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/pravidla-cookbook.md

Hides products where the IMGURL element is empty.

```text
Typ:   Skrýt produkt
Výběr:   produkty kde IMGURL je prázdný
```

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

### Create Custom Element for Season

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/pravidla-cookbook.md

Creates a custom element, 'custom_label_0', intended for use with seasonal data. This element can then be populated using 'Přepsat' (Overwrite) rules based on product attributes like CATEGORYTEXT, price, or import turnover.

```text
Typ:   Vlastní element
Element: custom_label_0
```

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

### Mergado UI Rule Data Format

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/slovnik-pojmu.md

This is the format for rule data as actually used by the Mergado UI, employing internal structures like $struct, $ref, and $ep. Skills can read this format but should not generate it manually.

```json
{
  "type": "rewriting",
  "element_path": null,
  "data": {
    "$struct": {"rows": [{"elementPath": "$ep.1", "newContent": "$ref.1"}]},
    "$ref":   {"$ref.1": "Mergado Test"},
    "$ep":    {"$ep.1": "g:brand"}
  }
}
```

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

### Fallback for list_defined_rules

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/mcp-recepty.md

Workaround for 'list_defined_rules' when the schema requires 'total_results'. Suggests using a hard-coded allowlist of rule types.

```text
Použij hard-coded allowlist rule typů ze `slovnik-pojmu.md`
```

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

### Hide Products Below Price Threshold

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/pravidla-cookbook.md

Hides products with a PRICE_VAT less than 100.

```text
Typ:   Skrýt produkt
Výběr:   produkty kde PRICE_VAT < 100
```

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

### Set Multi-level Product Type

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/pravidla-cookbook.md

Set the product_type element using the CATEGORYTEXT. If CATEGORYTEXT is stored hierarchically in Mergado (e.g., 'Elektronika | Mobily | Smartphone'), it will be exported as a multi-level product type understandable by Google Merchant Center.

```Mergado Rules
Typ:   Přepsat
Element: g:product_type
Nová hodnota: %CATEGORYTEXT%
```

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

### Add Color from E-shop Parameter

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/pravidla-cookbook.md

Populates the g:color element with the value from a PARAM element named 'Barva'.

```text
Typ:   Doplnit
Element: g:color
Nová hodnota: %PARAM { @@VALUE = "Barva" } | VAL%
Výběr:   produkty kde g:color je prázdný
```

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

### Add Additional Image Links

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/pravidla-cookbook.md

Adds additional image links from all available IMAGE elements.

```text
Typ:   Přepsat
Element: g:additional_image_link
Nová hodnota: %IMAGE@1% (druhý obrázek v pořadí; pozice indexovaná od 0)
Výběr:   omez podle potřeby
```

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

### Set Availability to Out of Stock

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/pravidla-cookbook.md

Sets product availability to 'out of stock' if the STOCK element is 0 or empty.

```text
Typ:   Přepsat
Element: g:availability
Nová hodnota: out of stock
Výběr:   produkty kde STOCK = 0 nebo STOCK je prázdný
```

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

### Rewrite Image Link

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/pravidla-cookbook.md

Replaces the main image link with the second image in the sequence.

```text
Typ:   Přepsat
Element: g:image_link
Nová hodnota: %IMAGE@1%   (druhý obrázek v pořadí; pozice indexovaná od 0)
Výběr:   omez podle potřeby
```

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

### Set identifier_exists=no When GTIN and MPN are Missing

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/pravidla-cookbook.md

Add the 'identifier_exists' attribute with the value 'no' for products where both GTIN and MPN are empty. This explicitly tells platforms like Google Shopping that these identifiers are not available for the product.

```Mergado Rules
Typ:   Doplnit  (nebo Přepsat)
Element: g:identifier_exists
Nová hodnota: no
Výběr:   produkty kde g:gtin je prázdný A g:mpn je prázdný
```

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

### Simplified API Rule Data Format

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/slovnik-pojmu.md

This is the simplified format for rule data as documented for the API. Rules created in this format cannot be opened in the Mergado UI.

```json
{"type": "rewriting", "element_path": "g:brand", "data": {"new_content": "Mergado Test"}}
```

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

### Hide Products with 'Sold Out' in Description

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/pravidla-cookbook.md

Hides products where the DESCRIPTION contains specific 'sold out' keywords using regex.

```text
Typ:   Skrýt produkt
Výběr:   produkty kde DESCRIPTION obsahuje (regex) "(vyprodáno|není skladem|sold out|nedostupn)"
```

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

### Synchronize Stock from External Feed

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/pravidla-cookbook.md

Synchronizes stock levels from an external XML feed.

```text
Typ:   Import datového souboru
Soubor: sklady.xml  (URL — pravidelně načítaná)
Klíč:    g:id  ↔  product_id
Cíl:     STOCK  ←  qty_available
```

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

### Reduce Prices by 10%

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/pravidla-cookbook.md

Applies a 10% reduction to product prices.

```text
Typ:   Přepsat
Element: PRICE_VAT  (resp. g:price)
Nová hodnota: %PRICE_VAT% * 0.9     (Mergado podporuje matematické výrazy)
```

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

### Supplement Brand from E-shop Variable

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/pravidla-cookbook.md

Fill in the 'brand' attribute using the 'manufacturer' variable from the e-shop data, but only for products where the 'brand' is currently empty and 'manufacturer' is not. This helps ensure brand information is present where possible.

```Mergado Rules
Typ:   Doplnit
Element: g:brand
Nová hodnota: %manufacturer%
Výběr:   produkty kde g:brand je prázdný a manufacturer není prázdný
```

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

### Import Margins from CSV

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/pravidla-cookbook.md

Imports margin data from a CSV file into custom labels.

```text
Typ:   Import datového souboru
Soubor: marze.csv (URL nebo upload)
Klíč:    g:id  ↔  produkt_id
Cíl:     g:custom_label_3  ←  marže_proc
```

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

### Interpretace Signálů při Diagnostice Feedů

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/mcp-recepty.md

Tabulka popisuje různé signály a jejich význam při diagnostice problémů s feedem. Poskytuje doporučení pro akce na základě zjištěných stavů.

```plaintext
| Signál | Co to znamená | Akce |
|---|---|---|
| `items_processed: 0` při importu | Vstupní feed je prázdný nebo nedostupný | Zkontroluj import URL, status HTTP |
| `last_import_at` > 24 hodin | Importy se zastavily | Hledej v `get_import_log` poslední failure |
| `last_export_at` zaostává za `last_import_at` o > 1 den | Exporty se zastavily, ale imports běží | → recept #7 (rebuild) |
| `is_dirty: true` dlouho | Projekt potřebuje rebuild, ale ten se nespouští | → recept #7 |
| `is_paused: true` | Projekt je manuálně pozastavený | Zeptej se, zda úmyslně |
```

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

### GMC Product Disapproval Audit Sequence (Fallback without Audit App)

Source: https://github.com/mergado/mergado-skills/blob/main/plugins/mergado-asistent/skills/mergado-asistent/references/mcp-recepty.md

Fallback sequence for auditing product disapprovals when the Mergado Audit app is not enabled. It involves fetching the Google Shopping specification, listing existing project elements, performing a manual gap analysis, and then querying products to identify issues.

```sequence
3b. get_format("google.cz") → načti GMC specifikaci povinných elementů
4b. list_project_elements(projekt_id) → seznam elementů, které ve výstupu jsou
5b. (Manuální gap analysis) → identifikuj povinné, které chybí nebo můžou být prázdné
6b. query_products s podmínkou "[element] je prázdný" → kolik produktů to zasáhne
7b. Stejně jako 7a–10a výše
```