analyzify

Original：🇺🇸 English

Translated

Complete skill for the Analyzify Shopify analytics and tracking app. Covers all Analyzify MCP features and workflows. Trigger when the user wants to: check store info, view workspace details, query Google Analytics 4 data, run GA4 reports, check GA4 traffic, query Google Search Console data, view search performance, top queries, query Google Ads campaigns and performance, view ad spend and ROAS, access Shopify store data via Admin API, list products, collections, orders, query historical analytics reports, campaign attribution, traffic trends, check connected accounts, view API key capabilities, or any Analyzify-related task. Covers questions like: "what is my store", "what is my space ID", "show my GA4 traffic", "top search queries this week", "how are my Google Ads performing", "list my products", "show campaign attribution", "compare organic vs paid traffic", "what accounts are connected", "what plan am I on", "show my store dashboard", "daily sessions this month". All operations use MCP tools: execute_graphql, execute_report_graphql, introspect_schema, introspect_report_schema.

2installs

Sourceanalyzify/analyzify-mcp-public

Added on2026-04-04

NPX Install

npx skill4agent add analyzify/analyzify-mcp-public analyzify

SKILL.md Content

View Translation Comparison →

Analyzify MCP Skill

Complete workflow guide for the Analyzify Shopify analytics platform. Operations go through MCP tools.

Two APIs — use the right tool:

API	Introspect tool	Execute tool	What it has
Analyzify API	`introspect_schema`	`execute_graphql`	Live data: Shopify proxy, GA4 proxy, GSC proxy, Google Ads proxy, workspace info
Report API	`introspect_report_schema`	`execute_report_graphql`	Historical data: traffic trends, campaign attribution, aggregated metrics

MANDATORY: Session Initialization

At the very start of EVERY conversation, before responding to the user, execute this query via

execute_graphql

:

graphql

{ extMe { workspaceId shopUrl shopName shopifyShopId shopifyScope shopifyIanaTimezone capabilities keyName reportSpaceId ga4 { propertyID accountName } googleAds { accountID } googleSearchConsole { url } } }

Store the entire response for the session. This gives you:

workspaceId — the workspace/user ID (this IS the "space ID" if the user asks)
shopUrl / shopName — the Shopify store
reportSpaceId — report space ID for analytics data
ga4.propertyID — GA4 property ID to use in ga4Proxy paths
googleAds.accountID — Google Ads customer ID to use in gadsProxy paths
googleSearchConsole.url — GSC site URL to use in gscProxy paths

Never ask the user for these IDs. If a service is null, it's not connected.

Playbooks (Business Questions)

Match the user's question to the right playbook. Each playbook has exact queries, variables, presentation formats, and follow-up handling.

Playbook	Triggers	File
Diagnose Sales Drop	"Why are sales down?", "Revenue dropped", "What changed?", "Why did X decline?", "Something broke"	`playbooks/diagnose-sales-drop.md`
Weekly/Monthly Report	"Weekly report", "Monthly recap", "Business summary", "How did we do?"	`playbooks/weekly-monthly-report.md`
Profit & Revenue	"What's my profit?", "Revenue?", "MER?", "Costs?", "P&L?", "Margin?"	`playbooks/profit-and-revenue.md`
Sales & Orders	"Total sales?", "Orders?", "AOV?", "Returns?", "Find order #X?"	`playbooks/sales-and-orders.md`
Product Optimization	"Best/worst products?", "What should I promote?", "High views low sales?", "Dead stock?"	`playbooks/product-optimization.md`
Ad Performance	"How are my ads?", "ROAS?", "Campaign performance?", "Best/worst campaigns?"	`playbooks/ad-performance.md`
Budget Allocation	"Where to spend more?", "Budget optimization?", "Scale ads?", "Cut wasteful spend?"	`playbooks/budget-allocation.md`
Attribution	"Where do orders come from?", "First/last touch?", "Channel attribution?"	`playbooks/attribution.md`
Conversion Optimization	"Improve conversion rate?", "Cart abandonment?", "Funnel?", "Bounce rate?", "Mobile conversion?"	`playbooks/conversion-optimization.md`
Traffic & SEO	"Traffic sources?", "SEO?", "Top queries?", "Landing pages?", "404s?"	`playbooks/traffic-and-seo.md`
Seasonal / YoY	"Compare to last year?", "YoY growth?", "Seasonal trends?", "Am I on track?", "BFCM planning?"	`playbooks/seasonal-yoy-comparison.md`
Discount & Promo Impact	"Are discounts working?", "Promotion results?", "Margin impact?", "Should I run a sale?"	`playbooks/discount-promotion-impact.md`
Conversion Health	"Is tracking working?", "Last conversion?", "Tags broken?", "PMax not converting?"	`playbooks/conversion-health-tracking.md`
Store Health	"How's my store?", "Overview?", "Dashboard?", "KPIs?"	`playbooks/store-health.md`
Customer Insights	"New vs returning?", "Segments?", "CAC?", "Repeat rate?", "LTV?"	`playbooks/customer-insights.md`

Priority matching:

If the user describes a problem ("sales dropped", "why did X change") → use Diagnose Sales Drop
If the user asks for a report ("weekly report", "monthly summary") → use Weekly/Monthly Report
If the user asks a specific question → match to the relevant playbook above
If the user is vague ("how's my store?", "give me an overview") → use Store Health

API References (Technical)

Flow	Trigger	Reference
Workspace & Account Info	User asks about store, space ID, capabilities, connected accounts	`references/workspace.md`
Shopify Store Data	User wants products, collections, orders, themes, or any Shopify Admin data	`references/shopify.md`
Google Analytics 4	User wants GA4 traffic, reports, sessions, pageviews, realtime data	`references/ga4.md`
Google Search Console	User wants search performance, top queries, impressions, clicks, CTR	`references/gsc.md`
Google Ads	User wants ad campaigns, spend, ROAS, conversions, keywords	`references/gads.md`
Analytics Reports	Full report query reference with all fields, inputs, and response shapes	`references/reports.md`

Query Strategy: Report API First

ALWAYS try the Report API first. It has pre-aggregated historical data that is fast and doesn't hit external rate limits.

Match the user's request to a Report API query (see
```
references/reports.md
```
)
If the Report API has the data → use
```
execute_report_graphql
```
Only fall back to live proxies (ga4Proxy, gscProxy, gadsProxy, shopifyProxy) when:
- The Report API doesn't have the query (e.g., realtime GA4 data)
- The user needs live/current data that hasn't been synced yet
- The user needs Shopify Admin data (products, collections, themes) — these are only available via
```
shopifyProxy
```

Examples:

"What's my revenue?" → Report API (
```
ga4Scorecards
```
or
```
profitMerReport
```
)
"Show my top campaigns" → Report API (
```
gadsCampaignsPerformance
```
or
```
fbCampaignInsights
```
)
"Realtime visitors right now" → Live proxy (
```
ga4Proxy
```
with realtime endpoint)
"List my products" → Live proxy (
```
shopifyProxy
```
)

How to Use

Run the extMe initialization query (MANDATORY)
Match the user's request to a Report API query first (check
```
references/reports.md
```
)
If no Report API query fits, match to a live proxy flow
Load the corresponding reference file for exact operations

Use

introspect_schema

or

introspect_report_schema

if you need field details

Execute and present results cleanly — no technical jargon

Behavior Rules

NEVER mention GraphQL, APIs, queries, mutations, tool names, schemas, or any technical details to the user
NEVER show raw JSON, query strings, or error codes
If a Google service is null in extMe: "That service isn't connected to your store yet. You can set it up in your Analyzify dashboard."
Present data in clean tables, lists, or summaries
Act like a knowledgeable assistant who just knows things about the store
If the user asks "what version" or "skill version": reply with both versions:
- Skill version: from this file's frontmatter (
```
version
```
  field)
- MCP server version: run
```
analyzify-mcp version
```
  via terminal if available
- Suggest
```
npx skills add analyzify/analyzify-mcp-public
```
  to update the skill
- Suggest
```
curl -sL https://raw.githubusercontent.com/analyzify/analyzify-mcp-public/main/install.sh | sh
```
  to update the MCP server

Quick Reference

Get workspace info:

graphql

{ extMe { workspaceId shopUrl shopName shopifyShopId shopifyIanaTimezone reportSpaceId capabilities keyName ga4 { propertyID accountName } googleAds { accountID } googleSearchConsole { url } } }

List products (via Shopify proxy):

graphql

{ shopifyProxy(query: "{ products(first: 10) { edges { node { id title handle status } } } }") { data errors } }

GA4 traffic report (use propertyID from extMe):

graphql

query($body: JSON) { ga4Proxy(input: { path: "properties/{propertyID}:runReport", body: $body }) { statusCode data } }

analyzify

NPX Install

Tags

SKILL.md Content

Analyzify MCP Skill

MANDATORY: Session Initialization

Playbooks (Business Questions)

API References (Technical)

Query Strategy: Report API First

How to Use

Behavior Rules

Quick Reference