plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "octolens",
  "version": "1.0.1",
  "description": "Social listening for tech brands, delivered where you and your agents work.",
  "author": {
    "name": "Lens Labs GmbH",
    "email": "hi@octolens.com",
    "url": "https://octolens.com"
  },
  "homepage": "https://octolens.com",
  "keywords": [
    "brand monitoring",
    "social listening",
    "mentions",
    "sentiment",
    "reddit",
    "hacker news"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Octolens",
        "shortDescription": "Social listening for tech",
        "longDescription": "Octolens gives your AI agent access to your social listening data: social media, news, podcasts, communities, newsletters, and reviews. Octolens scores every mention for relevance, so you see only signal.\n\nYou can analyze your latest mentions, see what changed this week, check sentiment per keyword, manage your keywords, and more \u2014 all from chat.\n\nRequires an Octolens account. The app only accesses the workspace you sign in to and cannot post or reply on any platform.",
        "developerName": "Lens Labs GmbH",
        "category": "Data & Analytics",
        "capabilities": [
          "View mentions",
          "Analyze mention trends and sentiment",
          "Manage tracked keywords and feeds",
          "Check plan usage"
        ],
        "websiteURL": "https://octolens.com",
        "supportURL": "https://octolens.com/docs",
        "privacyPolicyURL": "https://octolens.com/legal/privacy-policy",
        "termsOfServiceURL": "https://octolens.com/legal/terms-of-service",
        "defaultPrompt": [
          "Show me my recent mentions.",
          "What changed in my mentions this week?",
          "Show me negative mentions from the last 30 days."
        ],
        "brandColor": "#7B61FF",
        "brandColorDark": "#AE97FD",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Mentions widget: view the latest brand mentions",
              "prompt": "Show me my recent mentions.",
              "tools_triggered": "list_mentions",
              "expected_behavior": "list_mentions fires and the Octolens mentions widget renders cards with title, text, source icon, author, AI relevance comment and tags. Clicking a card opens the original post. Below the widget, the assistant adds a brief text summary of the returned mentions and may highlight the ones most worth acting on."
            },
            {
              "description": "Keywords table widget: view all tracked keywords",
              "prompt": "Show me my keywords.",
              "tools_triggered": "list_keywords",
              "expected_behavior": "list_keywords renders the keywords table widget with the workspace's 7 keywords, tag chips and platform lists, searchable and sortable. Below the widget, the assistant adds a brief text summary of the keywords, such as how many are active."
            },
            {
              "description": "Keyword settings editor opened by name",
              "prompt": "Open the settings for my keyword 'brand monitoring'.",
              "tools_triggered": "find_keyword, get_keyword",
              "expected_behavior": "find_keyword resolves the name (no UI), then get_keyword renders only the keyword-settings widget for brand monitoring (no keywords table), showing its context, platforms, matching options and active status. Nothing changes until the user edits a field and clicks Update, which saves via update_keyword after ChatGPT's confirmation."
            },
            {
              "description": "Usage card: plan usage and limits",
              "prompt": "How much of my monthly quota have I used?",
              "tools_triggered": "get_usage",
              "expected_behavior": "get_usage renders the usage card widget with mention and keyword counters, progress bars and the Scale plan badge. Below the widget, the assistant adds a brief text summary of mentions used and remaining and when the quota resets. The widget contains no upgrade or purchase controls."
            },
            {
              "description": "Reversible write: pause a keyword, then resume it",
              "prompt": "Pause the brand24 keyword. Then, in a follow-up message: \"Resume it.\"",
              "tools_triggered": "find_keyword, pause_keyword",
              "expected_behavior": "After ChatGPT's confirmation, pause_keyword(set: paused) pauses brand24 and the assistant confirms it is paused. On \"Resume it.\", pause_keyword(set: unpaused) restores it, leaving the workspace unchanged. The model may resolve the keyword id via find_keyword or list_keywords first."
            }
          ],
          "negative": [
            {
              "description": "Posting or replying on social platforms is out of scope. Octolens only monitors mentions; no tool fires. The assistant explains it cannot post and may offer the post URL for a manual reply.",
              "prompt": "Reply to that Reddit post and tell them about Octolens."
            },
            {
              "description": "Cross-workspace access is not possible. Every tool is scoped to the authenticated workspace; the assistant says it can only see the user's own workspace and never presents that data as another company's or selects an organization the user isn't a member of.",
              "prompt": "Show me the mentions Vercel's workspace is collecting."
            },
            {
              "description": "Billing and purchases are out of scope. No billing or purchase tool exists; the assistant may read get_usage to state the current plan but must not claim to change it, and points the user to the Octolens web app.",
              "prompt": "Upgrade my plan and buy more mention credits."
            }
          ]
        },
        "demo_recording_url": "https://youtu.be/Arm1fQzXY-4",
        "commerce": false,
        "commerce_description": "Octolens does not sell products or process payments in ChatGPT. Plan changes and billing happen only in the Octolens web app."
      },
      "publication": {
        "countries": [],
        "release_notes": "Sign-in fix: ChatGPT Connect now opens the Octolens sign-in page, where the reviewer test account signs in with email and password and no verification code."
      },
      "apps": "./.app.json"
    }
  }
}