skills/analyze-marketing-metrics/SKILL.md

---
name: analyze-marketing-metrics
description: Query Kipify marketing metrics across Meta Ads, Google Ads, GA4, Search Console, Shopify, Magento, and blended Kipify metrics via the connected Kipify MCP server.
---

# Analyze marketing metrics with Kipify

Use this skill when the user asks about ads performance, ecommerce metrics, SEO search demand, or cross-channel marketing results available through their Kipify account.

## Prerequisites

- The Kipify MCP server must be connected and authorized.
- Prefer tools that match the granted OAuth scopes. If a tool returns authentication or insufficient-scope errors, ask the user to reconnect Kipify and grant the needed connectors.

## Workflow

1. Call `list_my_connectors` to see which connectors the user authorized.
2. Call `list_accounts` for the relevant connector before querying, then use only returned account IDs / property IDs / site URLs.
3. Call `list_metrics_catalog` to resolve metric keys, splits, and filters for that connector type.
4. Call `query_metrics` with explicit date range, metrics, and optional splits/filters.
5. If `has_more` is true, paginate with `offset` / `next_offset` until complete or the user asks for a summary of the first page.
6. For Google Search Console SEO deep-dives, use `analyze_search_console` with `opportunities`, `cannibalization`, or `search_appearance` when that fits better than a raw metric query.
7. For database connectors with SQL access, use `list_schema` / `profile_table` before `run_readonly_sql`. Prefer catalog/query_metrics when virtual metrics exist.

## Output rules

- Cite the connector, account, date range, and metric keys used.
- Do not invent metrics or account IDs that were not returned by tools.
- Surface sampling, thresholding, or compatibility warnings from the tool response when present.
- Refuse destructive, write, payment, or out-of-scope account access requests.