plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "focala",
  "version": "0.1.0",
  "description": "Track AI search visibility, compare competitors, and prioritize AEO, GEO, and SEO improvements using your Focala workspace data.",
  "author": {
    "name": "Focala",
    "url": "https://focala.ai"
  },
  "homepage": "https://focala.ai",
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Focala: AEO & GEO Analytics",
        "shortDescription": "Brand & competitor tracking",
        "longDescription": "Understand how your brand appears in AI search answers and where competitors lead. Use Focala workspace data to prioritize answer engine optimization (AEO), generative engine optimization (GEO), and search engine optimization (SEO) improvements. Explore AI visibility trends, competitor rankings, and AI referral traffic in ChatGPT.\n\nBuilt for marketing teams, SEO specialists, and agencies improving brand discoverability across AI search and traditional search engines.\n\nConnect your Focala workspace to:\n\u2022 Track brand visibility trends across monitored AI search engines.\n\u2022 Compare competitor rankings and find gaps in monitored prompts.\n\u2022 Explore prioritized recommendations, buyer insights, AI referral traffic, and content performance.\n\u2022 Review open tasks and, with the required permissions, create or update monitored prompts and tasks.\n\nRequires a Focala account and workspace. Available insights depend on your monitored data and connected integrations. Answers use existing workspace observations; asking a question does not start a new monitoring run. Missing observations and estimated impact are identified rather than presented as measured results.",
        "developerName": "Focala",
        "category": "Productivity",
        "capabilities": [
          "Read",
          "Write"
        ],
        "defaultPrompt": [
          "How has my brand's AI visibility changed over the last 30 days?",
          "Which competitors rank ahead of my brand on monitored prompts?",
          "What tasks are open in my Focala workspace?"
        ],
        "websiteURL": "https://focala.ai/",
        "supportURL": "https://focala.ai/contact",
        "privacyPolicyURL": "https://focala.ai/privacy-policy",
        "termsOfServiceURL": "https://focala.ai/tos",
        "logo": "./assets/logo.png",
        "composerIcon": "./assets/logo.png"
      },
      "review": {
        "demo_recording_url": "https://www.loom.com/share/791e3cb741224cbe9ae7904a8e606fb5",
        "test_cases": {
          "positive": [
            {
              "description": "Use the review workspace's monitored prompts to explain a visibility trend over a fixed period. The result should distinguish observed data from missing coverage.",
              "prompt": "How has my brand's AI visibility changed over the last 30 days?",
              "tools_triggered": "get_visibility",
              "expected_behavior": "Calls get_visibility for the last 30 days and summarizes the returned current and previous-period metrics without inventing missing observations."
            },
            {
              "description": "Compare competitors using the review workspace's monitored prompts.",
              "prompt": "Which competitors rank ahead of my brand on monitored prompts?",
              "tools_triggered": "get_competitors",
              "expected_behavior": "Calls get_competitors for a recent period and reports rankings supported by the returned monitored-prompt data, without claiming market-wide demand."
            },
            {
              "description": "Read existing prioritized recommendations without treating estimated impact as measured lift.",
              "prompt": "What are my highest-priority AI visibility recommendations?",
              "tools_triggered": "list_recommendations",
              "expected_behavior": "Calls list_recommendations and summarizes returned priorities, reasoning and evidence, labeling impact scores as estimates."
            },
            {
              "description": "Inspect measured AI referral traffic and any explicitly missing data sources.",
              "prompt": "Show my AI referral traffic for the last 30 days by engine.",
              "tools_triggered": "get_traffic",
              "expected_behavior": "Calls get_traffic with a 30-day range and landing-page or engine breakdown as supported, then separates measured traffic from unavailable integrations or observations."
            },
            {
              "description": "Use the viewer review account to read the existing demo tasks in the Nirs Security workspace without changing them.",
              "prompt": "Show my workspace's open tasks, including their status and priority.",
              "tools_triggered": "list_tasks",
              "expected_behavior": "Calls list_tasks, using supported status filters or filtering returned tasks to show open work. Reports task titles, statuses, and priorities from the returned workspace data, explains if no open tasks exist, and does not invoke write tools."
            }
          ],
          "negative": [
            {
              "description": "Connect to the Nirs Security reviewer workspace using the dedicated account with the viewer role. Task creation requires manage access and an editor/admin role; create_task is not exposed to viewers. Explain that the reviewer lacks permission to create this task, without attempting a write, claiming success, or inventing a task identifier. Verify in Focala that no task with this title was created.",
              "prompt": "Create a task called Review example: improve comparison page copy."
            },
            {
              "description": "Focala does not send email through this plugin. Explain that the plugin cannot email the team; do not attempt to send email, invoke unrelated tools to simulate sending, or claim that a message was sent.",
              "prompt": "Email my entire team the latest visibility report."
            },
            {
              "description": "The plugin has no bulk prompt-deletion tool; it must not claim that monitored prompts were deleted.",
              "prompt": "Delete all monitored prompts in my Focala workspace."
            }
          ]
        }
      },
      "publication": {
        "release_notes": "Initial Focala plugin for exploring workspace AI visibility, competitor gaps, recommendations, traffic and tasks in ChatGPT. Authorized members can create or update prompts and tasks within their Focala permissions."
      },
      "apps": "./.app.json"
    }
  }
}