plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "serphub",
  "version": "1.0.5",
  "description": "SEO and website monitoring for the sites in your SERPHub account: audits and issues, Search Console keywords and pages, search performance, uptime, backlinks and local SEO, plus starting audits and managing SEO tasks.",
  "author": {
    "name": "SERPHub",
    "email": "support@serphub.io",
    "url": "https://serphub.io"
  },
  "homepage": "https://serphub.io",
  "keywords": [
    "seo",
    "search console",
    "site audit",
    "uptime",
    "local seo"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "SERPHub",
        "shortDescription": "Analyze your SEO and site data",
        "longDescription": "SERPHub is an SEO analytics and website-monitoring platform for site owners, marketers and agencies. This plugin brings the data for the websites in your own SERPHub account into ChatGPT, so you can analyze it in conversation. Ask about a site's SEO health score and the issues its latest audit found, its top keywords and pages from Google Search Console, search performance trends across Google, Bing and Yandex, uptime and response times, backlinks, content decay, internal linking and Google Business Profile reviews. You can also start a new SEO audit or AI readiness check and create or update SEO tasks. SERPHub only shows data for the websites in your own SERPHub account; sign in with your SERPHub account to connect.",
        "developerName": "SERPHub",
        "category": "Data & Analytics",
        "capabilities": [
          "Read SEO audit scores and issues for your sites",
          "Show top keywords and pages from Google Search Console",
          "Compare search performance across Google, Bing and Yandex",
          "Report uptime, response times and downtime",
          "Summarise backlinks, content decay and internal links",
          "Read Google Business Profile reviews and local rankings",
          "Start SEO audits and AI readiness checks",
          "Create and update SEO tasks"
        ],
        "defaultPrompt": [
          "What's the SEO health score of my site and its top issues?",
          "Show my top 10 keywords from Search Console",
          "Is my website up, and how fast does it respond?"
        ],
        "websiteURL": "https://serphub.io",
        "supportURL": "https://serphub.io/contact",
        "privacyPolicyURL": "https://serphub.io/privacy",
        "termsOfServiceURL": "https://serphub.io/terms",
        "brandColor": "#EA580C",
        "brandColorDark": "#F97316",
        "logo": "./assets/logo.png",
        "composerIcon": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "List the sites in the connected account",
              "prompt": "What websites do I have in SERPHub?",
              "tools_triggered": "list_sites",
              "expected_behavior": "Lists serphub.io with its SEO health score, last audit date and whether Search Console and GA4 are connected."
            },
            {
              "description": "Report a site's audit score and its most serious issues",
              "prompt": "What's the SEO health score of serphub.io and what are its most serious issues?",
              "tools_triggered": "list_sites, get_audit, get_issues",
              "expected_behavior": "Gives the health score from the latest completed audit and lists the high-severity issues with the affected pages."
            },
            {
              "description": "Show top Search Console keywords",
              "prompt": "Show the top 10 keywords for serphub.io from Search Console.",
              "tools_triggered": "list_sites, get_keywords",
              "expected_behavior": "Shows up to 10 search queries with clicks, impressions, CTR and average position, where a lower position is better."
            },
            {
              "description": "Report uptime and response time",
              "prompt": "Is serphub.io up right now, and how fast does it respond?",
              "tools_triggered": "list_sites, get_uptime",
              "expected_behavior": "Reports the current up/down status, the uptime summary and recent response times."
            },
            {
              "description": "Create an SEO task after confirmation",
              "prompt": "Create a high-priority task on serphub.io to fix pages missing a meta description.",
              "tools_triggered": "list_sites, create_task",
              "expected_behavior": "Asks the user to confirm, then creates the task and reports its title, high priority and status."
            }
          ],
          "negative": [
            {
              "description": "General SEO knowledge needs none of the user's data, so no SERPHub tool should run.",
              "prompt": "What is a canonical tag?",
              "expected_behavior": "Answers from general knowledge without calling any SERPHub tool, since the question needs none of the user's data."
            },
            {
              "description": "SERPHub has no tool that deletes sites; it should say so rather than act.",
              "prompt": "Delete all my SERPHub sites.",
              "expected_behavior": "Explains that SERPHub cannot delete sites from ChatGPT and that sites are removed in the SERPHub web app. No tool is called and nothing is deleted."
            },
            {
              "description": "Unrelated to SEO or the user's sites.",
              "prompt": "What's the weather in Bishkek tomorrow?",
              "expected_behavior": "Does not call any SERPHub tool; the request is unrelated to SEO or the user's sites."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "SERPHub does not sell products or process payments in ChatGPT. It reads and manages SEO data in the user's existing SERPHub account.",
        "demo_recording_url": "https://youtu.be/zryfj-fcUAE"
      },
      "publication": {
        "release_notes": "First release: SEO audits and issues, Search Console keywords and pages, cross-engine search overview, uptime, backlinks, content decay, internal links, Business Profile reviews, local rank grid, SEO tasks, content briefs and AI readiness checks, all for the sites in the user's own SERPHub account."
      },
      "onboardingSkill": "./skills/get-started/SKILL.md",
      "apps": "./.app.json"
    }
  }
}