Beta v0.2. We process publicly available data from official Slovak state registers only. PrivacyObject / eraseContact
ORSFopen register of Slovak companies
For developers and operators

@orsf/cli — Slovak companies in your terminal

@orsf/cli is a shell tool to search and fetch data on 1.25M+ Slovak companies straight from your terminal. JSON or table output, no signup, ideal for scripts, CI pipelines, and ad-hoc exploration.

Package@orsf/cli
LicenseMIT
PricingFree
OutputJSON / table

Quickstart

No install needed, via npx:

bash
npx @orsf/cli search "poistovna"
npx @orsf/cli company 55609830
npx @orsf/cli refresh 55609830

Or install globally:

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

Commands

CommandDescriptionAuth
orsf search <query> [--limit N]Fulltext search—
orsf company <ico>Company detail by IČO—
orsf refresh <ico> [--sources csv]Force-refresh from source—
orsf graph <ico> [--depth 1|2]Connection graph✅
orsf person <id>Person detail✅

Add --json for raw JSON. search and company otherwise render a human-readable view.

Use in scripts

bashExample: dump 100 companies to 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.jsonl
bashExample: filter results with jq
# The CLI has no filter flags — filter with jq.
# Server-side filtering lives in the REST API: /v1/search?region=SK010
orsf search "poistovna" --limit 50 --json \
  | jq '.hits[] | select(.region == "SK010" and .status == "aktívna")'

Authentication

The graph and person commands require an API token. Generate one in your profile and export it as an environment variable:

bash
export ORSF_API_KEY=orsf_pk_…
orsf graph 55609830 --depth 2

A token also raises the quota on anonymous endpoints and unlocks full sole-trader addresses (GDPR-gated otherwise). Without one, search, company and refresh work fine — just rate-limited.

Next steps