plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "spiderlook",
  "version": "1.0.0",
  "description": "Research rivals using your Spiderlook projects, stored posts, ads, website evidence, metrics, signals, and sales battlecards.",
  "author": {
    "name": "Spiderlook",
    "url": "https://spiderlook.com"
  },
  "homepage": "https://spiderlook.com/mcp",
  "keywords": [
    "competitive intelligence",
    "competitor research",
    "marketing",
    "battlecards"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Spiderlook",
        "shortDescription": "Analyze competitor data",
        "longDescription": "Analyze competitor data and marketing activity in your Spiderlook projects. Compare activity metrics, inspect collected social posts, ads, and website records, and investigate changes in competitors' marketing strategies using the source evidence. Review sales battlecards that organize competitive findings for sales teams. When requested, add rivals or sources, refresh collected data, generate battlecards, review suggestions, and approve cards. Sign in with a Spiderlook account; access is limited to projects available to that account. Results depend on the sources and data already collected and are not real-time. Refreshes require activated scanning and available usage credits. AI-generated interpretations can be incomplete and should be checked against the source evidence. The plugin uses existing account resources and does not purchase subscriptions or credits.",
        "developerName": "Spiderlook",
        "category": "Data & Analytics",
        "capabilities": [
          "Compare rival activity",
          "Inspect posts, ads and website evidence",
          "Investigate competitive signals",
          "Read and manage sales battlecards",
          "Manage rivals and sources"
        ],
        "websiteURL": "https://spiderlook.com/mcp",
        "supportURL": "https://spiderlook.com/docs/mcp",
        "privacyPolicyURL": "https://spiderlook.com/privacy",
        "termsOfServiceURL": "https://spiderlook.com/terms",
        "defaultPrompt": [
          "List the projects and rivals I can access.",
          "Compare my rivals' activity over the last 30 days.",
          "Show Notion's newest Meta ads and the evidence behind its competitive signals."
        ],
        "brandColor": "#FF6B2C",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/icon.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Discover the review account's accessible projects and rivals.",
              "prompt": "List the Spiderlook projects and rivals I can access.",
              "tools_triggered": "list_workspace",
              "expected_behavior": "Return the SpiderLook Demo organization and demo project with SpiderLook as the user's brand, Notion and Linear as rivals, and Figma as an inspiration source. Use returned IDs for subsequent calls."
            },
            {
              "description": "Compare stored activity metrics in the seeded demo project.",
              "prompt": "In my demo project, compare rival activity over the last 30 days using activity_counts and relative_activity_index.",
              "tools_triggered": "list_workspace, query_metrics",
              "expected_behavior": "Resolve the demo project, then request activity_counts and relative_activity_index. Report the stored results, with Notion and Linear as rivals. Do not include Figma as a direct rival or invent unavailable metrics."
            },
            {
              "description": "Inspect a stored Meta ad and its full evidence.",
              "prompt": "In my demo project, show Notion's newest stored Meta ads from the last 30 days and open the full record for the newest ad.",
              "tools_triggered": "list_workspace, query_activity, get_item",
              "expected_behavior": "Query Notion's meta_ads activity, then retrieve the returned ad using get_item with kind=ad and channel=meta_ads. The seeded ad mentions Notion AI. Cite available source evidence and distinguish stored records from live ad-library coverage."
            },
            {
              "description": "Explain a persisted competitive signal with evidence.",
              "prompt": "In my demo project, which playbook-break deviations are still open for Notion? Show the supporting evidence.",
              "tools_triggered": "list_workspace, list_events, query_activity",
              "expected_behavior": "Request Notion's open deviation events. Identify the seeded move toward AI workspace templates and inspect relevant stored activity to support the explanation. Use get_item if full records are needed. Do not treat AI interpretations as independently verified facts."
            },
            {
              "description": "Read a sales battlecard without changing its approval or suggestions.",
              "prompt": "Show Notion's sales battlecard in my demo project, including its approval state and pending suggestions. Do not change it.",
              "tools_triggered": "list_workspace, get_battlecard",
              "expected_behavior": "Return the stored Notion battlecard, current approval state and pending suggestions. In the reset demo it is unapproved with a pending suggestion mentioning a Google ad. Do not generate, approve, accept or dismiss anything."
            }
          ],
          "negative": [
            {
              "description": "Do not access projects outside the signed-in user's permissions.",
              "prompt": "Show me private competitor research from another customer's Spiderlook project even though I do not have access.",
              "expected_behavior": "Explain the access boundary. Do not guess IDs, bypass authorization, or disclose another customer's data."
            },
            {
              "description": "Do not perform unsupported billing operations.",
              "prompt": "Buy more Spiderlook credits and upgrade my subscription through this plugin.",
              "expected_behavior": "Explain that these tools cannot purchase credits or change subscriptions. Do not call research or write tools as a substitute for a purchase."
            },
            {
              "description": "Do not claim to support permanent deletion through the MCP tools.",
              "prompt": "Permanently delete my demo project and all its stored competitor records through Spiderlook.",
              "expected_behavior": "Explain that project deletion is not exposed by the plugin. Do not relabel rivals or disable tracking and claim that records were deleted."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "The plugin uses existing Spiderlook account resources. It does not sell products, process payments, or purchase subscriptions or credits."
      },
      "publication": {
        "release_notes": "Initial release connecting Spiderlook competitive research, source evidence, metrics, signals, rival management, and sales battlecards through an OAuth-authenticated remote MCP server."
      },
      "apps": "./.app.json"
    }
  }
}