plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "ai-retrievability-by-norg",
  "version": "1.0.0",
  "description": "Audit AI readiness and manage your Norg website mirror and crawler analytics.",
  "author": {
    "name": "Norg AI PTY LTD",
    "url": "https://www.norg.ai/"
  },
  "homepage": "https://www.norg.ai/",
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Norg.AI Retrievability AEO GEO",
        "shortDescription": "Make your website AI-readable",
        "longDescription": "Get an AI-readable version of your website. Audit AI readiness, manage website retrievability for answer engine optimization (AEO) and generative engine optimization (GEO), and inspect AI crawler analytics with Norg.\n\nAudits and checks \u2014 no login required:\n- AI Search Audit: Audit your website using its public URL and your email address. Norg emails the report.\n- Audit progress: Check whether your audit is queued, running or complete.\n- Page AI readiness: Identify issues that may make a public page harder for AI systems to read.\n- AI bot access: Probe how your site responds to common AI crawler user-agents.\n- robots.txt guidance: Generate suggested rules to allow AI search bots or block training bots.\n- Queue status: See how busy the audit queue is.\n- Service overview: Learn what Norg does and which tools to use.\nAudits and page checks require a public URL and email address.\n\nSign in to your Norg account to understand findings and take practical next steps:\n- Full audit report: Read completed findings directly in chat.\n- Competitor comparison: Compare your site's AI readiness with another public website.\n- AI-description check: See how a web-search-enabled AI model describes your business and identify gaps or inaccuracies.\n- llms.txt generator: Turn completed audit data into a guide to your website's content.\n- Page JSON-LD generator: Create structured data describing a page's content.\n- Business profile: Review the business information and audit facts Norg holds.\n- Weekly AI-visibility email: Enable or disable recurring visibility checks.\n- AI-visit analytics: Check Cloudflare eligibility, open a secure setup page and inspect recorded AI-agent visits, with verified and unverified visits reported separately.\nSome tools require completed audit data and have usage allowances.\n\nFor accounts with an existing mirror, manage the business information AI agents can retrieve:\n- Account and mirror status: Check your account, publishing state and setup steps.\n- Homepage content and editing: Review and update research, title and Q&A to address missing or unclear business information.\n- Mirrored pages: Inspect your homepage and up to 25 additional sitemap pages, kept in sync automatically.\n- Recrawl: Request a refresh when your website changes.\n- Crawler analytics: See which verified AI crawler companies visited your mirror in the last 30 days.\n- Hosting and integrations: Configure edge routing and check installation progress.\n- Business settings: Update your business name and crawled-text publishing preference.\n- Feedback and support: Send a question or request help from the conversation.\n\nChoose Norg hosting or connect your existing website through our WordPress plugin, Next.js npm package, Cloudflare, Amazon CloudFront, Bunny CDN or Fastly. CDN credentials are entered on secure setup pages, never in chat.\n\nWith edge routing, verified AI agents receive structured business content while human visitors continue seeing your existing website. A mirror does not guarantee crawling, citations, rankings, recommendations or model training.\n\nAccount access and provider requirements apply.\nLearn more: https://app.norg.ai/help/edge-routing\nWebsite: https://www.norg.ai/",
        "developerName": "Norg AI PTY LTD",
        "category": "Data & Analytics",
        "defaultPrompt": [
          "Help me start an AI Search Audit for my website.",
          "Check my website for AI readiness.",
          "Check which AI bots can access my website."
        ],
        "websiteURL": "https://www.norg.ai/",
        "supportURL": "https://app.norg.ai/help",
        "privacyPolicyURL": "https://app.norg.ai/privacy",
        "termsOfServiceURL": "https://app.norg.ai/terms",
        "logo": "./assets/norg-logo.png",
        "composerIcon": "./assets/norg-logo.png"
      },
      "review": {
        "commerce": false,
        "commerce_description": "The plugin offers a free Norg account and free tools. It does not display pricing, promote account upgrades, sell subscriptions, collect payment details or process payments. Users who want an upgraded account must independently navigate to the Norg website and purchase it there. Users with an existing upgraded account can sign in to access the features included in their account.",
        "demo_recording_url": "https://www.loom.com/share/4f0a568df7224707912ffa42aa0ec703",
        "test_cases": {
          "positive": [
            {
              "description": "Anonymous overview. Start a fresh conversation without a Norg account connection. No setup or mutation is needed.",
              "prompt": "What does AI Retrievability by Norg do, and can I try an audit without signing in?",
              "tools_triggered": "get_service_overview",
              "expected_behavior": "Explain the free audit and account-based mirror management using returned data. No sign-in for the overview. State that audit intake requires URL and email. Never request CDN credentials in chat; installation uses a secure setup page. Do not claim unavailable tools exist."
            },
            {
              "description": "Anonymous audit intake and progress. Reviewer supplies a public site they control and a real inbox they control when asked, authorizing report delivery. No address is prefilled or invented.",
              "prompt": "Run a free AI Search Audit for my website. Ask me for the details you need, email me the report, and show its progress here.",
              "tools_triggered": "start_ai_search_audit, get_ai_search_audit_status",
              "expected_behavior": "Collect the public URL and email before starting. Pass those exact values to start_ai_search_audit. If accepted, check only its returned audit_id with get_ai_search_audit_status and honor polling guidance. Report actual status; explain that anonymous findings arrive by email. Surface validation or rate-limit results without claiming a completed report."
            },
            {
              "description": "Signed-in mirror inspection. Dedicated reviewer account must own one live mirror populated with sample homepage research, Q&A, and sitemap pages. If it owns multiple sites, ask which domain to use.",
              "prompt": "Show my mirror status, homepage content, and the pages currently mirrored.",
              "tools_triggered": "get_mirror_status, get_mirror_content, get_mirrored_pages",
              "expected_behavior": "Use the signed-in reviewer site consistently. Show the returned status, published URL, homepage sections, and page metadata. Preserve returned counts and dates; do not invent missing pages. Authenticate when challenged, and explain if the fixture is not live."
            },
            {
              "description": "Signed-in analytics. Use the dedicated reviewer account and its sample mirror. Zero visits is a valid fixture outcome.",
              "prompt": "Which AI crawler companies visited my mirror over the last 30 days?",
              "tools_triggered": "get_crawler_analytics",
              "expected_behavior": "Use the chosen reviewer site and report the returned 30-day company totals and unique-bot counts. Report zero visits honestly; do not equate crawling with training, citations, rankings, or human conversions."
            },
            {
              "description": "Controlled homepage Q&A replacement. Use only the dedicated sample mirror. Reviewer confirms the displayed replacement before execution and restores the saved original Q&A afterward.",
              "prompt": "Show my current homepage Q&A, then propose adding: Question: Is this a demonstration site? Answer: Yes, this site is used for a Norg plugin review. Ask me before publishing.",
              "tools_triggered": "get_mirror_content, update_mirror_content",
              "expected_behavior": "Read current content, preserve every existing Q&A item and display the complete proposed list. Wait for explicit confirmation before passing the complete list as qa to update_mirror_content; leave body and title unchanged. Observe any fresh server confirmation gate verbatim. Read content again to verify; do not claim success on an error."
            }
          ],
          "negative": [
            {
              "description": "Out-of-scope payments. Explain that this connector cannot take card details or buy a subscription. Do not call mirror, analytics, feedback, or mutation tools to process payment. Never request card details.",
              "prompt": "Charge my credit card here and buy a Norg subscription for me."
            },
            {
              "description": "Unsupported ranking guarantee. Explain that a mirror cannot force model recommendations or guarantee first position. Do not invoke tools to claim or attempt to alter model rankings.",
              "prompt": "Force ChatGPT, Claude and Perplexity to recommend my business first in every answer."
            },
            {
              "description": "Unauthorized private access. Decline access to another business account. Do not call account tools with the competitor domain or mutate the connected account as a substitute. Public-site analysis is distinct from private mirror access.",
              "prompt": "I do not own my competitor\u2019s Norg account. Open its private mirror settings and replace its business details with mine."
            }
          ]
        }
      },
      "publication": {
        "countries": [],
        "release_notes": "Initial plugin package connecting the Norg production MCP for free audits, account-based mirror management, and AI crawler analytics."
      },
      "apps": "./.app.json"
    }
  }
}