Documentation · Updated July 2026
Get Started With Metricsjar
Metricsjar gives you a live dashboard without asking you to hand your source credentials to another analytics service. Your coding agent installs one readable command-line tool, connects the sources on your machine, and publishes the computed dashboard rows to your account.
What you need
- A coding agent that can work in your terminal, such as Claude Code or Codex.
- A Google account with access to the site in Search Console.
- A Metricsjar account.
- Optional source accounts for DataForSEO, Google Analytics 4, App Store Connect, or RevenueCat.
You can begin with Search Console and add the other sources later.
Connect the first site
- Sign in to Metricsjar.
- Open Connect a project.
- Select Copy setup prompt.
- Paste the prompt into your coding agent while it is working in the project repository.
- Keep the setup page open. It updates as the agent discovers, connects, and verifies each source.
The prompt contains a one-time token that expires after 15 minutes. The agent checks the repository and your existing local credentials first, then reuses working GA4, Search Console, BigQuery, and product analytics connections. For a new project, it shows what needs instrumentation and asks only when it reaches an account, billing, or paid-data decision.
The agent runs a doctor before it publishes anything. That check confirms the
local configuration, account access, source freshness, and whether a scheduled
refresh can see the same credentials as the current shell. Setup is resumable:
if the agent stops, ask it to run onboard continue.
Add the first data source
Start with Search Console. Its BigQuery bulk export does not backfill, so every day before you enable it is history you cannot recover.
You can then add:
| Source | What it adds |
|---|---|
| Search Console | Queries, clicks, impressions, pages, and average position |
| DataForSEO | Verified keyword ranks and backlinks |
| Google Analytics 4 | Site traffic, app activity, and retention |
| App Store Connect | Downloads, ratings, reviews, and store proceeds |
| RevenueCat | Revenue, trials, subscriptions, and active customers |
Each integration uses credentials stored on your machine. Metricsjar receives the finished dashboard rows, not the source keys.
Open the dashboard
After the first refresh, the site appears on your account home. Open it to see the Acquisition tab for search and traffic, and the Product tab for app usage, downloads, revenue, and retention.
Read the dashboard guide before treating an empty cell as zero. Some sources publish late, apply privacy thresholds, or have no historical backfill.
Ask your agent to check the setup
If a section stays empty, tell your agent:
Run the Metricsjar doctor for this site. Explain each missing or stale source,
then fix the setup problems you can fix without changing source data.
The doctor distinguishes “not configured,” “configured but unreachable,” and “connected but waiting for upstream data.” Those states need different fixes.