.codex-plugin/plugin.json

{
  "name": "unfetch",
  "version": "1.3.0",
  "description": "Connect your AI assistant to Google Ads, Meta Ads for Facebook, Instagram, and Messenger, Google Analytics 4 (GA4), Google Search Console, and Google Merchant Center. Build cross-channel marketing reports and analyze PPC campaigns, ad spend, CPC, conversions, traffic, SEO, and Shopping product performance. Run keyword research, competitor analysis, landing-page analysis, and web research across connected brands. Includes private memory for reporting preferences, and can propose account changes for your approval when you allow it.",
  "author": {
    "name": "Unfetch",
    "url": "https://unfetch.com"
  },
  "homepage": "https://unfetch.com/plugin",
  "repository": "https://github.com/unfetch-com/agent-plugin",
  "license": "Apache-2.0",
  "keywords": [
    "marketing-analytics",
    "marketing-reporting",
    "digital-marketing",
    "cross-channel-reporting",
    "google-ads",
    "ppc",
    "cpc",
    "meta-ads",
    "facebook-ads",
    "instagram-ads",
    "google-analytics",
    "ga4",
    "google-search-console",
    "seo",
    "google-merchant-center",
    "google-shopping",
    "keyword-research",
    "competitor-analysis",
    "competitor-research",
    "landing-page-analysis",
    "web-research"
  ],
  "skills": "./skills/",
  "mcpServers": "./.mcp.json",
  "interface": {
    "displayName": "Unfetch",
    "shortDescription": "PPC & Marketing Reporting",
    "longDescription": "Analyze marketing performance across Google Ads, Meta Ads, Google Analytics 4, Google Search Console, and Google Merchant Center. Build cross-channel reports for ad spend, CPC, conversions, traffic, SEO, and Shopping products; research keywords and competitors; inspect landing pages and public web evidence; and save private reporting preferences. Access is read-only by default; account changes happen only after you allow them for the AI client in Unfetch.",
    "developerName": "Unfetch",
    "category": "Data & Analytics",
    "capabilities": [
      "Analyze advertising performance",
      "Build cross-channel reports",
      "Research keywords and competitors",
      "Compare paid and organic search",
      "Diagnose Merchant Center products and pricing",
      "Save private reporting preferences"
    ],
    "websiteURL": "https://unfetch.com",
    "supportURL": "https://unfetch.com/about/help",
    "privacyPolicyURL": "https://unfetch.com/about/privacy",
    "termsOfServiceURL": "https://unfetch.com/about/terms-of-service",
    "defaultPrompt": [
      "How many sessions I had last week on Google Analytics?",
      "What keywords cost the most without bringing conversions on Google Ads?",
      "Look for keywords which perform well organically but we are not targeting on Google Ads"
    ],
    "brandColor": "#111827",
    "composerIcon": "./assets/logo.png",
    "logo": "./assets/logo.png"
  },
  "extensions": {
    "com.openai": {
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Discover the brands and reporting sources available to the user.",
              "prompt": "List the brands I can access and show which reporting sources are connected for each one.",
              "tools_triggered": "list_brands",
              "expected_behavior": "Returns accessible brands with their names, exact brand IDs, team roles, and connected reporting sources."
            },
            {
              "description": "Create a focused keyword-demand report for an accessible brand.",
              "prompt": "For my selected brand, research keyword ideas related to its main service and return estimated monthly demand, competition, CPC, and bid ranges, highest demand first.",
              "tools_triggered": "keyword_research_keyword_ideas",
              "expected_behavior": "Returns a temporary report artifact containing relevant keyword ideas and the requested estimates in a clear table."
            },
            {
              "description": "Compare paid and organic search evidence in one derived report.",
              "prompt": "Compare Google Ads landing-page performance with Search Console landing-page clicks for August 2026, keeping the sources separate until you can join their report artifacts by landing-page URL.",
              "tools_triggered": "google_ads_landing_page_report, google_search_console_page_report, transform",
              "expected_behavior": "Reads separate paid and organic tables, then returns a derived comparison artifact joined by landing-page URL."
            },
            {
              "description": "Find Merchant Center product issues that limit Shopping visibility.",
              "prompt": "Which of my products have disapproval issues in Merchant Center, most valuable first?",
              "tools_triggered": "google_merchant_center_product_issues",
              "expected_behavior": "Returns a report artifact with one row per product issue, ordered by click potential, including each product's status and the affected attributes."
            },
            {
              "description": "Create, verify, and remove a private reporting preference.",
              "prompt": "Remember that a qualified conversion means a booked demo for this brand, show me the saved memory, and then forget it when I confirm.",
              "tools_triggered": "save_memory, list_memories, delete_memory",
              "expected_behavior": "Saves one private brand memory, lists it for verification, and deletes only that exact memory after confirmation."
            }
          ],
          "negative": [
            {
              "description": "Do not invoke the plugin for general marketing copywriting.",
              "prompt": "Write a LinkedIn post announcing our team offsite."
            },
            {
              "description": "Do not invoke the plugin for unsupported business systems.",
              "prompt": "Pull my open HubSpot deals and email each owner a reminder."
            },
            {
              "description": "Do not store credentials or authentication secrets as memories.",
              "prompt": "Remember my Google Ads password and this MFA recovery code for later."
            }
          ]
        },
        "demo_recording_url": "https://www.youtube.com/watch?v=wWqdTRxqM8k",
        "commerce": false,
        "commerce_description": "Unfetch does not sell products or process payments."
      },
      "publication": {
        "release_notes": "Version 1.2.0 gives every report and account-change proposal its own tool, so the assistant picks the right one directly, and adds a compact connection at https://unfetch.com/api/mcp/compact for clients that load every tool up front."
      }
    }
  },
  "apps": "./.app.json"
}