plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "genseo",
  "version": "1.2.8",
  "description": "Explore AI visibility, SEO, AEO and GEO insights, compare competitors, and act on content opportunities with Genseo.",
  "author": {
    "name": "trinker media gmbh",
    "email": "support@genseo.co",
    "url": "https://www.genseo.co"
  },
  "homepage": "https://docs.genseo.co/developers/overview",
  "repository": "https://github.com/trinker-media/Genseo",
  "license": "LicenseRef-Genseo-Proprietary",
  "keywords": [
    "seo",
    "ai-visibility",
    "content-marketing",
    "keyword-research",
    "publishing",
    "mcp"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Genseo",
        "shortDescription": "AI visibility, SEO, AEO & GEO",
        "longDescription": "Understand how your brand appears in search and AI answers. Genseo brings AI visibility, SEO (Search Engine Optimization), AEO (Answer Engine Optimization) and GEO (Generative Engine Optimization) insights into your conversation, using data from your connected Genseo projects.\n\n## See where your brand shows up\n\n- Explore stored AI visibility trends, brand mentions, citations and sentiment.\n- Review the questions you track and see where your brand is mentioned or missing.\n- Compare competitor visibility and discover which sources are cited in your stored results.\n\n## Turn insights into your next steps\n\n- Research SEO opportunities and review existing audits and open issues.\n- Prioritize findings by the severity and evidence available in your project.\n- Explore existing posts and drafts, create SEO drafts, and publish approved content through supported integrations when your permissions allow it.\n\n## Built for marketers, founders and agencies\n\nAsk questions in plain language, select a project, and bring your visibility data into the conversation. Compare results, investigate content gaps and decide what to work on next without manually assembling reports from multiple screens.\n\n## Try asking\n\n\u201cWhere are competitors more visible than us in our stored AI results?\u201d\n\u201cWhich tracked prompts mention our brand, and which do not?\u201d\n\u201cShow our open SEO issues and help me prioritize them.\u201d\n\u201cList our existing drafts without generating or publishing anything.\u201d\n\n## Your account, your control\n\nRequires a Genseo account and access to the selected project. Available results depend on your stored data, tracking setup and connected integrations. Read requests do not start new tracking. Generation, tracking, audits and publishing are separate actions. Write access follows your role, scopes and Agent Autonomy settings. Genseo does not guarantee rankings, AI recommendations or citations.",
        "developerName": "trinker media gmbh",
        "category": "Data & Analytics",
        "capabilities": [
          "Interactive",
          "Read",
          "Write"
        ],
        "websiteURL": "https://www.genseo.co",
        "supportURL": "https://www.genseo.co/contact",
        "privacyPolicyURL": "https://www.genseo.co/legal/privacy-policy",
        "termsOfServiceURL": "https://www.genseo.co/legal/terms",
        "defaultPrompt": [
          "List my accessible Genseo projects and ask which one to use.",
          "Show my AI visibility trend, competitors, and most-cited sources.",
          "Create an SEO draft, but do not publish it."
        ],
        "brandColor": "#45403D",
        "composerIcon": "./assets/Genseo-Dark-ChatGPT.png",
        "logo": "./assets/Genseo-Dark-ChatGPT.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Identify the connected account and list accessible projects. Prerequisite: the reviewer account has at least one accessible non-sensitive sample project.",
              "prompt": "List my accessible Genseo projects and ask which one I want to use. Do not change anything.",
              "tools_triggered": "genseo_me, genseo_projects_list",
              "expected_behavior": "Both reads succeed. List only projects returned for the connected account and ask for explicit selection without silently choosing. An authentication/server error is a failure, not an empty project list. Same-name projects remain distinct; use project IDs or distinguishing details when needed. Exact wording and project counts can change."
            },
            {
              "description": "Run in a fresh chat using the reviewer account. First list accessible projects, then wait for the reviewer to select one explicitly. Continue this same scenario after selection; no context from another test is required. Use stored data only. The chosen project must have stored visibility results. Reviewer setup: the account must have access to the populated Heyflow project d83b8319-d937-4cea-ac83-24d8f8670eb8 (heyflow.com); do not use another same-name project. After the project-selection question, reply exactly: \"Use Heyflow project d83b8319-d937-4cea-ac83-24d8f8670eb8.\" Then request: \"Show the stored data for the last 30 days. Do not start tracking or a recheck.\" Verify this fixture is still accessible before review; access errors must not be treated as empty data.",
              "prompt": "Show my Genseo AI visibility trend, competitors and cited sources using stored data only. First list my projects and ask which one to use, then continue after I choose. Do not start tracking or a recheck.",
              "tools_triggered": "genseo_me, genseo_projects_list, genseo_visibility_overview",
              "expected_behavior": "After explicit selection, pass that project_id and days=30. Report the returned period, visibility KPI and available trend points, competitor names and cited source domains. Values must match the tool response; missing comparisons must be described as unavailable. No tracking, generation or writes. Compare each metric to its corresponding response field, not to another aggregation: overview and competitor metrics may differ. Distinguish completed prompts from completed checks. Calculate changes only from returned comparable points. Live values are not fixed acceptance thresholds."
            },
            {
              "description": "Run in a fresh chat using the reviewer account. First list accessible projects, then wait for the reviewer to select one explicitly. Continue this same scenario after selection; no context from another test is required. Use stored data only. The chosen project must contain at least one active sample prompt. Reviewer setup: the account must have access to the populated Heyflow project d83b8319-d937-4cea-ac83-24d8f8670eb8 (heyflow.com); do not use another same-name project. After the project-selection question, reply exactly: \"Use Heyflow project d83b8319-d937-4cea-ac83-24d8f8670eb8.\" Verify this fixture is still accessible before review; access errors must not be treated as empty data.",
              "prompt": "Show my existing active Genseo visibility prompts. First list my projects and ask which one to use, then continue after I choose. Do not create, edit, archive or track anything.",
              "tools_triggered": "genseo_me, genseo_projects_list, genseo_visibility_prompts_list",
              "expected_behavior": "After explicit selection, use that project_id and status=active. Show returned prompt texts and only available stored metrics. Do not include archived prompts or invent results. No mutations or tracking requests. A clearly labeled partial list is acceptable; do not imply it is the full list. Counts must come from returned totals or complete pagination. Repeated texts with distinct IDs are distinct records; claim duplicates only when supported by returned records."
            },
            {
              "description": "Run in a fresh chat using the reviewer account. First list accessible projects, then wait for the reviewer to select one explicitly. Continue this same scenario after selection; no context from another test is required. Use stored data only. Include stored audits/issues when available; an empty response has its own explicit outcome. Reviewer setup: the account must have access to the populated Heyflow project d83b8319-d937-4cea-ac83-24d8f8670eb8 (heyflow.com); do not use another same-name project. After the project-selection question, reply exactly: \"Use Heyflow project d83b8319-d937-4cea-ac83-24d8f8670eb8.\" Verify this fixture is still accessible before review; access errors must not be treated as empty data.",
              "prompt": "Show existing Genseo audits and open SEO issues. First list my projects and ask which one to use, then continue after I choose. Prioritize the returned open issues by severity. Do not start an audit, crawl or recheck.",
              "tools_triggered": "genseo_me, genseo_projects_list, genseo_audits_list, genseo_issues_list",
              "expected_behavior": "Use the selected project_id for both reads and status=open for issues. Summarize returned audit statuses and open issues with available severity/evidence, identifying any list limit rather than claiming a complete ranking. If audits=[] or issues=[], explicitly state that no stored records were returned for that list; never start a job or treat a tool error as no data. The observed Heyflow run returned no stored audits and no open issues; this is a valid empty-state test, not proof of severity sorting. If stored records change, report their actual current values."
            },
            {
              "description": "Run in a fresh chat using the reviewer account. First list accessible projects, then wait for the reviewer to select one explicitly. Continue this same scenario after selection; no context from another test is required. Use stored data only. The chosen project must contain at least one sample post. Reviewer setup: the account must have access to the populated Heyflow project d83b8319-d937-4cea-ac83-24d8f8670eb8 (heyflow.com); do not use another same-name project. After the project-selection question, reply exactly: \"Use Heyflow project d83b8319-d937-4cea-ac83-24d8f8670eb8.\" Verify this fixture is still accessible before review; access errors must not be treated as empty data.",
              "prompt": "List my existing Genseo posts with titles and statuses. First list my projects and ask which one to use, then continue after I choose. Do not create, generate, edit, schedule or publish anything.",
              "tools_triggered": "genseo_me, genseo_projects_list, genseo_posts_list",
              "expected_behavior": "After explicit selection, use that project_id. List each returned post once with its returned title and status; the posts/data aliases must not create duplicates. Indicate pagination/limits when applicable. No write, generation or publishing tools. The observed run showed two posts with status generated. Do not hard-code that count, status or titles: match the current response. Optional dates must be supported by returned fields and do not prove that publishing happened."
            }
          ],
          "negative": [
            {
              "description": "General SEO education needs no account data: answer directly without invoking Genseo tools.",
              "prompt": "What is the difference between SEO and AI visibility? Give a general explanation without accessing my accounts."
            },
            {
              "description": "Ad campaign management is not supported: explain the limitation without invoking Genseo tools or changing ad spend.",
              "prompt": "Increase my Google Ads campaign budget to 100 euros per day."
            },
            {
              "description": "Billing and refunds are unavailable through the connector: explain the limitation and direct the user to support without invoking Genseo tools.",
              "prompt": "Cancel my Genseo subscription and refund my last payment."
            }
          ]
        },
        "demo_recording_url": "https://drive.google.com/file/d/1ok-e9QM_N4gyjZD5iS1v_i-6knVmLGVj/view?usp=sharing"
      },
      "publication": {
        "release_notes": "Version 1.2.8 replaces uppercase section labels with sentence-case Markdown headings in the listing description. The updated logo and AI visibility, SEO, AEO and GEO copy are retained. Tools, OAuth, review scenarios and permissions are unchanged."
      },
      "apps": "./.app.json"
    }
  }
}