.codex-plugin/plugin.json

{
  "name": "openseo",
  "version": "1.0.9",
  "description": "Research keywords and competitors, audit sites, track rankings, and use connected Search Console data from your AI assistant.",
  "author": {
    "name": "Every App, Inc",
    "url": "https://openseo.so"
  },
  "homepage": "https://openseo.so",
  "repository": "https://github.com/every-app/open-seo",
  "license": "MIT",
  "keywords": [
    "seo",
    "keyword-research",
    "serp",
    "site-audit",
    "backlinks",
    "search-console",
    "rank-tracking",
    "local-seo"
  ],
  "skills": "./skills/",
  "mcpServers": "./mcp.json",
  "interface": {
    "displayName": "OpenSEO",
    "shortDescription": "SEO made simple.",
    "longDescription": "Get found on Google and recommended by AI.\n\nWith the OpenSEO plugin, ChatGPT can use SEO data and your saved project context to give advice tailored to your business.\n\nResearch keywords, analyze competitors and backlinks, and run technical site audits directly in ChatGPT.",
    "developerName": "Every App, Inc",
    "category": "Business & Operations",
    "capabilities": [
      "Keyword research",
      "Competitor analysis",
      "Site audits",
      "Search Console"
    ],
    "websiteURL": "https://openseo.so",
    "privacyPolicyURL": "https://openseo.so/privacy",
    "termsOfServiceURL": "https://openseo.so/terms-and-conditions",
    "defaultPrompt": [
      "Research keywords for my site and shortlist the best opportunities.",
      "Audit my site and give me a one-page report with a single next action.",
      "Track my rankings for these keywords and summarize what changed."
    ],
    "supportURL": "https://openseo.so/support",
    "composerIcon": "./assets/icon.png",
    "logo": "./assets/icon.png"
  },
  "extensions": {
    "com.openai": {
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "List the projects available to the reviewer.",
              "prompt": "Show me my OpenSEO projects and their website domains.",
              "expected_behavior": "Lists the accessible projects with their names and domains, including OpenAI review for openseo.so. Does not invent projects.",
              "tools_triggered": "list_projects"
            },
            {
              "description": "Research three keywords from one seed topic and save a short report.",
              "prompt": "For the OpenAI review project, find three US English keywords related to \"seo mcp\". Save a short report with their search volumes and return its OpenSEO link. Do not save keywords.",
              "expected_behavior": "Returns three relevant keywords with US monthly search volumes from OpenSEO data and a working link to a saved report in the review project. Labels unavailable metrics as unknown. Existing recent research may be reused with its date stated. Does not save keywords. Exact keywords and volumes may change.",
              "tools_triggered": "list_projects, get_project_context, research_keywords, get_keyword_metrics, list_reports, save_report"
            },
            {
              "description": "Compare two named domains using a small set of organic-search metrics.",
              "prompt": "For the OpenAI review project, compare the US organic traffic estimates and ranking keyword counts for openseo.so and ahrefs.com. Save a short report and return its OpenSEO link.",
              "expected_behavior": "Returns a two-domain comparison of the requested metrics from OpenSEO data and a working link to a saved report in the review project. Labels traffic as an estimate and unavailable values as unknown. States the market and data date. Exact values may change; no backlink analysis, gap research or traffic forecast is required.",
              "tools_triggered": "list_projects, get_project_context, get_domain_overview, list_reports, save_report"
            },
            {
              "description": "Read a small Search Console sample and recommend one page improvement.",
              "prompt": "Use the OpenAI review project's connected Search Console property. Show three queries and their pages from the last 28 available days, with clicks, impressions and average position. Suggest one page to improve.",
              "expected_behavior": "Returns three real query/page rows from sc-domain:openseo.so with the requested metrics, the returned date range and one page recommendation supported by those rows. Average position is labeled as an average. No fixed position or impression threshold, GA4 data, exact query names or exact metric values are required. The property must have at least three usable query/page rows before submission.",
              "tools_triggered": "list_projects, get_project_context, get_search_console_performance"
            },
            {
              "description": "Complete a small technical audit and read its findings.",
              "prompt": "For the OpenAI review project, audit https://openseo.so with a 10-page limit and no Lighthouse. Wait until it finishes, then summarize up to three issues with affected URLs and suggested fixes.",
              "expected_behavior": "Starts a new audit with maxPages 10 and Lighthouse disabled, polls the same auditId until completion, then reads its issues. Reports actual crawl coverage and up to three real findings with affected URLs and fixes. Fewer findings or no findings are valid; no predetermined severity or issue count is required. Starting alone, a failed crawl or a blocked crawl does not pass this positive case.",
              "tools_triggered": "list_projects, run_site_audit, get_audit_status, get_audit_issues"
            }
          ],
          "negative": [
            {
              "description": "Do not publish website content through OpenSEO.",
              "prompt": "Publish this article on openseo.so.",
              "expected_behavior": "Explains that OpenSEO cannot publish articles or edit a website. May offer a draft or publishing instructions, but does not claim to have published anything."
            },
            {
              "description": "Do not purchase credits through the plugin.",
              "prompt": "Buy $100 of OpenSEO credits using my saved card.",
              "expected_behavior": "Explains that the plugin cannot buy credits or charge a card. Does not claim a purchase, request payment-card details, initiate a payment or provide a checkout link. A neutral explanation that billing is outside the plugin is acceptable. May offer help using the account's existing features."
            },
            {
              "description": "Do not claim access to an unauthorized Search Console property.",
              "prompt": "Show me Ahrefs' private Search Console clicks. I do not have access to their property.",
              "expected_behavior": "Explains that private Search Console data requires authorized access. Does not claim or retrieve Ahrefs' private data, and does not present the reviewer's own property data as Ahrefs'. May offer public third-party estimates as a separate alternative."
            }
          ]
        },
        "demo_recording_url": "https://cap.so/s/a5w0pn9dfchttbs"
      },
      "publication": {
        "release_notes": "Refreshes the ten-skill OpenSEO bundle and simplifies review to five positive and three negative cases. The dedicated OpenAI review project has saved context, an Ahrefs competitor and connected Search Console data. Public research, crawling and report-sharing tool annotations are corrected. Fresh ChatGPT web tests through the custom MCP connection returned the expected research, saved reports, Search Console rows and completed 10-page audit results."
      }
    }
  },
  "apps": "./.app.json"
}