Metrifyr
Getting Started

First Query

Make your first query with Claude using Metrifyr

Your First Query

Let's make your first query with Claude using Metrifyr. This guide assumes you've already installed the MCP server and connected your Google account.

1. Verify Connection

First, verify that Claude can see the Metrifyr MCP server:

Ask Claude:

List my Google Analytics properties

Expected response: Claude should return a list of your GA4 properties with IDs and display names. If you see this, you're connected! 🎉

If you get an error, see Troubleshooting.

2. Simple Queries

Start with basic queries to get familiar with the tools:

Analytics

Traffic overview:

How many users visited my website last week?

Real-time data:

Show me active users right now on my site

Compare periods:

Compare traffic this month vs last month

Search Console

Keyword rankings:

What are my top 10 keywords by impressions?

Performance trends:

Has my search traffic increased or decreased this week?

AdSense

Revenue:

How much did I earn from AdSense yesterday?

Top pages:

Which pages generated the most AdSense revenue this month?

3. Complex Queries

Once you're comfortable, try more advanced queries:

Multi-source Analysis

Traffic + Revenue:

Show me traffic and AdSense revenue for the last 7 days.
Which days had the highest revenue per visitor?

SEO Performance:

Compare my PageSpeed scores with my top competitor.
Which Core Web Vitals need improvement?

Conversions & Events

Event analysis:

List all conversion events in my GA4 property.
Which ones have the highest completion rate?

Create conversion:

Create a conversion event called "newsletter_signup"
based on the custom event "subscribe_clicked"

Keyword research:

Compare Google Trends interest for "react" vs "vue" vs "angular"
over the last 12 months

Content opportunities:

Find SEO content opportunities for my site based on
Search Console keywords and Trends data

Tag Manager (Beta)

Audit container:

Audit my GTM container for deprecated UA tags
and missing Consent Mode v2 configuration

List tags:

Show me all GA4 tags in my GTM container

4. Using Memory

Enable Memory to avoid repeating yourself:

First time:

My main GA4 property is "123456789".
Remember this as my default property.

Future queries:

Show me traffic for the last week

Claude will automatically use property 123456789 without you specifying it every time.

5. Best Practices

Be Specific

Vague:

Show me analytics

Specific:

Show me pageviews, users, and bounce rate for
the last 7 days from my main GA4 property

Use Property Names or IDs

If you have multiple properties, specify which one:

Show me traffic for "My Blog" (property 123456789)

Or let Claude ask you which property to use.

Specify Date Ranges

Be explicit about time periods:

Show me traffic for:
- Last 7 days
- This month vs last month
- January 1 to January 31, 2024

Claude can fetch multiple data points in one query:

For my main GA4 property, show me:
1. Total users and sessions this week
2. Top 5 pages by pageviews
3. Conversion rate for "purchase" event
4. Real-time active users

6. Common Patterns

Weekly Reports

Create a weekly performance report with:
- Total traffic (users, sessions, pageviews)
- Top 10 pages
- Top 10 traffic sources
- AdSense revenue
- Search Console impressions and clicks

Performance Monitoring

Check my website performance:
- PageSpeed Insights scores (mobile & desktop)
- Core Web Vitals (LCP, CLS, INP)
- Compare with last week's scores

SEO Audits

Run a comprehensive SEO audit:
1. PageSpeed scores and opportunities
2. Search Console performance (clicks, impressions, CTR)
3. Top performing keywords
4. Trending topics in my niche
5. Content gap analysis

Tag Management

Review my GTM setup:
- List all containers
- Audit for deprecated tags
- Check naming conventions
- Verify Consent Mode v2

7. What's Next?

Need Help?

If you run into issues:

  1. Check Troubleshooting Guide
  2. Review OAuth Scopes if you get permission errors
  3. Verify your API Key has the right tools enabled

Still stuck? Open an issue on GitHub.

On this page

First Query | Metrifyr Docs | Metrifyr