plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "petalie",
  "version": "1.0.1",
  "description": "Petalie gets the public numbers of a TikTok account from its username: the profile, the newest 20 posts with views, likes, comments and shares, the typical and best post, posting frequency, and short notes on what stands out, with a link to the account's page on petalie.ai.",
  "author": {
    "name": "Petalie Technologies Inc.",
    "email": "support@petalie.ai",
    "url": "https://petalie.ai"
  },
  "homepage": "https://petalie.ai/connectors",
  "license": "Proprietary",
  "keywords": [
    "tiktok",
    "social media",
    "analytics",
    "creators",
    "content performance"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Petalie",
        "shortDescription": "Public TikTok account stats",
        "longDescription": "Petalie gets the public numbers of a TikTok account from its username or profile link. It returns the profile (followers, following, total likes, post count), the newest 20 posts with their views, likes, comments, shares, length and caption, and numbers computed from them: the typical views per post, the best and lowest post, how often the account posts, engagement per 1,000 views, and which posts appear to be paid promotion. It adds short notes on what stands out in those numbers and a link to the account's page on petalie.ai.\n\nUse it for your own account or for another public account you want to understand. It reads public data only: it does not watch or analyze the videos themselves, needs no password, has no access to private analytics, and never posts or changes anything. TikTok only, with a daily limit of reads per person.",
        "developerName": "Petalie Technologies Inc.",
        "category": "Data & Analytics",
        "capabilities": [
          "Get a public TikTok account's profile and recent post numbers",
          "Compare an account's best post with its typical one",
          "Summarize posting frequency and engagement per 1,000 views"
        ],
        "websiteURL": "https://petalie.ai",
        "supportURL": "https://petalie.ai/contact",
        "privacyPolicyURL": "https://petalie.ai/privacy",
        "termsOfServiceURL": "https://petalie.ai/terms",
        "defaultPrompt": [
          "How are my recent TikTok posts doing?",
          "Compare my best TikTok post with my typical one",
          "How often does a competitor post on TikTok, and what views do they get?"
        ],
        "brandColor": "#AF69EE",
        "brandColorDark": "#B67AF0",
        "composerIcon": "./assets/icon.png",
        "composerIconDark": "./assets/icon-dark.png",
        "logo": "./assets/logo.png",
        "logoDark": "./assets/logo-dark.png",
        "screenshots": [
          "./assets/screenshot-1.png",
          "./assets/screenshot-2.png",
          "./assets/screenshot-3.png"
        ]
      },
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Stats for the user's own TikTok account",
              "prompt": "Get the stats for my TikTok account @duolingo",
              "tools_triggered": "get_tiktok_account_stats",
              "expected_behavior": "Calls get_tiktok_account_stats with handle duolingo and relation own. Returns the profile, the newest posts with their views, the typical and best post and short notes, shown in the card with a link to the account's page on petalie.ai. The reply uses the numbers as given and does not describe what happens inside any video."
            },
            {
              "description": "Low views, explained from the numbers",
              "prompt": "My TikTok @duolingo gets low views. What do the numbers show?",
              "tools_triggered": "get_tiktok_account_stats",
              "expected_behavior": "Reads the account and explains what the numbers show: typical views against the best post, how often it posts, and engagement per 1,000 views. The reply uses the numbers as given and does not describe what happens inside any video."
            },
            {
              "description": "Another public account",
              "prompt": "How is @gymshark doing on TikTok lately?",
              "tools_triggered": "get_tiktok_account_stats",
              "expected_behavior": "Calls get_tiktok_account_stats with handle gymshark and relation watch. Talks about their account (not 'your'), naming their best post against their typical one."
            },
            {
              "description": "Profile link instead of a username",
              "prompt": "Look at this TikTok account: https://www.tiktok.com/@nba",
              "tools_triggered": "get_tiktok_account_stats",
              "expected_behavior": "Reads the username nba from the link and returns that account's numbers and card."
            },
            {
              "description": "French-speaking user",
              "prompt": "Montre-moi les chiffres de mon compte TikTok @lequipe",
              "tools_triggered": "get_tiktok_account_stats",
              "expected_behavior": "Calls get_tiktok_account_stats with handle lequipe and language fr. Answers in French with the numbers as given and the French petalie.ai link."
            }
          ],
          "negative": [
            {
              "description": "Instagram is not supported: the tool reads TikTok only, so it should not be called",
              "prompt": "Get the stats for my Instagram account @duolingo"
            },
            {
              "description": "Writing content from scratch is outside the tool's purpose",
              "prompt": "Write me 10 hooks for a coffee TikTok"
            },
            {
              "description": "An uploaded screenshot is not a public account the tool can read",
              "prompt": "Here's a screenshot of my TikTok analytics, what's wrong?"
            }
          ]
        },
        "commerce": false,
        "commerce_description": "Petalie does not sell anything inside ChatGPT.",
        "demo_recording_url": "https://petalie.ai/demo/petalie-in-chatgpt.mp4"
      },
      "publication": {
        "release_notes": "1.0.1 addresses the 15 Oct 2026 review. The tool is renamed get_tiktok_account_stats and its description now states plainly what it returns, when to use it and its limits. Instagram and Facebook were removed from the tool (it could only return a link for them). The server instructions and result text no longer steer replies toward the website.",
        "translations": {
          "fr-FR": {
            "subtitle": "Stats de compte TikTok public",
            "description": "Petalie r\u00e9cup\u00e8re les chiffres publics d'un compte TikTok \u00e0 partir de son nom ou du lien du profil : le profil (abonn\u00e9s, abonnements, total de j'aime, nombre de publications), les 20 derni\u00e8res publications avec leurs vues, j'aime, commentaires, partages, dur\u00e9e et l\u00e9gende, et les chiffres calcul\u00e9s \u00e0 partir d'elles : les vues typiques par publication, la meilleure et la plus faible, le rythme de publication, l'engagement pour 1 000 vues et les publications qui semblent sponsoris\u00e9es. Elle ajoute de courtes notes sur ce qui ressort et un lien vers la page du compte sur petalie.ai. Elle ne lit que des donn\u00e9es publiques : elle ne regarde pas les vid\u00e9os, ne demande aucun mot de passe et ne publie jamais rien. TikTok uniquement, avec une limite de lectures par personne et par jour."
          }
        }
      },
      "apps": "./.app.json"
    }
  }
}