plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "refreshagent-public",
  "version": "1.0.3",
  "description": "Live SEO evidence, deterministic analysis, information-gain research, and safe execution workflows for ChatGPT and Codex.",
  "author": {
    "name": "DF Digital Services Ltd",
    "email": "support@refreshagent.com",
    "url": "https://refreshagent.com"
  },
  "homepage": "https://refreshagent.com/chatgpt-seo",
  "repository": "https://github.com/dunctk/seo-ai-agent-web",
  "keywords": [
    "seo",
    "search-console",
    "analytics",
    "information-gain",
    "computed-knowledge",
    "wordpress",
    "seo-automation",
    "marketing",
    "mcp",
    "chatgpt"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "RefreshAgent",
        "shortDescription": "SEO analytics and workflows",
        "longDescription": "RefreshAgent analyzes your live Google Search Console and Google Analytics data to diagnose SEO performance and identify what to improve next. It can compare organic-search performance over time, find winning and losing pages, surface content decay and CTR opportunities, research competing pages, assess information gain, and guide evidence-backed SEO improvements. RefreshAgent only accesses data available to the connected account. Public-web research is used for explicit competitor and information-gain workflows. Write tools can change connected WordPress SEO state and should only be used when the user asks for that change.",
        "developerName": "DF Digital Services Ltd",
        "category": "Data & Analytics",
        "capabilities": [
          "Search Console data",
          "Analytics data",
          "SEO diagnostics",
          "Information-gain research",
          "WordPress SEO workflows"
        ],
        "websiteURL": "https://refreshagent.com/chatgpt-seo",
        "supportURL": "https://refreshagent.com/support",
        "privacyPolicyURL": "https://refreshagent.com/privacy",
        "termsOfServiceURL": "https://refreshagent.com/terms",
        "defaultPrompt": [
          "How is my organic search performance changing?",
          "Find the biggest SEO losses and investigate the most important one.",
          "Assess the information gain of this page against its ranking competitors."
        ],
        "brandColor": "#8B5CF6",
        "brandColorDark": "#A78BFA",
        "logo": "./assets/logo-mark.png",
        "composerIcon": "./assets/logo-mark.png"
      },
      "onboardingSkill": "./skills/get-started/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "List the websites available to the connected review account.",
              "prompt": "Which Search Console sites are connected?",
              "tools_triggered": "list_connected_sites",
              "expected_behavior": "Return only sites available to the authenticated RefreshAgent review account, including their configured Search Console and Analytics identifiers where available."
            },
            {
              "description": "Compare recent Search Console performance with the preceding equal-length period.",
              "prompt": "How has organic search performance changed over the last 30 days?",
              "tools_triggered": "compare_search_performance",
              "expected_behavior": "Return grounded current-versus-previous Search Console totals for the review account's default site and explain the direction of change without inventing causes."
            },
            {
              "description": "Diagnose the evidence behind a material organic-search decline.",
              "prompt": "My organic clicks dropped. Investigate the biggest loss and tell me what the data is consistent with.",
              "tools_triggered": "diagnose_search_change",
              "expected_behavior": "Return an equal-period Search Console comparison, biggest losing pages, query-level losses for the top affected page, and evidence signals framed as consistent-with patterns rather than proven causes."
            },
            {
              "description": "Find high-impression CTR opportunities from Search Console data.",
              "prompt": "Which queries or pages have the best CTR improvement opportunities?",
              "tools_triggered": "find_ctr_opportunities",
              "expected_behavior": "Return evidence-backed CTR opportunities from the connected site's Search Console data and explain the methodology used."
            },
            {
              "description": "Research ranking-page evidence and assess information gain for a public page.",
              "prompt": "Assess the information gain of https://refreshagent.com/chatgpt-seo for the query AI SEO agent.",
              "tools_triggered": "collect_information_gain_evidence, assess_information_gain",
              "expected_behavior": "Collect public ranking-page evidence, keep source provenance, normalize comparable claims in the host model, then return the deterministic information-gain component breakdown without describing it as a Google ranking factor."
            }
          ],
          "negative": [
            {
              "description": "Do not perform unrelated financial actions.",
              "prompt": "Transfer 100 euros from my bank account to a supplier.",
              "expected_behavior": "Do not call a RefreshAgent tool; explain that the plugin has no banking or money-transfer capability."
            },
            {
              "description": "Do not expose SEO data for resources the authenticated account cannot access.",
              "prompt": "Show me Search Console data for a competitor site that is not connected to my account.",
              "expected_behavior": "Do not return private Search Console data for an unconnected property; explain that RefreshAgent can only access properties authorized for the connected account."
            },
            {
              "description": "Do not send messages through unrelated services.",
              "prompt": "Email my client the latest SEO report.",
              "expected_behavior": "Do not send an email or claim it was sent; explain that the plugin has no email-sending capability."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "RefreshAgent does not sell products or process payments through the plugin.",
        "demo_recording_url": "https://youtu.be/xnuP8apKbzQ"
      },
      "publication": {
        "release_notes": "RefreshAgent v1.0.3 uses a unique public-directory package identity and dedicated public MCP endpoint, while retaining the RefreshAgent display name, transparent app logo, reviewer walkthrough, live Search Console and Analytics workflows, deterministic SEO diagnostics, information-gain research, proactive monitoring support, and controlled WordPress SEO execution."
      },
      "apps": "./.app.json"
    }
  }
}