Skip to content
Back to search

adspirer-analytics

Read-only marketing analytics: report spend, conversions, CPA and ROAS across ad platforms, GA4 and Search Console. It never changes your accounts.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/adspirer--adspirer-analytics-antigravity-plugin/badge.svg)](/listings/adspirer--adspirer-analytics-antigravity-plugin)

HTML

<a href="/listings/adspirer--adspirer-analytics-antigravity-plugin"><img src="/api/listings/adspirer--adspirer-analytics-antigravity-plugin/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**Antigravity app:** open **Customizations**, find **Adspirer Marketing Analytics** in the Marketplace, and install it.

**Antigravity CLI:**

agy plugin install https://github.com/Adspirer/adspirer-analytics-antigravity-plugin

**Manual:** clone this repository into your plugins folder.

git clone https://github.com/Adspirer/adspirer-analytics-antigravity-plugin ~/.gemini/config/plugins/adspirer-analytics

Then sign in: open **Customizations**, then **Installed**, then **MCP Servers**, and choose **Authenticate** next to the Adspirer server. Sign in to Adspirer in the browser, then connect the accounts you want to report on at [adspirer.ai/connections](https://adspirer.ai/connections). No API key or client secret is required. An Adspirer account is required, and plan usage limits apply.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

plugin.json · Manifest · 43 lines
  1. {
  2. "$schema": "https://antigravity.google/schemas/v1/plugin.json",
  3. "name": "adspirer-analytics",
  4. "displayName": "Adspirer Marketing Analytics",
  5. "version": "1.0.0",
  6. "description": "Read-only marketing analytics: report spend, conversions, CPA and ROAS across ad platforms, GA4 and Search Console. It never changes your accounts.",
  7. "logo": "assets/logo.svg",
  8. "suggestedPrompts": [
  9. "Show spend, conversions, CPA and ROAS by channel for the last 30 days, with a blended total",
  10. "Audit my conversion tracking across my ad platforms, GA4 and Tag Manager",
  11. "Find ad spend that is not converting and suggest what to cut"
  12. ],
  13. "author": {
  14. "name": "Adspirer",
  15. "email": "support@adspirer.com",
  16. "url": "https://www.adspirer.com"
  17. },
  18. "homepage": "https://www.adspirer.com",
  19. "repository": "https://github.com/Adspirer/adspirer-analytics-antigravity-plugin",
  20. "license": "MIT",
  21. "keywords": [
  22. "adspirer",
  23. "marketing analytics",
  24. "advertising analytics",
  25. "cross-channel reporting",
  26. "attribution",
  27. "roas",
  28. "cpa",
  29. "google ads",
  30. "meta ads",
  31. "tiktok ads",
  32. "linkedin ads",
  33. "amazon ads",
  34. "microsoft ads",
  35. "google analytics",
  36. "ga4",
  37. "search console",
  38. "tag manager",
  39. "conversion tracking",
  40. "wasted spend",
  41. "read-only"
  42. ]
  43. }
README.md · README · 129 lines
  1. # Adspirer Marketing Analytics for Antigravity
  2. Ask the agent how your marketing is doing and get answers from your real accounts. Adspirer Marketing Analytics is read-only: it reports spend, clicks, conversions, CPA and ROAS by channel and blended across channels, diagnoses funnels and attribution, audits conversion tracking, and reads Google Analytics 4, Search Console and Tag Manager. It cannot create, change, pause or delete anything.
  3. ## Use it for
  4. - **Cross-channel reporting:** spend, conversions, CPA and ROAS by channel with a blended total, for any period you name.
  5. - **Attribution and funnels:** find where the funnel breaks, from ad click to site conversion.
  6. - **Web analytics:** Google Analytics 4 traffic and conversions, Search Console queries and pages, and Tag Manager setup.
  7. - **Tracking audits:** grade conversion tracking across ad platforms, GA4, Tag Manager and the Meta Pixel.
  8. - **Wasted spend:** search terms, keywords, placements and audiences spending without converting.
  9. - **Competitors:** the public ads a competitor is running now.
  10. ## Install
  11. **Antigravity app:** open **Customizations**, find **Adspirer Marketing Analytics** in the
  12. Marketplace, and install it.
  13. **Antigravity CLI:**
  14. ```text
  15. agy plugin install https://github.com/Adspirer/adspirer-analytics-antigravity-plugin
  16. ```
  17. **Manual:** clone this repository into your plugins folder.
  18. ```text
  19. git clone https://github.com/Adspirer/adspirer-analytics-antigravity-plugin ~/.gemini/config/plugins/adspirer-analytics
  20. ```
  21. Then sign in: open **Customizations**, then **Installed**, then **MCP Servers**, and choose
  22. **Authenticate** next to the Adspirer server. Sign in to Adspirer in the browser, then connect the
  23. accounts you want to report on at [adspirer.ai/connections](https://adspirer.ai/connections). No
  24. API key or client secret is required. An Adspirer account is required, and plan usage limits apply.
  25. ## Get started
  26. Ask:
  27. ```text
  28. Show spend, conversions, CPA and ROAS by channel for the last complete 30 days, with a blended total.
  29. Which Search Console queries and pages lost the most clicks this month?
  30. Walk my conversion funnel and tell me where it breaks.
  31. Audit my GA4 and Meta Pixel tracking.
  32. ```
  33. Or start with a skill by name:
  34. | Skill | What it does |
  35. | --- | --- |
  36. | `/adspirer-analytics-setup` | Connect your accounts and get a first look |
  37. | `/adspirer-analytics-status` | Connected accounts and remaining plan usage |
  38. | `/adspirer-analytics-performance-review` | Scorecard against the previous period, with the top changes |
  39. | `/adspirer-analytics-wasted-spend` | Spend that is not converting, with a fix proposed for each item |
  40. | `/adspirer-analytics-tracking-audit` | Grade conversion tracking and list the gaps |
  41. Add a platform and period if you want, for example `/adspirer-analytics-performance-review last 7 days`.
  42. ## What it covers
  43. | Area | Capabilities |
  44. | --- | --- |
  45. | Ad platforms | Google, Meta, TikTok, LinkedIn, Amazon, Microsoft, ChatGPT and Walmart Ads performance |
  46. | Web analytics | Google Analytics 4, Search Console and Tag Manager |
  47. | Diagnostics | Funnel diagnosis, conversion-tracking audit, and wasted-spend analysis |
  48. | Competitor research | Public competitor ads |
  49. This plugin is read-only by design. Requests to create, pause, change budgets, submit URLs for
  50. indexing or edit tags are declined.
  51. ## What's included
  52. - **Skills** (`skills/`): the five entry points above, plus `adspirer-analytics-attribution`,
  53. `adspirer-analytics-competitor-research`, `adspirer-analytics-conversion-tracking`,
  54. `adspirer-analytics-cross-channel`, `adspirer-analytics-platform-reports`,
  55. `adspirer-analytics-product-help`, `adspirer-analytics-strategy`, `adspirer-analytics-tools` and
  56. `adspirer-analytics-web-analytics`, which the agent loads when a request needs them.
  57. - **A rule** (`rules/adspirer-analytics.md`) that loads only for marketing-analytics requests and
  58. keeps the agent read-only.
  59. - **The Adspirer Marketing Analytics MCP server** connection (`mcp_config.json`).
  60. The hosted server is the source of truth for tool names and schemas. The skills teach the agent to
  61. discover the current tools and their parameters instead of hardcoding every operation.
  62. ## Safety
  63. - **No writes.** The plugin cannot create, change, pause, resume or delete anything.
  64. - **No purchases.** The agent never buys, upgrades or renews a plan or paid feature. If a plan limit
  65. is reached, it stops and explains the limit.
  66. - **Confirmation first** before quota-heavy runs, such as reporting on every account or property.
  67. - **Honest numbers.** Currency, dates, attribution window and data freshness are stated; ratios are
  68. computed from totals; missing data is never reported as zero; platform-attributed revenue is not
  69. treated as incremental profit; competitor research covers public ads only.
  70. ## MCP and authentication
  71. ```json
  72. {
  73. "mcpServers": {
  74. "analytics": {
  75. "url": "https://mcp.adspirer.com/analytics"
  76. }
  77. }
  78. }
  79. ```
  80. The server speaks Streamable HTTP. Authentication uses OAuth 2.1 with PKCE and dynamic client
  81. registration, so Antigravity handles the browser sign-in and the plugin contains no API keys,
  82. tokens, client secrets, or configuration variables. Ad-platform credentials stay server-side with
  83. Adspirer and are scoped to the accounts you connect.
  84. ## Network and execution surface
  85. The plugin's only MCP server is `https://mcp.adspirer.com/analytics`. It contains no hooks,
  86. scripts, telemetry, local executables, or bundled server code. Skills and the rule are Markdown
  87. guidance. Beyond the Adspirer server, the skills may ask the agent to read Adspirer's public
  88. documentation at `adspirer.com/docs` to answer questions about plans and setup.
  89. ## Privacy, support, and source
  90. - Privacy policy: [adspirer.com/privacy](https://www.adspirer.com/privacy)
  91. - Terms: [adspirer.com/terms](https://www.adspirer.com/terms)
  92. - Documentation: [adspirer.com/docs](https://www.adspirer.com/docs)
  93. - Support: [support@adspirer.com](mailto:support@adspirer.com)
  94. - Issues: [github.com/Adspirer/adspirer-analytics-antigravity-plugin/issues](https://github.com/Adspirer/adspirer-analytics-antigravity-plugin/issues)
  95. ## License
  96. MIT. See [LICENSE](LICENSE).

Version history

  • v1.0.011/21/2026

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.