plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "caprail",
  "version": "0.1.10",
  "description": "Analyze website traffic in chat with page views, estimated visitors, AI referrals, agent requests, charts and comparisons.",
  "author": {
    "name": "MAXIMILIAN LEODOLTER"
  },
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Caprail",
        "shortDescription": "Website traffic analytics",
        "longDescription": "Caprail is a website traffic analytics tool for website owners and developers. Analyze recorded traffic in chat to understand how people and AI agents reach and use your website. View recorded page views, estimated unique visitors, and agentic/chat requests. Identify traffic referred by AI sources, inspect visited pages, compare periods, and explore daily trends. Filter and rank results by page path, country, source, device, browser, provider, or referrer.\n\nShow results as metric cards, comparison cards, line charts, ranked breakdowns, or multi-series charts. The presentation tool can also display ordered conversion funnels when a connected, authorized data source supplies the required cohort counts; Caprail page totals alone do not provide funnel data.\n\nConnect your Caprail account to analyze your own sites and check when requests were last received. In a coding agent with access to your website codebase, use the installation skill to create a site and integrate event collection.\n\nVisitor counts are estimates derived from IP address and user agent. Page views are explicitly recorded events; agent requests are measured separately. Interactive components require a compatible host. Text and structured results remain available.",
        "developerName": "MAXIMILIAN LEODOLTER",
        "category": "Data & Analytics",
        "capabilities": [
          "Interactive"
        ],
        "defaultPrompt": "Use Caprail to analyze humans referred by AI sources and the paths they visited.",
        "logo": "assets/logo.png",
        "composerIcon": "assets/logo.png",
        "websiteURL": "https://www.caprail.dev/",
        "supportURL": "https://www.caprail.dev/support",
        "privacyPolicyURL": "https://www.caprail.dev/privacy",
        "termsOfServiceURL": "https://www.caprail.dev/terms"
      },
      "review": {
        "commerce": false,
        "commerce_description": "No payments or purchases through the plugin.",
        "test_cases": {
          "positive": [
            {
              "description": "Discover account-owned sites. Requires a dedicated reviewer account owning a site named caprail-test with domain caprail-test.vercel.app and synthetic pageviews/agent requests from October 1 through October 3, 2026, including ChatGPT source values and multiple paths. Reviewer access and fixture preparation are pending; not run against a reviewer account.",
              "prompt": "Which sites can I analyze with Caprail?",
              "tools_triggered": "list_sites",
              "expected_behavior": "List only the sites returned for the signed-in account, including the prepared fixture. Do not expose ingest keys or invent sites."
            },
            {
              "description": "Read traffic totals for an explicit window. Requires a dedicated reviewer account owning a site named caprail-test with domain caprail-test.vercel.app and synthetic pageviews/agent requests from October 1 through October 3, 2026, including ChatGPT source values and multiple paths. Reviewer access and fixture preparation are pending; not run against a reviewer account.",
              "prompt": "Show page views, estimated unique visitors, and agent requests for caprail-test.vercel.app from October 1 through October 3, 2026, in UTC.",
              "tools_triggered": "list_sites, traffic_explorer",
              "expected_behavior": "Resolve the fixture ID from list_sites. Call traffic_explorer with site set to that ID, from 2026-10-01T00:00:00Z, to 2026-10-04T00:00:00Z, timezone UTC, view overview and detail summary. Report summary.pageviews.current, summary.estimatedVisitors.current and summary.agentRequests.current from the result. Explain the measurement coverage and estimated visitor identity; do not substitute raw requests for pageviews or sum daily visitors."
            },
            {
              "description": "Filter human referral traffic and rank visited page paths. Requires a dedicated reviewer account owning a site named caprail-test with domain caprail-test.vercel.app and synthetic pageviews/agent requests from October 1 through October 3, 2026, including ChatGPT source values and multiple paths. Reviewer access and fixture preparation are pending; not run against a reviewer account.",
              "prompt": "Which pages received visitors from ChatGPT on caprail-test.vercel.app from October 1 through October 3, 2026, in UTC? Show estimated visitor counts by page.",
              "tools_triggered": "list_sites, traffic_explorer",
              "expected_behavior": "Resolve the fixture ID. Call traffic_explorer with from 2026-10-01T00:00:00Z, to 2026-10-04T00:00:00Z, timezone UTC, source ChatGPT, view breakdown, metric visitors, dimension path and detail full. Use returned path breakdown visitor counts and report truncatedDimensions when relevant. These are visited-page paths, not session landing pages; do not sum path visitors into a unique site total or invent later journeys."
            },
            {
              "description": "Show a daily visitor trend and compare the previous equal-duration window. Requires a dedicated reviewer account owning a site named caprail-test with domain caprail-test.vercel.app and synthetic pageviews/agent requests from October 1 through October 3, 2026, including ChatGPT source values and multiple paths. Reviewer access and fixture preparation are pending; not run against a reviewer account.",
              "prompt": "Show the daily estimated visitor trend for caprail-test.vercel.app from October 1 through October 3, 2026, in UTC, and show a comparison card for its total versus the previous period.",
              "tools_triggered": "list_sites, traffic_explorer, render_analytics",
              "expected_behavior": "Resolve the fixture ID. Call traffic_explorer with from 2026-10-01T00:00:00Z, to 2026-10-04T00:00:00Z, timezone UTC, view trend, metric visitors and detail summary. Show returned current-period daily visitors in the chart when the host supports it; otherwise give the returned daily data and explain the rendering limitation. Read the period total and previous-period change from summary.estimatedVisitors, with previous boundaries 2026-09-28T00:00:00Z through 2026-10-01T00:00:00Z. Do not sum daily visitors into the total or report a percent change when the returned baseline is zero. Then call render_analytics with view comparison, a title, period including UTC, sources containing Caprail, and metrics with label Estimated unique visitors, unit visitors, value and previous copied from summary.estimatedVisitors.current and .previous. Include a note that visitors are estimated and distinct across each full window. Do not manufacture data or percentage change. Return the comparison component where the host supports it, or explain the rendering limitation and report the actual values."
            },
            {
              "description": "Report observed request freshness without claiming complete collection health. Requires a dedicated reviewer account owning a site named caprail-test with domain caprail-test.vercel.app and synthetic pageviews/agent requests from October 1 through October 3, 2026, including ChatGPT source values and multiple paths. Reviewer access and fixture preparation are pending; not run against a reviewer account.",
              "prompt": "Has caprail-test.vercel.app received requests recently?",
              "tools_triggered": "list_sites, tracking_status",
              "expected_behavior": "Resolve the fixture ID and call tracking_status with site set to it. Report the returned state, checkedAt and lastReceivedAt; a null timestamp means never observed. Explain that this checks recorded request receipts and does not establish pageview collection, installation completeness, delivery health or quota availability."
            }
          ],
          "negative": [
            {
              "description": "Revenue analysis is unsupported; explain the limitation without calling analytics tools or inventing revenue.",
              "prompt": "How much revenue did each AI source generate for my site?"
            },
            {
              "description": "Advertising actions are unsupported; do not invoke Caprail tools to purchase ads.",
              "prompt": "Buy ads to double my Caprail traffic tomorrow."
            },
            {
              "description": "Personal visitor identification is unsupported; do not call analytics tools to retrieve personal contact information.",
              "prompt": "Give me the names and email addresses of everyone ChatGPT referred to my site."
            }
          ]
        },
        "demo_recording_url": "https://www.caprail.dev/review/caprail-demo-2026-10-04.mp4"
      },
      "publication": {
        "countries": [],
        "release_notes": "Categorize Caprail under Data & Analytics and clarify its main purpose as website traffic analytics. Preserve the demo recording, analytics components, installation instructions and review test cases."
      },
      "apps": "./.app.json"
    }
  }
}