Pre vývojárov a operátorov

@orsf/cli — slovenské firmy v termináli

Name: @orsf/cli
Author: ORSF

@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.

Balík@orsf/cli

LicenciaMIT

CenaZdarma

OutputJSON / table

Quickstart

Bez inštalácie, cez npx:

bash

npx @orsf/cli search "poistovna"
npx @orsf/cli company 55609830
npx @orsf/cli graph 55609830 --depth 2

Alebo nainštaluj globálne:

bash

npm install -g @orsf/cli
orsf search "poistovna"

Príkazy

Príkaz	Popis	Auth
`orsf search <query>`	Fulltext + filtre	—
`orsf company <ico>`	Detail firmy podľa IČO	—
`orsf graph <ico> [--depth 1-3]`	Graf prepojení	✅
`orsf person <uuid>`	Detail osoby	✅
`orsf refresh <ico>`	Force-refresh zo zdroja	✅

Pridaj --format=table pre stĺpcový output namiesto JSON.

Použitie v skriptoch

bashPríklad: dump 100 najnovších firiem do JSONL

#!/usr/bin/env bash
for ico in $(npx @orsf/cli search "" --limit 100 | jq -r '.hits[].ico'); do
  npx @orsf/cli company "$ico"
done > companies.jsonl

bashPríklad: filtrovať len aktívnych platcov DPH v Bratislave

npx @orsf/cli search "" \
  --region SK010 \
  --is-vat-payer true \
  --status active \
  --limit 50

Autentifikácia

Pre auth-gated príkazy (graph, person, refresh) potrebuješ session cookie. Najprv sa prihlás na orsf.sk, potom exportuj cookie do environment variable:

bash

export ORSF_SESSION_COOKIE="__Secure-orsf.session_token=..."
orsf graph 55609830

Quickstart

Príkazy

Použitie v skriptoch

Autentifikácia

Ďalšie kroky