.codex-plugin/plugin.json

{
  "author": {
    "name": "Adzviser LLC"
  },
  "description": "Connect your Google Search Console data to ChatGPT with Adzviser. Ask questions in plain language to see which queries bring people to your site and where you rank.\n\nCompare clicks, impressions, click-through rate, and average position across date ranges. Break results down by query, page, country, or device. Turn your search data into clear reports, spot ranking trends, and see which pages are winning organic traffic.",
  "interface": {
    "capabilities": [],
    "category": "Data & Analytics",
    "defaultPrompt": [
      "How many clicks did my site get from Google search last week?",
      "Generate a monthly Search Console report covering the last 30 days",
      "Show me my top search queries and average position for the last 14 days"
    ],
    "developerName": "Adzviser LLC",
    "displayName": "Adzviser Search Console",
    "longDescription": "Connect your Google Search Console data to ChatGPT with Adzviser. Ask questions in plain language to see which queries bring people to your site and where you rank.\n\nCompare clicks, impressions, click-through rate, and average position across date ranges. Break results down by query, page, country, or device. Turn your search data into clear reports, spot ranking trends, and see which pages are winning organic traffic.",
    "privacyPolicyURL": "https://docs.adzviser.com/privacy",
    "shortDescription": "Talk to your Google SEO data",
    "supportURL": "https://adzviser.com/contact-us",
    "termsOfServiceURL": "https://docs.adzviser.com/terms",
    "websiteURL": "https://adzviser.com",
    "logo": "./assets/adzviser-directory-light.png",
    "composerIcon": "./assets/adzviser-directory-light.png"
  },
  "name": "adzviser-search-console",
  "skills": "./skills",
  "version": "1.0.0",
  "extensions": {
    "com.openai": {
      "publication": {
        "release_notes": "Initial release of Adzviser Search Console for ChatGPT. Ask questions about your search performance, compare clicks, impressions, click-through rate, and average position over time, and explore your top queries and pages with interactive reports.",
        "countries": []
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Monthly report totals and rates. Run in a fresh ChatGPT conversation with this Search Console plugin enabled. The dedicated reviewer login must have access to the Demo workspace and its connected Search Console account, with report data for the relevant complete calendar months. The publisher confirmed that reviewer access includes Demo. Resolve relative dates at execution time and state the inclusive date ranges. If Demo is unavailable, report a setup failure instead of switching workspaces.",
              "prompt": "In my Demo workspace, show Google Search Console clicks, impressions, CTR, and average position for the last complete calendar month.",
              "tools_triggered": "list_workspace, list_metrics_and_breakdowns_search_console, retrieve_reporting_data",
              "expected_behavior": "Use workspace_name Demo and discover the exact metric names. Call retrieve_reporting_data with one adzviser_request containing one date_ranges pair for the last complete calendar month and assorted_requests.gsc_request metrics Clicks, Impressions, CTR, Position. Report clicks and impressions as counts, CTR as a rate, and Position as the returned average; do not sum rates or positions. The current backend rounds fractional CTR to two decimal places. If presenting the returned CTR as a percentage, multiply the ratio by 100 and disclose that precision limit; never label a fractional value such as 0.01 as 0.01%. A more precise CTR may be calculated as Clicks / Impressions when Impressions is nonzero, but label it as calculated rather than the returned CTR. State the exact dates and assumptions. Do not open Preview UI or invent values for empty results."
            },
            {
              "description": "Compare two complete months in one reporting request. Run in a fresh ChatGPT conversation with this Search Console plugin enabled. The dedicated reviewer login must have access to the Demo workspace and its connected Search Console account, with report data for the relevant complete calendar months. The publisher confirmed that reviewer access includes Demo. Resolve relative dates at execution time and state the inclusive date ranges. If Demo is unavailable, report a setup failure instead of switching workspaces.",
              "prompt": "In my Demo workspace, compare Search Console clicks and impressions for the last complete calendar month with the month before it. Show absolute and percentage changes.",
              "tools_triggered": "list_workspace, list_metrics_and_breakdowns_search_console, retrieve_reporting_data",
              "expected_behavior": "Use workspace_name Demo. Retrieve Clicks and Impressions through assorted_requests.gsc_request with two inclusive calendar-month date_ranges in one request. Identify both periods and calculate changes from their respective returned totals. Flag a zero or missing comparison baseline instead of dividing by zero. Do not use the preview tool."
            },
            {
              "description": "Rank queries from returned rows. Run in a fresh ChatGPT conversation with this Search Console plugin enabled. The dedicated reviewer login must have access to the Demo workspace and its connected Search Console account, with report data for the relevant complete calendar months. The publisher confirmed that reviewer access includes Demo. Resolve relative dates at execution time and state the inclusive date ranges. If Demo is unavailable, report a setup failure instead of switching workspaces.",
              "prompt": "In my Demo workspace, what were my top 10 Google search queries by clicks last complete calendar month? Include impressions and average position.",
              "tools_triggered": "list_workspace, list_metrics_and_breakdowns_search_console, retrieve_reporting_data",
              "expected_behavior": "Use workspace_name Demo. Use gsc_request metrics Clicks, Impressions, Position and the discovered Search query breakdown for the last complete calendar month. Sort the returned rows by Clicks and show up to 10 query rows, preserving returned values. Do not invent a server-side filter or limit argument; disclose missing data or returned-row limitations."
            },
            {
              "description": "Daily trend without putting Date in breakdowns. Run in a fresh ChatGPT conversation with this Search Console plugin enabled. The dedicated reviewer login must have access to the Demo workspace and its connected Search Console account, with report data for the relevant complete calendar months. The publisher confirmed that reviewer access includes Demo. Resolve relative dates at execution time and state the inclusive date ranges. If Demo is unavailable, report a setup failure instead of switching workspaces.",
              "prompt": "In my Demo workspace, show daily Search Console clicks and impressions for the last complete calendar month and identify the highest-click day.",
              "tools_triggered": "list_workspace, list_metrics_and_breakdowns_search_console, retrieve_reporting_data",
              "expected_behavior": "Use workspace_name Demo. Use time_granularity Date on adzviser_request and gsc_request metrics Clicks and Impressions. Do not put Date in breakdowns. Present the returned daily values and identify the highest-click day or ties using only the returned data. Report an empty dataset honestly."
            },
            {
              "description": "Interactive landing-page report and component execution. Run in a fresh ChatGPT conversation with this Search Console plugin enabled. The dedicated reviewer login must have access to the Demo workspace and its connected Search Console account, with report data for the relevant complete calendar months. The publisher confirmed that reviewer access includes Demo. Resolve relative dates at execution time and state the inclusive date ranges. If Demo is unavailable, report a setup failure instead of switching workspaces. After the preview appears, the reviewer selects Run in the component.",
              "prompt": "Open an interactive Search Console report in my Demo workspace for clicks and impressions by landing page for the last complete calendar month so I can review and run it.",
              "tools_triggered": "list_workspace, list_metrics_and_breakdowns_search_console, preview_and_retrieve_reporting_data",
              "expected_behavior": "Use workspace_name Demo. Call preview_and_retrieve_reporting_data once with gsc_request metrics Clicks and Impressions and breakdown Landing page. The component opens with Demo and the resolved date range. The initial preview is configuration, not report results; do not fabricate an analysis or issue duplicate conversational retrievals. When the reviewer selects Run, the component requests reporting rows through its MCP bridge, normally using retrieve_reporting_data; the model does not need to call that tool to open the preview. The widget displays returned rows or an accurate no-data result. Successful preview configuration alone does not pass the rendering and Run checks."
            }
          ],
          "negative": [
            {
              "description": "Unsupported sitemap deletion. Explain that this Search Console connector reports data and cannot delete submitted sitemaps. Do not call its reporting, preview, or discovery tools as a substitute, and do not claim a deletion occurred.",
              "prompt": "Delete every submitted sitemap from my Google Search Console property."
            },
            {
              "description": "Unsupported website editing. Explain that this Search Console connector cannot change website content or metadata. Do not invoke tools from this plugin or claim an edit. Guidance about using a separate website-management tool is acceptable.",
              "prompt": "Change the title tag on my homepage to Best SEO Agency and publish it."
            },
            {
              "description": "Unsupported source in this Search Console-only plugin. Explain that GA4 revenue and purchases require a separate Google Analytics connection. Do not send ga4_request to these tools or substitute Search Console metrics.",
              "prompt": "Use this Search Console plugin to fetch my Google Analytics 4 purchase revenue for last month."
            }
          ]
        },
        "demo_recording_url": "https://youtu.be/dmRHECWu9c8",
        "commerce": false,
        "commerce_description": "Adzviser subscriptions are purchased separately on the Adzviser website (https://adzviser.com). This plugin provides reporting access for the connected Adzviser account and does not offer in-plugin purchases, checkout, or payment processing."
      }
    }
  },
  "mcpServers": "./.mcp.json",
  "apps": "./.app.json"
}