Goro CLI

Command line client for Goro, a pay-per-call gateway that gives agents and scripts one connection to search, social, maps, commerce and people data.

One key, one prepaid balance, no subscription.

Install

npm install -g @goroo/cli

Set up

goro setup

Paste an API key from app.usegoro.ai. The key is verified before it is stored, and it lands in ~/.goro/config.json with mode 0600. GORO_API_KEY in the environment overrides whatever is stored.

Use it

You do not need to know the catalog. Describe the job:

goro discover -q "recent posts from a tiktok creator"

Check what a tool expects, then run it:

goro inspect -s web.search
goro run -s web.search -i '{"queries":"best espresso machines","maxPagesPerQuery":1}'

Slow tools return a run id instead of blocking. Poll it, or wait inline:

goro run -s instagram.posts -i '{"username":["natgeo"],"resultsLimit":10}' --wait
goro runs get -r <run-id>

Check the balance any time:

goro balance

Commands

| Command | What it does | | --- | --- | | goro setup | Verify and store an API key | | goro keys add\|list\|use | Manage several keys, switch between them | | goro discover -q "<query>" | Rank the catalog against a plain-English query | | goro inspect -s <slug> | Show a tool's input schema and price | | goro run -s <slug> -i '<json>' | Run a tool. -f <file> to read input from a file, --wait to block | | goro runs get -r <id> | Fetch a run's status and results | | goro runs list | Recent runs | | goro balance | Available balance, cash and promotional credit |

Global flags: -j for JSON output, -o <file> to write to a file, --api <url> to point at a different gateway.

Exit codes

Scripts can branch on these.

| Code | Meaning | | --- | --- | | 0 | Success | | 1 | Usage or validation error | | 2 | Authentication failed | | 3 | Insufficient funds or a budget cap | | 4 | Upstream or network failure |

What a price means

Billing follows what a call actually consumes. A tool quotes a rate per result, so the total depends on how many results the call produces, and discover and inspect also return a ceiling for your specific request that you will never be charged above. After a run, the CLI prints what it actually cost.

Results are not stored. Goro records what a call cost and how many rows it returned, never the rows themselves, so keep anything you need.

Documentation

docs.usegoro.ai