Skip to content

Run creator search from your terminal with no install, then register an agent token when you need campaigns and credits.

The CLI is the starcovery npm package. bunx starcovery and npx starcovery both run it. Bare commands stay read-only; mutations use explicit subcommands.

Search without an account

starcovery search "slow morning coffee"

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

Agent signup

starcovery auth register

This follows https://www.starcovery.com/agents (auth.md), exchanges the assertion for an access token, and writes ~/.config/starcovery/config.json. You can also pass credentials per call:

export STARCOVERY_ACCESS_TOKEN=...
starcovery search "running shoes" --access-token ...

Humans mint durable keys at https://www.starcovery.com/app/settings/api-keys and can run:

starcovery auth set sk_...

Campaigns, credits, and keys

starcovery campaign
starcovery campaign create "Coffee" --goal "quiet morning coffee creators"
starcovery campaign generate <id>
starcovery campaign show <id>
starcovery campaign export <id> > out.csv
starcovery credits
starcovery keys

Campaigns and credits need an access token or 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 HTTP 402. If the deployment advertises Machine Payments, settle the challenge with your payment tooling and retry:

starcovery search "running shoes" --payment '<credential>'

If that header is absent, credits come from a human credit pack. Pre-claim agent tokens cannot use web checkout: a human must finish the claim ceremony from the claim URL printed at register, then buy a pack at https://www.starcovery.com/app/settings/billing. Live posture is always on https://www.starcovery.com/agents and https://www.starcovery.com/openapi.json.

FAQ

Node version?

Node.js 24 or newer.

Is the CLI a cut-down product?

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

Where do I read the full skill?

https://www.starcovery.com/agents

Next

Ready to find creators?

Just start free, get searching, hire creators.

Start Free