SuprAnalytics

CLI

Your analytics, from your terminal.

Run one command to see every website's traffic, revenue, uptime and site score in a table, find what needs attention, and get what to fix. It only reads, and you can run it without installing it.

Start free trial How it works

14-day free trial · No card required · From $9/month

The answers you'd open the dashboard for.

Start with npx @supranalytics/cli login, then ask for what you need. Commands about one website take its domain, or a default you set with use.

overview
Every website in one table: visitors and change, revenue, uptime, who's online, site score, conversion, bounce rate, pageviews and session time.
health
Only what needs attention: websites down, checks that have stopped, low site scores, and SSL certificates or domains about to expire.
report
One website's period: what changed, its top channels and pages, its goals and its health.
insights
The latest site audit's scores and what to fix, worst first, with --prompts for a prompt to paste into an AI coding tool.
uptime
Status, uptime from 24 hours to a year, response times and the latest incidents.
sources and peak
Channels and referrers with gains and drops, and the busiest hours of the week as a text heatmap.

Made for scripts as well as people.

Add --json to a report for the data, and set SUPRANALYTICS_API_KEY to an account API key for CI. A check on your deploys can be one line: supranalytics health --json.

  • Exit codes scripts can rely on: 0 worked, 1 didn't, 2 asked wrongly
  • Tables fit your terminal's width, and colour goes when you set NO_COLOR
  • --period picks the dates, and --filter country=US narrows report, sources and peak

Your sign-in stays yours.

login opens your browser, where you allow it. Your sign-in is kept in a file only you can read, and logout ends it on the server too. The CLI sends no analytics of its own.

Set it up.

  1. Sign in

    Run npx @supranalytics/cli login and allow it in your browser.

  2. See everything

    Run npx @supranalytics/cli overview for every website in one table.

  3. Keep it handy

    npm i -g @supranalytics/cli lets you type supranalytics overview from then on.

How it works, in detail.

The docs page “SuprAnalytics CLI” goes through it step by step.

How it works

Limits worth knowing

  • Read-only: it can't change settings, send data or start a new site audit
  • No commands for visitors, chats or recordings; the read API and MCP server have them, with your permission
  • Needs Node 18.3 or later
  • Scripts need an account API key (pa_…); website keys (pk_…) only send data

Questions, answered.

Do I need to install anything?

Only Node 18.3 or later. npx @supranalytics/cli runs it without installing, and npm i -g @supranalytics/cli keeps it around.

Can it change anything in my account?

No. Every command only reads. The one thing it writes is its own settings file on your computer.

Can it read my visitors' emails and chats?

No. It has no commands for them, so leave "Also share visitors' personal data" unticked when you allow it.

How do I use it in CI?

Create an account API key under API / MCP, set it as SUPRANALYTICS_API_KEY, and add --json. The docs have an example.

Which plans include it?

All of them. It reads the same reports as your dashboard, and stops when the dashboard does if a plan ends.

More features

All features

See it on your own website.

Every feature is on every plan, with a free trial and no card.

Start free trial

14-day free trial · No card requiredPricingHow it worksAll features