@orsf/cli — slovenské firmy v termináli
@orsf/cli je shell nástroj na vyhľadávanie a získavanie dát o 1.25M+ slovenských firmách priamo z terminálu. JSON alebo tabuľkový output, bez registrácie, ideálne pre skripty, CI pipelines a ad-hoc prieskum.
Quickstart
Bez inštalácie, cez npx:
bash
npx @orsf/cli search "poistovna"
npx @orsf/cli company 55609830
npx @orsf/cli refresh 55609830Alebo nainštaluj globálne:
bash
npm install -g @orsf/cli
orsf search "poistovna"Príkazy
| Príkaz | Popis | Auth |
|---|---|---|
orsf search <query> [--limit N] | Fulltext vyhľadávanie | — |
orsf company <ico> | Detail firmy podľa IČO | — |
orsf refresh <ico> [--sources csv] | Force-refresh zo zdroja | — |
orsf graph <ico> [--depth 1|2] | Graf prepojení | ✅ |
orsf person <id> | Detail osoby | ✅ |
Použitie v skriptoch
bashPríklad: dump 100 firiem do JSONL
#!/usr/bin/env bash
npm install -g @orsf/cli
for ico in $(orsf search "poistovna" --limit 100 --json | jq -r '.hits[].ico'); do
orsf company "$ico" --json
done > companies.jsonlbashPríklad: filtrovať výsledky cez jq
# CLI nemá vlastné filtre — filtruje sa cez jq.
# Filtrovanie na strane servera vie REST API: /v1/search?region=SK010
orsf search "poistovna" --limit 50 --json \
| jq '.hits[] | select(.region == "SK010" and .status == "aktívna")'Autentifikácia
Príkazy graph a person vyžadujú API token. Vygeneruj si ho v profile a exportuj do environment variable:
bash
export ORSF_API_KEY=orsf_pk_…
orsf graph 55609830 --depth 2