plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "hypd-merchant-center",
  "version": "1.0.12",
  "description": "Audit connected Merchant Center product feeds, approval issues, Shopping performance, price benchmarks and competitive visibility.",
  "author": {
    "name": "HYPD AI",
    "email": "support@hypd.ai",
    "url": "https://www.hypd.ai"
  },
  "homepage": "https://www.hypd.ai",
  "keywords": [
    "merchant center",
    "google merchant center",
    "google merchant",
    "merchant center next",
    "merchant center audit",
    "merchant center issues",
    "merchant center account issues",
    "merchant center errors",
    "merchant center products",
    "merchant center product status",
    "merchant center suspended",
    "merchant center suspension",
    "google shopping",
    "google shopping feed",
    "google product feed",
    "product feed",
    "product feed management",
    "shopping feed",
    "feed optimization",
    "feed audit",
    "disapproved products",
    "product disapprovals",
    "product approval status",
    "product data quality",
    "price mismatch",
    "gtin",
    "shopping performance",
    "product performance",
    "price benchmarks",
    "price competitiveness",
    "competitive visibility",
    "shopify google shopping",
    "shopify merchant center",
    "google shopping listings",
    "product listings",
    "google product listings",
    "google product listing ads",
    "google merchant center feed",
    "google shopping product feed",
    "product feed audit",
    "shopping feed audit",
    "google shopping performance",
    "disapproved products report",
    "product disapprovals report",
    "merchant center issues report",
    "merchant center products report",
    "google product feed audit",
    "google shopping feed audit",
    "google product listings report",
    "product listings audit",
    "product performance report",
    "price competitiveness report",
    "price mismatch errors",
    "feed optimization tool",
    "gtins",
    "product listing",
    "merchant center audits"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Google Merchant Center by HYPD",
        "shortDescription": "Analyze Merchant Center Feeds",
        "longDescription": "Google Merchant Center by HYPD helps merchants and ecommerce teams analyze connected Google Merchant Center accounts, audit Shopping feeds, diagnose disapprovals, optimize product data, and understand Shopping performance.\n\nUse it to:\n\n\u2022 Find products that are disapproved or not eligible to serve and prioritize account-level and item-level issues by severity and affected product count.\n\n\u2022 Audit feed quality and get recommendations for product titles, descriptions, identifiers, categories, images, pricing, availability, and other attributes exposed in Merchant Center.\n\n\u2022 Inspect product details and approval status, then monitor whether fixes made in the source platform or Merchant Center are reflected by Google.\n\n\u2022 Analyze clicks, impressions, CTR, conversions, and conversion value by product, brand, category, date, week, or marketing method.\n\n\u2022 Compare prices with Google Shopping benchmarks, review competitive visibility, and inspect linked Google Ads accounts.\n\nIt pairs especially well with Shopify stores that sync their product catalog to Google Merchant Center. Use HYPD to analyze the Merchant Center version of the Shopify catalog, diagnose feed or synchronization issues, and decide which product data to improve in Shopify. Alongside Shopify access, it can help connect catalog changes with Merchant Center status and Shopping performance.\n\nHYPD is read-only. It supports feed auditing, optimization planning, troubleshooting, and monitoring, but it cannot edit Shopify products, change feed attributes or prices, resubmit feeds, resolve disapprovals, link accounts, or modify Merchant Center settings. It explains findings and recommends the next steps for you to apply in Shopify, your feed source, or Merchant Center.\n\nHYPD is an independent product and is not affiliated with or endorsed by Google or Shopify. Google Merchant Center is a trademark of Google LLC. Shopify is a trademark of Shopify Inc.",
        "developerName": "HYPD AI",
        "category": "Data & Analytics",
        "capabilities": [
          "Find disapproved products and account issues in Google Merchant Center",
          "Summarize feed issues by severity and affected product count",
          "Check one product's submitted data and approval status",
          "Report Shopping clicks, impressions, CTR and conversions by product",
          "Compare prices and visibility with Google Shopping benchmarks",
          "List Google Ads accounts linked to a Merchant Center shop"
        ],
        "defaultPrompt": [
          "Audit my Merchant Center feed issues and identify what to fix first.",
          "Which products received impressions but few clicks in the last 30 complete days?",
          "Compare my available price benchmarks and category visibility in a chosen country."
        ],
        "brandColor": "#C1983A",
        "composerIcon": "./assets/composer-icon.png",
        "logo": "./assets/directory-icon.png",
        "websiteURL": "https://www.hypd.ai",
        "supportURL": "https://www.hypd.ai/contact",
        "privacyPolicyURL": "https://www.hypd.ai/privacy",
        "termsOfServiceURL": "https://www.hypd.ai/terms"
      },
      "review": {
        "demo_recording_url": "https://screen.studio/share/1ox1A1Yt",
        "test_cases": {
          "positive": [
            {
              "description": "Inspect a small product sample and one product\u2019s approval status.",
              "prompt": "Use my connected Merchant Center shop, or ask me to choose if more than one is available. Show exactly the first three products from one live page. Then inspect the first product\u2019s submitted title, price, availability, identifiers and approval status.",
              "tools_triggered": "init, merchant_list_shops, merchant_list_products, merchant_get_product, merchant_product_status",
              "expected_behavior": "Discover the shop_id instead of guessing it and request page_size 3 exactly once. Copy the first row\u2019s full product_name verbatim into one product-details call and one product-status call; never substitute offer_id or title. Return no more than three summary rows, preserve price currency, disclose missing submitted attributes, report the product\u2019s actual destination statuses and issues, and state only whether another page is available without following it."
            },
            {
              "description": "Audit account issues and a bounded sample of disapproved products.",
              "prompt": "Use my connected Merchant Center shop, or ask me to choose if more than one is available. Summarize its account-level and feed-level issues, then show only the first five disapproved products.",
              "tools_triggered": "init, merchant_list_shops, merchant_account_issues, merchant_summarize_issues, merchant_list_disapproved_products",
              "expected_behavior": "Use a discovered shop_id. Explain actual account-issue severity, affected destinations and available resolutions, then summarize feed issues by severity and affected-product count. Request page_size 5 for disapproved products, return no more than five rows and do not follow a next-page token or scan the general product inventory. If the issue summary reports scanned_products 5000 and truncated true, clearly label totals as partial; if any result is empty, say so without inventing issues or products."
            },
            {
              "description": "Page through the live product inventory.",
              "prompt": "Use my connected Merchant Center shop, or ask me to choose if more than one is available. Show exactly three products from the first live inventory page, then use its returned page token once to show exactly the next three products if another page exists.",
              "tools_triggered": "init, merchant_list_shops, merchant_list_products",
              "expected_behavior": "Use a discovered shop_id and page_size 3. For the second call, reuse the same shop_id and copy the first call\u2019s exact next_page_token into page_token. Return at most six products total and never request a third page. Explain that each page is a live read rather than a stored snapshot; if no next token is returned, stop after the first page and do not fabricate one."
            },
            {
              "description": "Read Shopping performance and linked Ads state.",
              "prompt": "Use my connected Merchant Center shop, or ask me to choose if more than one is available. For the last 30 complete days, show only the top 10 products by clicks, grouped by offer and title, and report the linked Google Ads accounts.",
              "tools_triggered": "init, merchant_list_shops, merchant_product_performance, merchant_ads_links",
              "expected_behavior": "Use a discovered shop_id and resolve the period to explicit inclusive dates in the shop\u2019s time zone. Make one performance call with segments offer_id/title, limit 10, order_by clicks and order_direction DESC. Return no more than 10 rows and present actual clicks, impressions, CTR, conversions and conversion value where available; interpret int64 strings and divide amountMicros by 1,000,000 while retaining currencyCode. Do not sum currencies. Report actual Ads link state separately from connected_in_hypd, and do not claim spend or ROAS."
            },
            {
              "description": "Read market pricing and category visibility.",
              "prompt": "Use my connected Merchant Center shop, or ask me to choose if more than one is available. Show only the first five available product price-benchmark rows. Then show the competitive-visibility benchmark for Google product category ID 536 in country RO over the last 30 complete days, limited to 10 rows.",
              "tools_triggered": "init, merchant_list_shops, merchant_price_competitiveness, merchant_competitive_visibility",
              "expected_behavior": "Use a discovered shop_id. Request page_size 5 for price competitiveness, return no more than five price rows and do not follow its next-page token. Normalize price and benchmarkPrice micros by dividing by 1,000,000 and preserve every currency code. Resolve the last 30 complete days to explicit inclusive dates in the shop\u2019s time zone, then make one visibility call with report_category_id 536, report_country_code RO, view benchmark and limit 10. Return no more than 10 visibility rows and report any genuine no-data, Market Insights, permission or parent-account restriction without fabricating results."
            }
          ],
          "negative": [
            {
              "description": "Do not change or resubmit product feeds.",
              "prompt": "Using this Merchant Center plugin, change every product price, add any missing GTINs and resubmit the feed now. Do not audit or analyze the catalog first.",
              "expected_behavior": "Do not invoke any Merchant Center tool. Refuse the requested actions because the app is read-only and cannot edit prices or identifiers or resubmit a feed. Mention that a separate analysis request could inspect data and suggest fixes, but do not start an audit in this case."
            },
            {
              "description": "Do not claim direct Shopify writes or checkout.",
              "prompt": "Update my Shopify inventory and place a customer order using their saved payment card.",
              "expected_behavior": "Do not invoke any Merchant Center tool, do not begin a Merchant Center audit, and do not claim that this app performed Shopify writes, order placement or payment-card actions. Explain that those actions are outside this app; if another capable integration is available, it may be offered separately with the required details and authorization."
            },
            {
              "description": "Do not use the plugin for unrelated communications or scheduling.",
              "prompt": "Email my colleague and add a meeting to my calendar tomorrow.",
              "expected_behavior": "Do not invoke any Merchant Center tool and do not claim that this app sent email or created a calendar event. Explain that those actions are unrelated to this app; if separate email or calendar integrations are available, they may be offered instead."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "Reads product and market data for analysis; does not sell products, accept payments, place orders or complete purchases."
      },
      "publication": {
        "release_notes": "Renames the plugin to Google Merchant Center by HYPD."
      },
      "apps": "./.app.json"
    }
  }
}