Skip to main content
The CLI is the starcovery npm package. npx starcovery and bunx starcovery both run it with no install. Bare commands stay read-only; mutations use explicit subcommands. Node.js 24 or newer.

​
Search without an account

Unsigned search is free up to 50 calls per UTC day per IP.

​
Agent signup

This follows the auth.md protocol, exchanges the assertion for an access token, and writes ~/.config/starcovery/config.json. You can also pass credentials per call:
Humans can mint durable keys at Settings and run:

​
Campaigns, credits, and keys

Campaigns and credits need an access token or a Settings API key. keys is human-key only: agent tokens get 403 by design.

​
When a search asks for payment

Identified search past free credits returns 402. Settle the Machine Payments challenge with your payment tooling and retry:
Full paid-rail notes: Credits and payments.

​
FAQ

​
Is the CLI a cut-down product?

No. Search, campaigns, credits, and keys match the web and MCP for those surfaces. Account checkout and the claim ceremony stay on the web.