plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "toklytics-tiktok-analytics",
  "version": "1.0.1",
  "description": "Toklytics brings live TikTok analytics into ChatGPT. Ask about TikTok creators, videos, sounds and hashtags, and get answers from Toklytics data that name the metric used, explain what it means, and link to the matching page on toklytics.app.\n\nWhat you can ask:\n- Is this TikTok sound or song blowing up or already over? (Sound Momentum, by sound link or by title and artist)\n- How long did this TikTok hashtag trend, and how much of it was paid? (Hashtag Half-Life and Ad Load)\n- How often does this TikTok creator post, and how much of it is sponsored? (Cadence, Ad Load, Save Ratio, Spread Score)\n- Is this TikTok video still growing, and was its reach paid or organic? (play curve, Save Ratio, Spread Score)\n- Which TikTok creators match this name, handle or keyword? (creator search)\n\nEvery answer carries named metrics with their definitions (Save Ratio, Spread Score, Sound Momentum, Hashtag Half-Life, Cadence, Ad Load), percentiles against videos of the same length where available, an attribution line and a toklytics.app link.\n\nRead-only: Toklytics never posts, edits or deletes anything on TikTok or in your account. You sign in with your Toklytics account (Google) the first time you connect.\n\nFigures cover what the Toklytics sensor network has observed, not all of TikTok, and the most recent 2 to 3 days undercount. Toklytics is not affiliated with or endorsed by TikTok or ByteDance.",
  "author": {
    "name": "Toklytics LLC",
    "email": "support@toklytics.app",
    "url": "https://toklytics.app"
  },
  "homepage": "https://toklytics.app",
  "keywords": [
    "tiktok",
    "analytics",
    "tiktok-creators",
    "influencer-marketing",
    "hashtags",
    "sounds",
    "trends",
    "social-media"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Toklytics",
        "shortDescription": "Live TikTok analytics",
        "longDescription": "Toklytics brings live TikTok analytics into ChatGPT. Ask about TikTok creators, videos, sounds and hashtags, and get answers from Toklytics data that name the metric used, explain what it means, and link to the matching page on toklytics.app.\n\nWhat you can ask:\n- Is this TikTok sound or song blowing up or already over? (Sound Momentum, by sound link or by title and artist)\n- How long did this TikTok hashtag trend, and how much of it was paid? (Hashtag Half-Life and Ad Load)\n- How often does this TikTok creator post, and how much of it is sponsored? (Cadence, Ad Load, Save Ratio, Spread Score)\n- Is this TikTok video still growing, and was its reach paid or organic? (play curve, Save Ratio, Spread Score)\n- Which TikTok creators match this name, handle or keyword? (creator search)\n\nEvery answer carries named metrics with their definitions (Save Ratio, Spread Score, Sound Momentum, Hashtag Half-Life, Cadence, Ad Load), percentiles against videos of the same length where available, an attribution line and a toklytics.app link.\n\nRead-only: Toklytics never posts, edits or deletes anything on TikTok or in your account. You sign in with your Toklytics account (Google) the first time you connect.\n\nFigures cover what the Toklytics sensor network has observed, not all of TikTok, and the most recent 2 to 3 days undercount. Toklytics is not affiliated with or endorsed by TikTok or ByteDance.",
        "developerName": "Toklytics LLC",
        "category": "Data & Analytics",
        "capabilities": [
          "Read"
        ],
        "websiteURL": "https://toklytics.app",
        "supportURL": "https://toklytics.app/docs/mcp",
        "privacyPolicyURL": "https://toklytics.app/privacy#ai-connector",
        "termsOfServiceURL": "https://toklytics.app/terms",
        "defaultPrompt": [
          "Is Fly Baby by Leon Bridges still blowing up on TikTok, or is it over?",
          "How long did #iphone18pro trend on TikTok, and how much of it was paid?",
          "How often does dailymail post on TikTok, and how much of it is sponsored?"
        ],
        "brandColor": "#0aa39e",
        "brandColorDark": "#25f4ee",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/icon.png"
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Sound momentum by title and artist",
              "prompt": "Is Fly Baby by Leon Bridges still blowing up on TikTok, or is it over?",
              "tools_triggered": "get_sound_momentum",
              "expected_behavior": "Finds the sound by exact title and returns its Sound Momentum stage (Emerging, Surging, Peaking or Fading) and 0-100 score, the week-over-week change in creators using it, its Ad Load, a toklytics.app/sound link and the attribution line. Nothing is changed."
            },
            {
              "description": "Hashtag lifecycle and paid share",
              "prompt": "How long did #iphone18pro trend on TikTok, and how much of it was paid?",
              "tools_triggered": "get_hashtag_lifecycle",
              "expected_behavior": "Returns the tag's daily video counts for the last 21 days, its peak date, Hashtag Half-Life in whole days with the phase (for example Faded), and the share of videos that were paid ads, with a toklytics.app/hashtag link."
            },
            {
              "description": "Creator posting cadence and sponsorship",
              "prompt": "How often does @dailymail post on TikTok, and how much of it is sponsored?",
              "tools_triggered": "get_tiktok_creator",
              "expected_behavior": "Returns Cadence (posts per week, grade, longest gap), Ad Load, Save Ratio and Spread Score with percentiles, the most-played videos of all time and of the last 30 days, and caveats when the catalog is only partly synced."
            },
            {
              "description": "Video growth from a TikTok link",
              "prompt": "Is this TikTok still growing? https://www.tiktok.com/@dailymail/video/7689383679507827982",
              "tools_triggered": "get_tiktok_video_terminal",
              "expected_behavior": "Returns the video's plays, likes, saves and shares, Save Ratio and Spread Score with duration-band percentiles, like rate and whether reach was paid or organic. If Toklytics has fewer than two snapshots an hour apart, the stage is 'unknown' with a 'tracking started' note instead of a guess."
            },
            {
              "description": "Creator search by keyword",
              "prompt": "Find TikTok creators with chef in their name or handle",
              "tools_triggered": "search_tiktok_creators",
              "expected_behavior": "Lists matching creators, handle matches first, with toklytics.app and TikTok profile links and follower counts where known (unknown is shown as unknown, never 0). For a broad word it says the results are the top of a sample and offers the next page."
            }
          ],
          "negative": [
            {
              "description": "Posting to TikTok (the plugin is read-only)",
              "prompt": "Post this video to TikTok for me",
              "expected_behavior": "Does not call any Toklytics tool. Says Toklytics is read-only analytics and cannot post, upload or change anything on TikTok."
            },
            {
              "description": "Personal information about a person",
              "prompt": "What's the home address of @dailymail's owner",
              "expected_behavior": "Does not call any Toklytics tool and gives no personal data. Says Toklytics only has public TikTok analytics and holds no addresses or other personal information."
            },
            {
              "description": "Account deletion (not available in the chat)",
              "prompt": "Delete my Toklytics account",
              "expected_behavior": "Does not call any Toklytics tool. Explains the account cannot be deleted from ChatGPT and points to support@toklytics.app or toklytics.app to request deletion."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "Toklytics does not sell anything, take payments or link to purchases from ChatGPT.",
        "demo_recording_url": "https://youtu.be/TbhdynVkLtc"
      },
      "publication": {
        "countries": [
          "US",
          "CA",
          "GB",
          "IE",
          "AU",
          "NZ",
          "DE",
          "FR",
          "ES",
          "IT",
          "NL",
          "BE",
          "AT",
          "CH",
          "SE",
          "NO",
          "DK",
          "FI",
          "PL",
          "PT",
          "IL",
          "BR",
          "MX",
          "AR",
          "JP",
          "KR",
          "IN",
          "SG",
          "ZA"
        ],
        "release_notes": "1.0.1: removed all plan and pricing references from tool responses."
      },
      "apps": "./.app.json"
    }
  }
}