plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "swell",
  "version": "1.0.0",
  "description": "Your social media growth data, read-only: follower history, posts and views, post snapshots over time and grouped statistics for the Instagram, TikTok, YouTube and X profiles you track.",
  "author": {
    "name": "wavehappy",
    "email": "hello@wavehappy.art",
    "url": "https://swell.wavehappy.art"
  },
  "homepage": "https://swell.wavehappy.art",
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Swell",
        "logo": "./assets/logo.png",
        "logoDark": "./assets/logo-dark.png",
        "composerIcon": "./assets/composer-icon.png",
        "composerIconDark": "./assets/composer-icon-dark.png",
        "shortDescription": "Your social media growth data",
        "longDescription": "Swell is a growth tracker for creators. It records the followers, posts and post views of the Instagram, TikTok, YouTube and X profiles you track, several times a day, and keeps the full history.\n\nConnected to ChatGPT, Swell gives read-only access to that stored history: every follower reading, every post with its views, likes, comments, shares and saves, each post's snapshots over time, and grouped statistics computed over all of it, for example average views by weekday or followers by month. ChatGPT does its own analysis of the data; Swell supplies the numbers and what each field means.\n\nSwell reads and stores public profile and post counts on its own schedule. ChatGPT reads Swell's stored data only; it never contacts Instagram, TikTok, YouTube or X through Swell, and the connection cannot change anything in your account.\n\nTracked profiles, plan and account settings are managed on the Swell website. A Swell account is required.",
        "developerName": "wavehappy",
        "category": "Productivity",
        "capabilities": [
          "Read follower history",
          "Read posts and views",
          "Read post snapshots",
          "Grouped statistics"
        ],
        "websiteURL": "https://swell.wavehappy.art",
        "supportURL": "https://swell.wavehappy.art/support",
        "privacyPolicyURL": "https://swell.wavehappy.art/privacy",
        "termsOfServiceURL": "https://swell.wavehappy.art/terms",
        "defaultPrompt": [
          "What data does Swell have for me?",
          "How have my Instagram followers changed this month?",
          "Which of my posts got the most views this quarter?"
        ]
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Summary of the account's data",
              "prompt": "What data does Swell have for me?",
              "tools_triggered": "describe_data",
              "expected_behavior": "Summarises the tracked handles, their date ranges, reading counts and plan cadence. No internal ids appear."
            },
            {
              "description": "Follower change over a range",
              "prompt": "How have my Instagram followers changed over the last 30 days?",
              "tools_triggered": "get_readings",
              "expected_behavior": "Reads the Instagram handle's readings for the last 30 days and reports the start and end counts and the change."
            },
            {
              "description": "Top posts by views",
              "prompt": "Which of my TikTok videos from the last three months got the most views?",
              "tools_triggered": "get_posts",
              "expected_behavior": "Lists the TikTok posts from the last three months with the most views, with their views and links."
            },
            {
              "description": "Grouped statistics",
              "prompt": "On which weekday do my Instagram reels get the most views on average?",
              "tools_triggered": "aggregate",
              "expected_behavior": "Computes average views grouped by weekday over the Instagram posts and names the weekday with the highest average."
            },
            {
              "description": "One post's views over time",
              "prompt": "Show how the views on my most recent YouTube video grew over its first week.",
              "tools_triggered": "get_posts, get_post_snapshots",
              "expected_behavior": "Finds the latest YouTube post, then reads its snapshots and describes its views at each snapshot."
            }
          ],
          "negative": [
            {
              "description": "A request to change data; every tool is read-only",
              "prompt": "Delete my TikTok handle from Swell."
            },
            {
              "description": "Another account's data; tools match only the signed-in account's own handles",
              "prompt": "Show me the follower history for @someone_else_entirely."
            },
            {
              "description": "Unrelated to growth data",
              "prompt": "What is the weather in Lisbon today?"
            }
          ]
        },
        "commerce": false,
        "demo_recording_url": "https://drive.google.com/file/d/1n9Lr30euOdAI68nN41qIY_nQUVDhCLS2/view?usp=drive_link"
      },
      "publication": {
        "release_notes": "First release. Read-only access to your Swell growth history in ChatGPT: profile readings, posts with their views and engagement, post snapshots over time, and grouped statistics across all of it, for Instagram, TikTok, YouTube and X."
      },
      "apps": "./.app.json"
    }
  }
}