# Firma Info

> Hloubková analýza firmy z veřejných zdrojů. Z názvu/IČO vytvoří kompletní přehledovou HTML stránku s ekonomickými daty (justice.cz, finstat.sk, Companies House...), vlastnickou strukturou, klíčovými osobnostmi a mediální rešerší. Podporuje CZ, SK, DE, AT, PL, UK, US firmy. Trigger: "/firma-info", "/xray", "analyzuj firmu", "přehled firmy".

- Skill: `jmech-pepa/firma-info` (Agent Skill)
- Install (CLI): `npx skillmds@latest add jmech-pepa/firma-info`
- Raw SKILL.md: https://api.skillmd.com/api/skills/jmech-pepa/firma-info/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: jmech-pepa (https://skillmd.com/u/jmech-pepa)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/jmech-pepa/firma-info

---


# 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

| Subagent | Kdy nasadit |
|---|---|
| `research-analyst` | Mediální rešerše — hledání článků o firmě v médiích |
| `data-researcher` | Ekonomická data z rejstříků (justice.cz, finstat.sk, Companies House atd.) |
| `competitive-analyst` | Konkurenční pozice firmy, tržní kontext |
| `Explore` | Prozkoumání webu firmy (produkty, tým, certifikace, obrázky) |

### 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**
```bash
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ě

| Země | Primární zdroj | URL / postup | Co hledat |
|------|---------------|--------------|-----------|
| **DE** | Bundesanzeiger.de | `bundesanzeiger.de` → hledat firmu | Jahresabschluss (Bilanz, GuV) |
| **AT** | Firmenbuch / OffeneRegister.at | `offeneregister.at` | Jahresabschluss |
| **PL** | KRS Online | `ekrs.ms.gov.pl/rdf/pd/` | Sprawozdanie finansowe |
| **UK** | Companies House | `find-and-update.company-information.service.gov.uk/company/ČÍSLO` → Filing history | Annual accounts, confirmation statement |
| **US** | SEC EDGAR | `sec.gov/cgi-bin/browse-edgar?company=NÁZEV&CIK=&type=10-K` | 10-K annual reports |
| **EU obecně** | OpenCorporates | `opencorporates.com/companies/COUNTRY_CODE/ID` | Základní finanční data |

**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ě

| Země | Zdroj | Co hledat |
|------|-------|-----------|
| **SK** | ORSR.sk + FinStat.sk (prepojenia) | Spoločníci, konatelia, prepojené subjekty |
| **DE** | Handelsregister.de + NorthData.com | Gesellschafter, Geschäftsführer, Verflechtungen |
| **AT** | Firmenbuch + CompanyCheck.at | Gesellschafter, Geschäftsführer |
| **PL** | KRS Online (ekrs.ms.gov.pl) | Wspólnicy, zarząd |
| **UK** | Companies House → Officers + PSC register | Directors, persons with significant control |
| **US** | SEC (proxy statements) + OpenCorporates | Officers, directors, major shareholders |

**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ě:

| Země | Klíčová média |
|------|--------------|
| CZ | CzechCrunch, Lupa.cz, MAM (mam.cz), MediaGuru, BusinessInfo.cz, E15, HN (hn.cz), Forbes CZ |
| SK | Trend.sk, Startitup.sk, Forbes SK, SME.sk |
| DE/AT | Handelsblatt, Wirtschaftswoche, Der Standard, Gründerszene |
| UK | TechCrunch, Financial Times, The Guardian Business, Sifted |
| US | TechCrunch, Bloomberg, WSJ, Crunchbase News, PitchBook |
| Obecně | Google News search: `"název firmy"` |

**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

