X-Ray — hloubková analýza firmy

Kdy použít

• Uživatel chce analyzovat konkrétní firmu — ekonomika, vlastnictví, lidé, média
• Trigger fráze: "/xray", "analyzuj firmu", "přehled firmy", "company analysis"

Vstup

Uživatel zadá název firmy (nebo IČO, URL na rejstřík, web firmy) v $ARGUMENTS. Pokud $ARGUMENTS je prázdný, zeptej se:

Kterou firmu chceš analyzovat? (název, IČO nebo URL)

Režim: MAX EFFORT

Tento skill pracuje v režimu maximálního úsilí. To znamená:

• Nešetři počtem vyhledávání — víc dat = lepší výstup
• Používej Agent tool pro paralelní research více datových oblastí současně
• Čti celé stránky rejstříků, ne jen snippety
• Iteruj — první kolo dat informuje druhé kolo (např. zjištěné dcery → hledej data i pro ně)
• Ověřuj data z více zdrojů
• Výstupní HTML musí být vizuálně propracovaný a datově bohatý

Subagenti pro research

Tento skill využívá specializované subagenty pro paralelní, hloubkový research. Spouštěj je přes Agent tool s parametrem subagent_type. Vždy spouštěj více agentů současně (paralelně) pro maximální efektivitu.

Dostupní subagenti

Orchestrace subagentů

Spusť tyto subagenty paralelně v první fázi:

1. data-researcher — ekonomická data + vlastnická struktura z rejstříků
2. research-analyst — mediální rešerše (hledání článků o firmě)
3. Explore (nebo WebFetch) — prozkoumání webu firmy (popis, produkty, tým, certifikace, obrázky)

Každému subagentovi předej:

• Název firmy, IČO, zemi
• Konkrétní URLs na rejstříky (viz tabulky zdrojů níže)
• Jasně specifikovaný požadavek na formát dat (co přesně vrátit)

Po dokončení všech subagentů → syntéza dat → generování HTML.

Non-negotiables

1. Pro CZ firmy: data MUSÍ být z justice.cz PDF. Žádné proxy zdroje (kurzy.cz, rejstrik.penize.cz) jako primární. Stáhni PDF účetních závěrek, přečti je lokálně, extrahuj čísla.
2. Pro SK firmy: data MUSÍ být z finstat.sk. Přímo v HTML.
3. Každý rok musí mít vlastní stažený PDF (pokud je dostupný ve Sbírce listin).
4. Nikdy nevymýšlej čísla. Pokud PDF neobsahuje VZZ (zkrácený rozsah), vytěž rozvahu a čistý zisk z ní. Jasně označ co je z VZZ a co z rozvahy.

Postup — 6 fází

Fáze 1: Identifikace firmy a země

1. Zjisti zemi registrace firmy (CZ, SK, DE, AT, PL, UK, US, jiná)
2. Zjisti IČO (nebo ekvivalent: Company Number, HRB, KRS...)
3. Zjisti oficiální název, sídlo, datum založení, základní kapitál
4. Pokud má firma pobočky/dcery v jiných zemích, identifikuj je taky

Pro CZ firmy — ARES API pro rychlou identifikaci:

WebFetch: https://ares.gov.cz/ekonomicke-subjekty-v-be/rest/ekonomicke-subjekty/{ICO}
→ název, IČO, sídlo, datum založení, právní forma

Fáze 2: Ekonomická data

#### CZ firmy — POVINNÝ WORKFLOW (justice.cz → PDF → lokální čtení)

Toto je ověřený, funkční postup. Dodržuj ho přesně.

Fallback: or.justice.cz občas WebFetch blokuje nebo vrací prázdno. Po max 2 neúspěšných pokusech přepni na Playwright MCP (mcp__playwright__browser_navigate + snapshot) — neopakuj dál selhávající WebFetch. Download PDF pak přes curl s URL získanou z Playwright snapshotu.

Krok 1: Získej subjektId

WebFetch: https://or.justice.cz/ias/ui/rejstrik-$firma?nazev=NÁZEV+FIRMY
→ z výsledků získej subjektId (např. 625229)

Alternativně pokud máš IČO:

WebFetch: https://or.justice.cz/ias/ui/rejstrik-$firma?nazev=&rcIco=IČÍSLO

Krok 2: Získej seznam dokumentů ze Sbírky listin

WebFetch: https://or.justice.cz/ias/ui/vypis-sl-firma?subjektId={SUBJEKT_ID}
→ vrátí seznam dokumentů s relativními URL na detaily
→ hledej: "účetní závěrka", "rozvaha", "výkaz zisku a ztráty" za každý rok
→ zaznamenej si: dokument ID, subjektId, spis pro každý rok

Krok 3: Pro každý rok — získej download link

WebFetch: https://or.justice.cz/ias/ui/vypis-sl-detail?dokument={DOK_ID}&subjektId={SUBJEKT_ID}&spis={SPIS_ID}
→ z odpovědi extrahuj download link: /ias/content/download?id={HASH}

Krok 4: Stáhni PDF na lokální disk

curl -sL -o /tmp/{firma}-{rok}.pdf "https://or.justice.cz/ias/content/download?id={HASH}"

Krok 5: Přečti PDF a extrahuj data

Read: /tmp/{firma}-{rok}.pdf
→ PDF obsahuje standardizovaný formulář rozvahy a VZZ
→ Extrahuj klíčové řádky (viz "Co vytěžit z PDF" níže)

Opakuj kroky 3–5 pro KAŽDÝ dostupný rok. Stahuj a čti paralelně kde je to možné (více curl příkazů najednou).

Co vytěžit z PDF účetní závěrky:

Z Výkazu zisku a ztráty (VZZ):

• ř. 001: Tržby z prodeje výrobků a služeb (I.)
• ř. 002: Tržby za prodej zboží (II.)
• ř. 003: Výkonová spotřeba (A.)
• ř. 009: Osobní náklady (D.)
• ř. 016: Odpisy (E.1.1.) — pro výpočet EBITDA
• ř. 030: Provozní výsledek hospodaření (**)
• ř. 048: Finanční výsledek hospodaření (*)
• ř. 049: VH před zdaněním (**)
• ř. 055: VH za účetní období (***) = čistý zisk/ztráta
• ř. 056: Čistý obrat za účetní období (*)

Z Rozvahy (aktiva):

• ř. 001: Aktiva celkem
• ř. 003: Stálá aktiva (B.)
• ř. 037: Oběžná aktiva (C.)

Z Rozvahy (pasiva):

• ř. 002: Vlastní kapitál (A.)
• ř. 021: VH běžného účetního období (A.V.)
• ř. 023: Cizí zdroje (B.+C.)

Výpočet EBITDA: Provozní VH (ř.030) + Odpisy (ř.016)

POZOR: Každý PDF obsahuje sloupce "sledované období" (aktuální rok) a "minulé období" (předchozí rok). Tím můžeš z jednoho PDF získat data za 2 roky.

#### SK firmy

WebFetch: https://finstat.sk/{ICO}
→ tržby, zisk, aktiva, zaměstnanci přímo v HTML tabulkách

#### Ostatní země

Záložní/doplňkové zdroje pro jakoukoliv zemi:

• opencorporates.com — základní identifikace + propojení
• northdata.com — DE/AT/CH firmy, propojení osob
• Google search: "název firmy" annual report OR výroční zpráva filetype:pdf

Fáze 3: Vlastnická struktura a vztahy

#### CZ firmy — POVINNÝ WORKFLOW

WebFetch: https://or.justice.cz/ias/ui/rejstrik-firma.vysledky?subjektId={SUBJEKT_ID}&typ=UPLNY
→ vrátí kompletní úplný výpis: všichni společníci (aktuální i historičtí),
  jednatelé, podíly, datum změn, předmět podnikání

Toto funguje spolehlivě přes WebFetch a vrací strukturovaná data.

#### Ostatní země

Co vytěžit:

• Aktuální vlastníci + podíly (%)
• Timeline změn vlastnictví od založení (kdo kdy vstoupil/odešel)
• Jednatelé / Board members — kdo, od kdy
• Propojené firmy (dcery, matky, sesterské společnosti)
• Zajímavé osoby — kdo to je, čím jsou známí, další firmy

Fáze 4: Web firmy a produkty

Pomocí browser nástrojů nebo WebFetch:

1. Načti hlavní web firmy (stránky: homepage, o nás, produkty/služby, tým, kontakt)
2. Zjisti: popis firmy, produkty/služby, certifikace, tým, partnery, obchodní model
3. Extrahuj URL klíčových obrázků (logo, produkty, tým, kanceláře) pro použití v HTML
4. Zjisti brandové barvy z webu (pro design HTML výstupu)

Fáze 5: Mediální rešerše

Hledej zmínky firmy v médiích podle země:

Co vytěžit:

• 5–15 nejrelevantnějších článků
• Pro každý: zdroj, datum, titulek, URL, 1-věta anotace
• Rozřadit chronologicky (nejnovější nahoře)

Fáze 6: Generování HTML

Vytvoř standalone HTML stránku se všemi daty. Struktura:

1. HEADER
   - Logo firmy (z webu, pokud dostupné)
   - Název firmy (h1)
   - Podtitulek (obor, claim, jednovětý popis)
   - Meta badges: IČO, rok založení, sídlo, základní kapitál

2. O FIRMĚ
   - 2-3 odstavce popis (co dělá, čím je zajímavá, jak velká je)
   - KPI grid (4 boxy: počet produktů/zákazníků, zaměstnanců, poboček/trhů, let na trhu)
   - Tagy (obor, certifikace, klíčová slova)
   - Obrázky z webu firmy (grid 2-3 obrázky)

3. HOSPODÁŘSKÉ VÝSLEDKY
   - Chart.js grafy: Obrat (bar) + EBITDA/Zisk (bar, dva datasety)
   - Hlavní tabulka: rok | obrat | EBITDA | EBITDA% | čistý zisk | poznámka
   - Komentář k vývoji (3-5 bullets — trendy, zlomové body, důvody)
   - Detailní historická tabulka (rozvaha, VZZ) v <details> tagu
   - Pokud existují zahraniční entity — zvlášť tabulka pro každou

4. VLASTNICKÁ STRUKTURA
   - Vizuální podíly (karty s % a jménem)
   - Timeline změn (vertikální timeline: datum + co se stalo)

5. KLÍČOVÉ OSOBNOSTI
   - Person cards: avatar (iniciály), jméno, popis (2-3 věty), role tag
   - Pro každou osobu: kdo je, čím je zajímavá, propojení na další firmy

6. OBCHODNÍ MODEL & DISTRIBUCE
   - KPI grid
   - Distribuční kanály / zákazníci (seznam)
   - Produktové portfolio / služby

7. MEDIÁLNÍ REŠERŠE
   - Chronologicky řazené články
   - Pro každý: zdroj badge, datum, odkaz (titulek), 1-věta anotace

8. SHRNUTÍ & HODNOCENÍ
   - Silné stránky (bullets)
   - Rizika a otázky (bullets)
   - Celkové hodnocení (highlight box, 3-5 vět)

9. FOOTER
   - Datum zpracování
   - Seznam použitých zdrojů

Pravidla pro HTML výstup

Design

• Čistý, moderní design. Konzistence mezi analýzami > originalita: po první spokojené analýze si ulož výsledný HTML jako reference.html vedle SKILL.md a příště z něj — <style> a strukturu sekcí — vycházej místo návrhu od nuly.
• Barvy odvozené od brandingu firmy (zjisti z webu)
• Fallback palety podle oboru:
• Eco/bio: zelená (#2d5016 → #6b9b37)
• Tech/SaaS: modrá (#1a365d → #3182ce)
• Retail/FMCG: oranžová (#c05621 → #dd6b20)
• Finance: tmavě modrá (#1a202c → #2d3748)
• Default: šedá (#2d3748 → #4a5568)
• Gradient v headeru
• Responsive (mobile-friendly s media queries)
• Tailwind NE — čistý CSS ve <style> tagu

CSS komponenty (povinné)

• .section — bílá karta s border-left accent barvou, box-shadow
• .kpi-grid + .kpi — grid KPI karet
• .ownership-chart + .ownership-bar — vizuální podíly
• .timeline + .timeline-item — vertikální timeline
• .person-card + .avatar + .role-tag — karty osobností
• .media-item — položky mediální rešerše
• .highlight-box — zvýrazněný box pro důležité poznámky
• .tag — malé tagy/badges
• table se zebra striping, .num (right-align), .positive (zelená), .negative (červená)

Technické

• Standalone HTML — žádné externí CSS (kromě Chart.js CDN)
• Chart.js pro grafy: <script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
• Čísla v tabulkách: text-align: right; font-variant-numeric: tabular-nums
• Kladné hodnoty zeleně (.positive), záporné červeně (.negative)
• <details> tag pro rozsáhlé historické tabulky
• Obrázky z webu firmy přes přímé URL (nestahovat lokálně)
• alt texty na všech obrázcích
• Pokud výstup publikuješ na web s vlastním auth mechanismem, přidej jeho skript před </body> — u lokálního HTML v pracovní složce ho vynech (odkaz by byl mrtvý)

Jazyk

• Čeština pro CZ/SK firmy
• Angličtina pro firmy z jiných zemí
• Pokud uživatel specifikuje jazyk, použij ten

Výstup

• Ulož HTML do aktuálního pracovního adresáře jako {nazev-firmy}-prehled.html
• Název souboru: lowercase, diakritika odstraněna, mezery nahrazeny pomlčkami
• Na konci ukaž cestu k souboru a zeptej se jestli chce uživatel něco doplnit nebo upravit

Handling chybějících dat

• Pokud subagent nevrátí data → v HTML zobraz sekci s poznámkou "Data nejsou veřejně dostupná" (ne vynechávat sekci)
• Pokud jsou jen částečná data (např. rozvaha bez VZZ) → zobraz co máš + poznámku
• Pokud firma nemá web → přeskoč sekci obrázků, popis postav na datech z rejstříku

Příklady použití

/xray IČO 28280725
/xray Rohlik Group
/xray Notino
/xray Gymbeam
/xray Revolut
/xray N26

Changelog

• 2026-07-02 — Playwright fallback pro or.justice.cz (po 2 selháních WebFetch). auth.js jen při publikaci na web s vlastním auth mechanismem, ne u lokálního HTML. Do description přidán alias /xray (název skillu je firma-info — trigger teď matchuje obojí).

$ARGUMENTS