For the complete documentation index, see llms.txt. This page is also available as Markdown.

Podle čeho umí BizMachine MCP konektor filtrovat firmy

Přehled všech filtrů, podle kterých BizMachine MCP konektor vyhledává firmy, s příklady vět a upozorněními na časté chyby.

Aktualizováno: 23. září 2026

BizMachine MCP konektor filtruje firmy podle velikosti, oboru a místa, podle obchodních indikátorů a AI Prioritizace, podle signálů, náboru a kontaktních rolí, podle technologií a e-shopů, a podle vašich štítků. Filtry se kombinují a stačí je popsat větou v češtině. Na této stránce jsou seřazené do šesti skupin podle toho, na co se ptáte. U každé skupiny najdete příklady vět, upozornění na časté chyby a po rozkliknutí podrobnosti pro pokročilé uživatele i pro samotného asistenta.

Nemusíte znát žádné technické názvy. Stačí věta v češtině, asistent ji na filtry převede sám. Hodnoty na této stránce platí pro česká data. Pro jinou zemi si asistent aktuální číselník načte přímo z konektoru a přednost má vždy číselník.

Co můžete po asistentovi chtít

Filtry se libovolně kombinují a platí zároveň. Hledání postupuje od nejlevnějšího kroku: nejdřív počet firem, pak vzorek pěti, teprve potom seznam po dvaceti.

Najdi výrobní firmy v Plzeňském kraji s 50 až 249 zaměstnanci, které rostou.
Kolik e-shopů na Shoptetu má víc než 50 000 návštěv měsíčně z vyhledávání?
Vyber z mého štítku ‚TOP zákazníci 2026‘ firmy, kde se za poslední tři měsíce změnilo vedení.
Ukaž IT firmy z Prahy, u kterých známe někoho z finančního vedení a které teď nabírají obchodníky.

Velikost, obor a místo firmy

Základ každého segmentu. Podle klíčového slova konektor hledá v názvu, popisu, adrese a webu firmy. Velikost zadáte počtem zaměstnanců nebo obratem, obor kódem NACE nebo jeho slovním opisem, místo krajem.

Příklady vět

  • „firmy, které mají v popisu vstřikování plastů“

  • „50 až 249 zaměstnanců, obrat 100 až 500 milionů“

  • „IT firmy“, „internetový prodej“

  • „v Plzeňském kraji“, „se sídlem v Brně“

  • „soukromé firmy pod zahraniční kontrolou“

Na co si dát pozor

  • Rozsahy musí odpovídat pevným pásmům. „50 až 300 zaměstnanců“ konektor odmítne, protože 300 není hranice pásma. Asistent zvolí nejbližší pásmo, třeba 50 až 499, a řekne vám to.

  • Obrat je v měně země. V Česku v korunách, na Slovensku a v Německu v eurech. „Obrat 1 až 5 milionů eur“ v Česku znamená zhruba 25 až 125 milionů korun.

  • Firmy s neznámou hodnotou vypadnou. Když chcete i firmy, u kterých obrat nebo počet zaměstnanců neznáme, řekněte to. Obráceně to nejde: vybrat jen firmy s neznámou hodnotou konektor neumí.

  • Filtruje se jen hlavní obor. Vedlejší činnosti konektor filtrovat neumí. Najdete je v Prospectoru.

  • Město není samostatný filtr. Pro město asistent použije klíčové slovo v adrese.

Podrobnosti: parametry velikosti, oboru a místa
Co filtr znamená
Hodnoty (CZ)
Parametr

Hledání v názvu, popisu, adrese a webu. Víc slov = fráze.

text nebo seznam textů

keyword

Jak se kombinuje víc klíčových slov

all (výchozí), any

keyword_match

Kde se klíčové slovo hledá

name, description, address, website, national_id

keyword_search_within

Počet zaměstnanců, pásmo nebo rozsah přes hranice pásem

0, 1-5, 6-9, 10-19, 20-24, 25-49, 50-99, 100-199, 200-249, 250-499, 500-999, 1000-1499, 1500-1999, 2000-2499, 2500-2999, 3000-3999, 4000-4999, 5000-9999, 10000+

employee_band

Zahrnout i firmy s neznámým počtem zaměstnanců. Jen spolu s pásmem.

ano / ne

employee_include_unknown

Obrat, rozsah mezi pevnými body v měně datasetu

0, 200K, 500K, 1M, 3M, 5M, 10M, 30M, 60M, 100M, 200M, 300M, 500M, 1B, 1.5B, inf (CZK)

revenue_band

Zahrnout i firmy s neznámým obratem. Jen spolu s pásmem.

ano / ne

revenue_include_unknown

Jen plátci DPH

ano

vat_payer

Hlavní činnost podle NACE: oddíl (62), skupina (222) nebo třída (4791)

kód nebo seznam kódů

industry

Právní forma

číselník, kategorie i konkrétní forma

legal_form

Typ organizace: institucionální sektor podle ESA 2010, jen CZ a SK

číselník

type_of_organization

Kraj, název s diakritikou i bez, nebo kód NUTS

14 krajů

region

Pro asistenta: IČO se v běžném hledání neprohledává. Omezte hledání na national_id, nebo použijte lookup_company. Písmeno sekce NACE (C) konektor přijme, ale v českém datasetu vrací přes 300 000 firem (k září 2026), proto pro cílení použijte oddíl. Při příliš jemném kódu vrátí konektor nulu. Rozšiřte kód na oddíl a zkuste znovu. Okresy a nižší kódy NUTS konektor přijme, i když nejsou v číselníku vypsané.

Obchodní indikátory a AI Prioritizace

Tři univerzální indikátory, tedy Růst, Aktivita a Dostupnost, mají pět stupňů. AI Prioritizace udává míru shody firmy s vaší nabídkou (ICP). Nabídku musíte mít v Prospectoru založenou a vyhodnocenou.

Příklady vět

  • „rostoucí firmy“, „firmy, které se sbalují“

  • „firmy se silnou online přítomností“

  • „podle naší nabídky Konsolidace skladů jen firmy s vysokou shodou“

  • „seřaď mi je podle toho, jak nám sedí“

Na co si dát pozor

  • Jeden stupeň je práh. „Vysoký růst“ znamená vysoký nebo lepší, „nízká aktivita“ znamená nízká nebo horší. „Rychle rostoucí“ asistent chápe jako vysoký stupeň, ne jako nejvyšší.

  • Nabídku musíte mít založenou. Konektor hodnotu AI Prioritizace čte, nepočítá ji. Když nabídku nemáte, asistent to má říct a nepokračovat, ne skládat náhradní filtry.

  • Vlastní indikátory jsou placený doplněk. Fungují jen ve workspace, který je má.

Podrobnosti: parametry indikátorů a AI Prioritizace

Škála všech indikátorů: VERY_HIGH, HIGH, NEUTRAL, LOW, VERY_LOW. Jeden stupeň funguje jako práh oběma směry (HIGH = HIGH nebo lepší, LOW = LOW nebo horší). Pro přesný výběr stupňů pošlete seznam.

Co filtr znamená
Hodnoty
Parametr

Růst firmy

stupeň nebo seznam stupňů

growth_score

Aktivita: živá firma oproti utlumené

stupeň nebo seznam stupňů

activity_score

Dostupnost: online přítomnost, dohledatelnost kontaktů

stupeň nebo seznam stupňů

reachability_score

Vlastní indikátory workspace

kód z get_filter_values + stupeň

custom_indicators

Název nabídky (ICP) přesně podle workspace

název z get_workspace_info

ai_prioritization_offer

Míra shody firmy s nabídkou

stupeň nebo seznam stupňů

ai_prioritization_score

Seřadit podle shody, aniž by se firmy odfiltrovaly

sort_by: ai_prioritization_score

Pro asistenta: před skládáním filtrů zavolejte get_workspace_info. Založená nabídka má přednost před odhadem oboru a klíčových slov. Pro velikost trhu je rozumný práh NEUTRAL.

Signály: co se ve firmě událo

Signály filtrují firmy, u kterých se něco stalo: změna ve vedení, nábor, insolvence, nová dotace, přesídlení. Samotné události s datem a popisem vrací jiný nástroj. Tady jde o výběr firem.

Příklady vět

  • „firmy, kde se za poslední tři měsíce změnilo vedení“

  • „firmy, které od června začaly nabírat do IT“

  • „firmy, které letos vyhrály veřejnou zakázku“

  • „firmy, kde se v signálu zmiňuje expanze“

Na co si dát pozor

  • Nula může znamenat dvě věci. Buď takovou firmu nemáme, nebo se kategorie v dané zemi nesleduje. V Maďarsku signály nesledujeme vůbec.

  • Datum události a datum zachycení nejsou totéž. „Za poslední tři měsíce“ znamená datum události. Datum zachycení se hodí jen na sledování novinek od minulé kontroly.

  • Signál o náboru a filtr náboru jsou dvě různé věci. „Kdo začal nabírat od června“ je signál s datem. „Kdo teď nabírá“ je stav, viz skupina 4.

  • Hledání v textu signálu bere slova zvlášť. „Expanze do zahraničí“ najde i signál, kde je jen slovo „zahraničí“. Vyberte jedno výstižné slovo.

Podrobnosti: číselník signálů a jeho parametry

Číselník signálů pro Česko má 20 kategorií (k 14. září 2026). Názvy jsou náš překlad, konektor vrací anglické. Nadřazený kód zahrne všechny podřízené.

Téma
Kategorie
Podkategorie
Kód

Lidé

Nábor

vedení, finance, obchod a marketing, IT

jobs

Lidé

Změny ve vedení

klíčová role, statutární orgán

mgmt-change

Lidé

Výročí a narozeniny

výročí firmy, narozeniny majitele, narozeniny člena statutárního orgánu

company-anniversary, owner-anniversary, stat-anniversary

Rejstřík

Rejstřík a vlastnictví

změna vlastníka, nová firma, přejmenování, likvidace, nová VC investice, zástava podílu, nová / pozastavená živnost

registry-change

Rejstřík

Propojené firmy

nová propojená firma, nová dceřiná firma

connected-company-change

Rejstřík

Přesídlení

address-change

Rejstřík

DPH

nová registrace, zrušení, nespolehlivý plátce

vat-registration

Finance

Finanční zdraví

růst tržeb 1 rok (5 %+) / 2 roky (10 %+ ročně), pokles tržeb (5 %+), růst závazků 1 rok (50 %+) / 2 roky (20 %+ ročně), růst osobních nákladů 2 roky (20 %+ ročně)

fin

Finance

Zveřejnění výkazů

zveřejnění účetní závěrky

document-publication

Finance

Insolvence

zahájení / ukončení insolvence, zahájení / ukončení konkurzu

insolvency

Finance

Bankovní účty

nová banka, změna banky

bank

Finance

Změna ukazatele

změna pásma počtu zaměstnanců, změna základního kapitálu

metric-change

Veřejné peníze

Veřejné zakázky a dotace

vypsaná / zadaná / vyhraná veřejná zakázka, zveřejněná smlouva, dotace, oznámení na úřední desce

public-money

Provoz

Provozovny

nová provozovna

premise

Provoz

Vozový park

první elektromobil, nová značka, výročí leasingu (4 a 5 let podle kategorie vozidel), nový provozovatel vozidel kategorie T a SS

veh

Provoz

Nová technologie

technology-new

Provoz

Nový dokument EIA

eia-document-new

Média

Mediální zmínka

media

Co filtr znamená
Hodnoty
Parametr

Kategorie události, nadřazený kód zahrne podřízené

kód nebo anglický název

signal_categories

Hledání v předmětu a shrnutí signálu. Víc slov = stačí jedno.

text

signal_search

Kdy se událost stala. Výchozí volba pro „za poslední tři měsíce“.

od / do, ISO datum s časovou zónou

signal_started_at

Kdy signál zachytil BizMachine. Jen pro sledování novinek.

od / do

signal_indexed_at

Pro asistenta: kódy se nedají uhodnout, proto před filtrem zavolejte get_filter_values(filter: "signal_categories"). Neznámou kategorii server odmítne s chybou, ne prázdným výsledkem. Datum bez časové zóny server odmítne. U vozového parku a veřejných zakázek konektor najde firmy, u kterých se událost stala, ale detail vozového parku ani objemy zakázek neposkytuje.

Nábor a kontaktní osoby

Filtr náboru pracuje se stavem: firma má právě teď otevřenou pozici. Filtr kontaktních osob vybírá firmy podle toho, jaké role jsou u nich veřejně dohledatelné. Podrobně v článku Kdo ve firmě pracuje: role, nábor a hledání firem podle rolí.

Příklady vět

  • „firmy s víc než pěti otevřenými pozicemi“

  • „firmy, které nabírají do IT“, „kdo shání obchodního zástupce“

  • „firmy, kde známe někoho z finančního vedení“

  • „firmy, kde máme aspoň deset kontaktů“

Na co si dát pozor

  • Data o inzerátech máme jen pro Česko a Slovensko. Role kontaktů fungují ve všech pěti zemích.

  • Kategorie popisuje pozici, ne obor firmy. Pod „nábor do IT“ se vejde i výrobní podnik, který hledá vývojáře.

  • Jména, e-maily a telefony kontaktních osob konektor nevrací. Ani ve filtru, ani v detailu firmy. Najdete je v Prospectoru. Jména vlastníků a statutárů u propojených firem konektor vrací.

  • Počet kontaktů se počítá jen pro zvolenou roli. U „aspoň deseti lidí z obchodu“ se počítají jen kontakty z obchodu, ne všechny kontakty firmy.

Podrobnosti: parametry náboru a kontaktních osob
Co filtr znamená
Hodnoty
Parametr

Počet aktuálně otevřených pozic

celé číslo

open_jobs_min / open_jobs_max

Obor inzerované pozice, nadřazený kód zahrne podřízené

kód (bm1 = IT) nebo název (Sales)

job_categories

Hledání v názvu pozice, ne v textu inzerátu

text, slova oddělená mezerou

job_keyword

Jak se slova kombinují

any (výchozí), all

job_keyword_match

Jen inzeráty vystavené nebo obnovené za posledních N dní

celé číslo

job_posted_within_days

Role nebo útvar kontaktní osoby, skupina zahrne role pod sebou

kód nebo název (Sales, Finance Leadership)

contact_roles

Kolik kontaktních osob je u firmy veřejně dohledatelných

celé číslo

contact_count_min / contact_count_max

Pro asistenta: hodnoty číselníků mohou být jazykově závislé. U některých filtrů se řídí jazykem uživatele, u jiných jazykem datasetu, a vedle názvu vždy projde kód (bm1). Hodnotu si ověřte v get_filter_values a po odmítnutí ji opravte podle vrácených možností. S nastaveným job_categories se do open_jobs_min/max počítají jen odpovídající inzeráty. S nastaveným contact_roles se do contact_count_min/max počítají jen lidé ve vybraných rolích. Procházení rolí bez dotazu ukáže jen nejvyšší úroveň stromu, proto konkrétní roli hledejte dotazem. Data o vystavení inzerátů chodí v dávkách, takže u období kratšího než pár dní bude počet podhodnocený.

Technologie a e-shopy

Technologie pokrývají IT a software, výrobu i marketing. E-shopové filtry vybírají firmy podle platformy, plateb, dopravy a výkonnostních metrik jejich e-shopu.

Příklady vět

  • „firmy s jakýmkoli ERP“, „firmy na SAP“

  • „e-shopy na Shoptetu, které berou Twisto“

  • „top 1000 e-shopů podle návštěvnosti“

  • „e-shopy s víc než 50 000 návštěvami měsíčně z vyhledávání“

Na co si dát pozor

  • Název dodavatele v číselníku často označuje jen jeden jeho produkt. Asistent má v číselníku dohledat všechny produkty dodavatele a poslat je najednou.

  • Všechny e-shopové filtry musí platit pro jeden a týž e-shop. Firma se třemi e-shopy projde, jen když jeden z nich splní vše zároveň.

  • Pokrytí metrik je nerovnoměrné. E-shop bez dané metriky z výsledku vypadne, pokud neřeknete „zahrnout i neznámé“. Několik metrik naráz výsledek tiše zúží, proto hlídejte počet.

  • Hodnocení (hvězdičky) není filtr. Filtruje se počet recenzí, tedy objem. Hodnocení je vidět v detailu firmy.

Podrobnosti: parametry technologií a e-shopů
Co filtr znamená
Hodnoty
Parametr

Technologie, které firma používá. Kód kategorie zahrne i podřízené kódy.

číselník, hledání přes get_filter_values

technologies

Kolik e-shopů firma provozuje

min / max (alespoň jedna hodnota)

eshop_count

Platforma e-shopu. Víc hodnot = stačí jedna.

číselník

eshop_technology

Platební metody. Víc hodnot = stačí jedna.

číselník, závislý na zemi

eshop_payment

Způsoby dopravy. Víc hodnot = stačí jedna.

číselník, závislý na zemi

eshop_delivery

Pořadí podle návštěvnosti mezi e-shopy v zemi (1 = nejnavštěvovanější)

min / max / zahrnout neznámé

eshop_country_traffic_rank

Odhad měsíční návštěvnosti z organického vyhledávání Google

min / max / zahrnout neznámé

eshop_organic_search_traffic

Počet placených klíčových slov v Google Ads (textové reklamy)

min / max / zahrnout neznámé

eshop_paid_keywords

Počet produktových URL, přibližná velikost sortimentu

min / max / zahrnout neznámé

eshop_product_urls

Celkový počet recenzí napříč zdroji, objem, ne hodnocení

min / max / zahrnout neznámé

eshop_total_reviews

Pro asistenta: pro „jakékoli ERP“ najděte kód kategorie a pošlete jen ten. Produkty nevyjmenovávejte. Kód, který vypadá jako kategorie, může být úzká podkategorie. Správnost potvrdí počet. Uvnitř jednoho číselníkového filtru platí „nebo“, mezi filtry „a zároveň“.

Štítky z Prospectoru

Filtrujte firmy z vašich štítků, sdílených i osobních, nebo je naopak vylučte. Magické štítky jsou předpřipravené výběry firem. Sestavuje a udržuje je BizMachine.

Příklady vět

  • „z mého štítku ‚TOP zákazníci 2026‘“

  • „kromě štítku Zákazníci“

  • „firmy, které jsou zároveň ve štítku A i B“

Na co si dát pozor

  • Nové firmy dostanete vyloučením štítku. Když chcete jen firmy, které ještě neznáte, vylučte štítek, ve kterém máte své zákazníky.

  • Štítky se posílají podle ID, ne podle názvu. Asistent si je nejdřív načte, vy to neřešíte.

Podrobnosti: parametry štítků
Co filtr znamená
Hodnoty
Parametr

Firmy s vašimi štítky, nebo bez nich

ID z list_labels

labels / labels_exclude

Stačí kterýkoli z uvedených štítků (any, výchozí), nebo musí platit všechny (all)

labels_match

Magické štítky BizMachine, nebo bez nich

ID z list_labels

magic_labels / magic_labels_exclude

Stejně jako u vlastních štítků

magic_labels_match

Pro asistenta: názvy štítků server nepřijme, proto načtěte ID přes list_labels. Pokud není význam štítku jasný, ověřte si ho u uživatele jednou za konverzaci.

Řazení a režimy hledání

Pokud řazení výslovně nezadáte, výsledky seřazené nejsou. „Top 10 největších“ bez řazení vrátí deset náhodných firem, proto má asistent řazení nastavit sám. Řadit můžete podle obratu, počtu zaměstnanců, roku založení, růstu, aktivity a míry shody s nabídkou.

Podrobnosti: režimy, stránkování a kredity
Co znamená
Hodnoty
Parametr

Režim odpovědi

count (výchozí, jen počet), sample (počet + 5 firem), list (stránkovaný seznam)

mode

Velikost stránky (max 20, k září 2026) a posun, jen v režimu list

limit / offset

Řazení seznamu

revenue, employees, established_at, growth_score, activity_score, ai_prioritization_score

sort_by

Směr řazení

desc (výchozí), asc

sort_dir

Země (povinný údaj)

cz, sk, pl, hu, de

datasetScopeCode

Kredity za volání (k září 2026): počet 1, vzorek 3, seznam 5.

Co platí v které zemi

Konektor pokrývá pět zemí, ale ne ve všech zemích stejně. Ověřeno přímo v konektoru 14. září 2026.

  • Měna obratu: CZK, hranice pásem od 200 tisíc do 1,5 miliardy

  • Regiony: 14 krajů

  • Typ organizace: ano

  • Nábor a otevřené pozice: ano

  • Role a počty kontaktů: ano

  • Signály: 20 kategorií, nejúplnější číselník. Insolvence, média, provozovny, DPH, vozový park a zveřejnění výkazů jsou jen tady.

  • Měna obratu: EUR, hranice pásem od 1 milionu do 500 milionů

  • Regiony: 8 krajů

  • Typ organizace: ano

  • Nábor a otevřené pozice: ano

  • Role a počty kontaktů: ano

  • Signály: 11 kategorií. Patří mezi ně i veřejné zakázky a změny bankovních účtů, navíc odchod z klíčové role, který v Česku není.

  • Měna obratu: EUR, hranice pásem od 10 tisíc do 250 milionů

  • Regiony: 16 spolkových zemí

  • Typ organizace: ne

  • Nábor a otevřené pozice: ne

  • Role a počty kontaktů: ano

  • Signály: 8 kategorií. Jde o změny ve vedení a vlastnictví, propojené firmy, změnu pásma počtu zaměstnanců, novou technologii a výročí.

  • Měna obratu: PLN, vlastní hranice pásem

  • Regiony: 17 regionů (16 vojvodství, Mazovské je rozdělené na Varšavu a zbytek vojvodství)

  • Typ organizace: ne

  • Nábor a otevřené pozice: ne

  • Role a počty kontaktů: ano

  • Signály: 8 kategorií, stejný rozsah jako Německo.

  • Měna obratu: HUF, vlastní hranice pásem

  • Regiony: 8 statistických regionů

  • Typ organizace: ne

  • Nábor a otevřené pozice: ne

  • Role a počty kontaktů: ano

  • Signály: žádné

E-shopy a technologie fungují ve všech pěti zemích. Pásma zaměstnanců jsou všude stejná, liší se jen hranice obratu.

Zahraniční mateřská společnost se neobjeví mezi propojenými firmami jako vazba, ale najdete ji mezi vlastníky. Slovenská dcera německé skupiny tak ve výpisu vazeb vypadá jako firma bez mateřské společnosti.

Co přes MCP konektor filtrovat nejde

Toto zatím zůstává v Prospectoru nebo v Prospector API. Když to potřebujete, má to asistent říct, ne hledat okliku.

  • Kontakty na konkrétní lidi. Filtrovat podle role můžete, hledat konkrétního člověka ne.

  • Složení vozového parku (značky, typy vozidel). Signály o změnách a celkové počty na profilu ano, filtr podle složení ne.

  • Uložené segmenty z Prospectoru jako filtr.

  • Rizikové příznaky (risk flags z Prospectoru). Jednotlivé signály jako insolvence nebo nespolehlivý plátce DPH filtrovat můžete.

  • Vedlejší obor (NACE).

  • Text a plat pracovního inzerátu. Název pozice, obor, místo výkonu práce a odkaz konektor vrací.

  • Objemy veřejných zakázek, výše dotací a seznam provozoven.

  • Jen firmy s neznámou hodnotou obratu nebo počtu zaměstnanců.

Širší přehled toho, co je dnes jen v Prospectoru, najdete v článku BizMachine MCP konektor: co umí a k čemu slouží.

Časté dotazy

Proč asistent změnil zadaný počet zaměstnanců? Rozsahy musí odpovídat pevným pásmům. „50 až 300“ konektor odmítne, asistent zvolí nejbližší pásmo a řekne vám to.

Proč vyšla u signálu nula, když vím, že se takové změny ve firmách dějí? Buď takovou firmu nemáme, nebo se kategorie v dané zemi nesleduje, nebo asistent poslal špatný kód. Asistent si má kategorii ověřit v číselníku.

Proč „top 10 největších“ vrátilo náhodné firmy? Pokud řazení výslovně nezadáte, výsledky seřazené nejsou. Požádejte o seřazení podle obratu nebo počtu zaměstnanců.

Musím znát kódy NACE? Ne. Řekněte obor slovy a asistent kód dohledá. Pokud vyjde nula, rozšíří hledání na celý oddíl.

Související články

Poslední aktualizace