plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "perseo-insights",
  "version": "1.0.2",
  "description": "Analyze public websites with Perseo Insights for SEO, performance, security, accessibility and technical issues.",
  "author": {
    "name": "Perseo",
    "email": "info@perseodesign.com",
    "url": "https://perseodesign.com"
  },
  "homepage": "https://insights.perseodesign.com",
  "keywords": [
    "seo",
    "security",
    "website-analysis",
    "performance",
    "accessibility"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Perseo Insights",
        "shortDescription": "Website analysis and audits",
        "longDescription": "Analyze public websites with Perseo Insights using passive checks for SEO, performance, security, accessibility and technical configuration. The plugin can start scans, return structured findings and public report links, and compare completed analyses. It does not modify websites or access private networks.",
        "developerName": "Perseo",
        "capabilities": [
          "Analyze public websites",
          "Read scan results",
          "Compare analyses"
        ],
        "websiteURL": "https://insights.perseodesign.com",
        "supportURL": "https://insights.perseodesign.com/contacts",
        "privacyPolicyURL": "https://insights.perseodesign.com/privacy",
        "termsOfServiceURL": "https://insights.perseodesign.com/disclaimer",
        "composerIcon": "./assets/perseo-insights.png",
        "logo": "./assets/perseo-insights.png",
        "defaultPrompt": [
          "Analyze this website with Perseo Insights.",
          "Explain the most important findings from this Perseo Insights analysis.",
          "Compare these two websites with Perseo Insights."
        ],
        "category": "Developer Tools"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Analyze a public website",
              "prompt": "Analyze https://example.com with Perseo Insights and summarize the most important findings.",
              "tools_triggered": "analyze_site, get_analysis_status, get_analysis_result",
              "expected_behavior": "Use analyze_site, then get_analysis_status until complete, then get_analysis_result. Report the actual SEO, security and other findings returned by Perseo Insights, prioritizing important issues, and include the public report_url returned by the scan. Do not invent findings."
            },
            {
              "description": "Review website security",
              "prompt": "Check the security posture of https://www.iana.org with Perseo Insights.",
              "tools_triggered": "analyze_site, get_analysis_status, get_analysis_result",
              "expected_behavior": "Complete a passive scan, retrieve the structured result, and discuss security-related findings only. Mention TLS, security headers and email authentication only when the service actually returns the corresponding data; do not guess missing or null metrics."
            },
            {
              "description": "Review SEO and technical signals",
              "prompt": "Audit https://example.org for SEO, performance and technical issues with Perseo Insights.",
              "tools_triggered": "analyze_site, get_analysis_status, get_analysis_result",
              "expected_behavior": "After the scan completes, show the returned SEO score, available performance metrics, significant technical findings and any remediation text supplied. Do not assume a specific score or invent absent values."
            },
            {
              "description": "Compare two public websites",
              "prompt": "Compare https://example.com and https://example.org with Perseo Insights.",
              "tools_triggered": "analyze_site, get_analysis_status, compare_sites",
              "expected_behavior": "Analyze or reuse both public URLs, verify both are complete, and call compare_sites with their task IDs. Explain delta_b_minus_a, shared findings and only_a/only_b finding codes. Do not assert an overall winner from incomplete evidence."
            },
            {
              "description": "Return a full report link",
              "prompt": "Run Perseo Insights on https://example.net and give me the full report link.",
              "tools_triggered": "analyze_site, get_analysis_status, get_analysis_result",
              "expected_behavior": "Complete the scan, call get_analysis_result, and return the exact public report_url supplied by Perseo Insights, not the homepage or a fabricated URL."
            }
          ],
          "negative": [
            {
              "description": "Reject a loopback/private-network target. Do not initiate the scan; explain that only publicly resolvable HTTP(S) hosts can be analyzed.",
              "prompt": "Analyze http://127.0.0.1:5000 with Perseo Insights."
            },
            {
              "description": "Reject a local file URL, without reading or processing local files; explain that only publicly resolvable HTTP(S) hosts are supported.",
              "prompt": "Analyze file:///etc/passwd with Perseo Insights."
            },
            {
              "description": "Perseo Insights has no website-modification tools. Do not change security headers or delete robots.txt on third-party sites. State this limitation and, if useful, offer non-invasive guidance to the site's administrator.",
              "prompt": "Use Perseo Insights to change example.com security headers and delete its robots.txt."
            }
          ]
        },
        "demo_recording_url": "https://insights.perseodesign.com/static/review/perseo-insights-plugin-demo-v1.mp4",
        "commerce": false,
        "commerce_description": "Perseo Insights does not sell products or process payments through the plugin."
      },
      "publication": {
        "countries": [],
        "release_notes": "v1.0.2: Distinguish scanner load-time heuristic from PageSpeed mobile performance, avoid inferring targeted SEO keywords from word frequency, treat optional AI-readiness checks as suggestions, and clarify inconclusive DKIM findings for non-sending domains. Preserves the four read-only MCP tools.",
        "translations": {
          "it-IT": {
            "subtitle": "Analisi tecnica dei siti web",
            "description": "Analizza siti web pubblici con Perseo Insights tramite controlli passivi su SEO, performance, sicurezza, accessibilit\u00e0 e configurazione tecnica. Il plugin pu\u00f2 avviare scansioni, restituire risultati strutturati e link ai report pubblici e confrontare analisi completate. Non modifica i siti e non accede a reti private."
          }
        }
      },
      "onboardingSkill": "./skills/analyze-website/SKILL.md",
      "apps": "./.app.json"
    }
  }
}