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.

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

SubagentKdy nasadit
research-analystMediální rešerše — hledání článků o firmě v médiích
data-researcherEkonomická data z rejstříků (justice.cz, finstat.sk, Companies House atd.)
competitive-analystKonkurenční pozice firmy, tržní kontext
ExploreProzkoumá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ě:

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ě

ZeměPrimární zdrojURL / postupCo hledat
DEBundesanzeiger.debundesanzeiger.de → hledat firmuJahresabschluss (Bilanz, GuV)
ATFirmenbuch / OffeneRegister.atoffeneregister.atJahresabschluss
PLKRS Onlineekrs.ms.gov.pl/rdf/pd/Sprawozdanie finansowe
UKCompanies Housefind-and-update.company-information.service.gov.uk/company/ČÍSLO → Filing historyAnnual accounts, confirmation statement
USSEC EDGARsec.gov/cgi-bin/browse-edgar?company=NÁZEV&CIK=&type=10-K10-K annual reports
EU obecněOpenCorporatesopencorporates.com/companies/COUNTRY_CODE/IDZá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ěZdrojCo hledat
SKORSR.sk + FinStat.sk (prepojenia)Spoločníci, konatelia, prepojené subjekty
DEHandelsregister.de + NorthData.comGesellschafter, Geschäftsführer, Verflechtungen
ATFirmenbuch + CompanyCheck.atGesellschafter, Geschäftsführer
PLKRS Online (ekrs.ms.gov.pl)Wspólnicy, zarząd
UKCompanies House → Officers + PSC registerDirectors, persons with significant control
USSEC (proxy statements) + OpenCorporatesOfficers, 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
CZCzechCrunch, Lupa.cz, MAM (mam.cz), MediaGuru, BusinessInfo.cz, E15, HN (hn.cz), Forbes CZ
SKTrend.sk, Startitup.sk, Forbes SK, SME.sk
DE/ATHandelsblatt, Wirtschaftswoche, Der Standard, Gründerszene
UKTechCrunch, Financial Times, The Guardian Business, Sifted
USTechCrunch, 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 — inspirace: Tierra Verde přehled (viz referenční soubor)
  • 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

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 Tierra Verde
/xray IČO 28280725
/xray Rohlik Group
/xray Notino
/xray Gymbeam
/xray Revolut
/xray N26

$ARGUMENTS