The StarReview CLI, built for agents
StarReview CLI drafts and submits replies but never posts itself. StarReview applies your approval and automatic-publishing settings: an eligible, unedited StarReview draft may be scheduled automatically; agent-written, edited, and safety-held replies remain pending.
Start a 7-day trial for CHF 0.-Connect Google Business Profile
$ starreview reviews --limit 1
[ { "reviewId": "8b1c...", "starRating": 4, "provider": "google",
"text": "Tolles Essen, etwas lange gewartet." } ]
$ starreview draft 8b1c...
$ starreview submit 8b1c... --variant 1
{ "submitted": true, "autoScheduled": true }
-> The agent never posts. An eligible, unedited StarReview draft may be scheduled under the owner’s approval and automatic-publishing settings.How it works
Install the CLI
Install globally from npm. Open source, MIT licensed, at github.com/Fabsbags/starreview-agent.
npm install -g @starreview/cliSet your API key
Create the key in your StarReview settings, in the Agent access section. It covers all your businesses and can be revoked there any time.
export STARREVIEW_API_KEY=sragt_...Use the commands
Every command prints JSON on stdout. The main commands are in the table below.
The commands
| Command | Description |
|---|---|
starreview reviews | List unanswered reviews |
starreview review <id> | Load one review with its drafts |
starreview draft <id> | Draft reply variants |
starreview submit <id> --variant N | --text "..." | Submit a variant or your own text for policy evaluation |
starreview stats --days 30 | Read review KPIs, optionally windowed |
starreview locations | List connected locations |
starreview info | Show service and pricing info |
starreview check "name" | Free response-rate check for any business |
JSON on stdout, built for agents. Open source (MIT) at github.com/Fabsbags/starreview-agent, published as @starreview/cli on npm.
What your agent can do
| Tool | Description |
|---|---|
list_locations | List every location connected to your business |
list_unanswered_reviews | List unanswered reviews across all connected platforms |
get_review_stats | Read review KPIs: average rating, response rate, backlog |
get_review_context | Load one review with every existing draft |
draft_reply | Draft reply variants in the business voice |
submit_reply_for_approval | Submit a drafted variant for StarReview publishing-policy evaluation |
submit_own_reply | Submit the agent's own reply text for approval, never auto-scheduled |
get_service_info | What StarReview does, pricing and sign-in, works without an account |
search_business | Find a business on Google Maps, works without an account |
check_response_rate | Check a business response rate against two nearby competitors |
The agent drafts; StarReview applies your settings
Your agent can draft and submit replies, but it can never post itself. StarReview applies your existing approval and automatic-publishing settings. An eligible, unedited StarReview draft may be scheduled without another click. Agent-written, edited, and safety-held replies remain pending. You can revoke access at any time.
Drafting is free, CHF 0.50 per published reply. No subscription needed to try it.
See the current Agent and MCP privacy notice for how agent data is handled.
Frequently asked questions
Is this safe? Can the agent publish anything itself?
No. The agent can draft and submit, but it can never post itself. StarReview applies your approval and automatic-publishing settings. Only an eligible, unedited StarReview draft may be scheduled automatically; agent-written, edited, and safety-held replies remain pending.
What does it cost?
Drafting is free. You pay CHF 0.50 per published reply. No subscription is needed to try it.
How do I revoke access?
Any time in your StarReview settings: revoke the API key or disconnect the connection there. The agent loses access immediately.
Is the CLI open source?
Yes, MIT licensed. The code lives at github.com/Fabsbags/starreview-agent and the package is @starreview/cli on npm.
Which agents can use the CLI?
Any agent that can run shell commands. Output is JSON on stdout with no interactive prompts, so agents and scripts can parse it directly.
Connect your channels, drafts appear on click
StarReview finds unanswered Google reviews, and the reply draft appears on click, in your style.
Start a 7-day trial for CHF 0.-Also works with
Full MCP server details live on the Agents page.