plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "viralswipefile",
  "version": "1.2.0",
  "description": "Know what to post next on TikTok and Instagram Reels. Your AI agent searches Viral Swipe File, a curated library of viral videos filed by niche and format, and writes hooks and content ideas from real posts instead of a blank prompt. Each video comes with its hook, views and viral factor (its views against the account's usual), and a link to watch it.",
  "author": {
    "name": "Viral Swipe File",
    "email": "hello@viralswipefile.com",
    "url": "https://viralswipefile.com"
  },
  "homepage": "https://viralswipefile.com/mcp",
  "repository": "https://github.com/viralswipefile/viralswipefile-plugin",
  "license": "MIT",
  "keywords": [
    "viral hooks",
    "content ideas",
    "viral formats",
    "tiktok",
    "instagram reels",
    "ugc hooks",
    "short-form video",
    "social media manager",
    "swipe file",
    "viral videos"
  ],
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Viral Swipe File",
        "shortDescription": "Know what to post: viral hooks",
        "longDescription": "Know what to post next, for every client. Viral Swipe File is a curated library of TikToks and Instagram Reels that got far more views than their account usually does, each filed under a niche and one or more formats, with its hook. Connect it and your AI agent does the scrolling: ask what to post for a fitness client, or for viral hooks in finance, and it reads real videos from the library, names the hooks and formats that repeat, and writes new ones for your product or account in those patterns.\n\nBuilt for social media managers juggling several clients, creators, UGC teams and app marketers.\n\nSearch by topic or creator, or filter by niche, format (selfie with background, face close-up, story in slideshow and more), platform, creator gender, posting window and minimum viral factor. Viral factor is views against the account's usual: x10 means ten times what that account normally gets, so a small account's breakout ranks next to a big one's. Open any video for its hook, caption, views, engagement rate, niche, formats and creator. Your team's saved videos are available too, so they can turn into a brief.\n\nEvery figure comes from the library's own records, and every example links to its page on viralswipefile.com, which links the original post. Your agent is told to keep its own hooks apart from the quoted ones.\n\nThe library is a collection of past viral videos, not a live trend feed or an analytics tool for your own account. It covers TikTok and Instagram Reels only, not YouTube or long-form video. It links to videos rather than downloading them. Every tool is read-only: it cannot save, remove or post anything. A Viral Swipe File account is required to connect.",
        "developerName": "Viral Swipe File",
        "category": "Business & Operations",
        "capabilities": [
          "Content ideas from viral videos in your niche",
          "Viral hooks with their views and viral factor",
          "Which formats work in a niche, counted",
          "Search TikToks and Reels by niche, format and creator",
          "New hooks and video ideas written from real examples",
          "List niches and formats with their video counts",
          "Your team's saved videos"
        ],
        "websiteURL": "https://viralswipefile.com",
        "supportURL": "https://viralswipefile.com/contact",
        "privacyPolicyURL": "https://viralswipefile.com/privacy",
        "termsOfServiceURL": "https://viralswipefile.com/terms",
        "defaultPrompt": [
          "What should I post this week for a fitness client? Base each idea on a viral video",
          "Find viral hooks in finance and write 5 for my budgeting app",
          "Which video formats work best for astrology on TikTok?"
        ],
        "brandColor": "#000000",
        "brandColorDark": "#00FF94",
        "composerIcon": "./assets/icon.png",
        "logo": "./assets/logo.png"
      },
      "onboardingSkill": "./skills/get-started/SKILL.md",
      "review": {
        "test_cases": {
          "positive": [
            {
              "description": "Find the most viral videos in one niche",
              "prompt": "Show me the 10 most viral fitness videos and their hooks.",
              "tools_triggered": "list_niches, list_videos",
              "expected_behavior": "Resolves the fitness niche, lists up to 10 videos sorted by viral factor with each video's hook, platform, creator, views and viral factor, explains that viral factor is views relative to the account's usual, and links each video's viralswipefile.com page."
            },
            {
              "description": "Compare formats within a niche",
              "prompt": "Which video formats work best for astrology videos on TikTok?",
              "tools_triggered": "search_library, list_videos",
              "expected_behavior": "Resolves the astrology niche, reads its top TikToks by viral factor, groups them by format with how many videos in the sample use each, names the best example of each format with its link, and says the answer describes the library's sample rather than the whole platform."
            },
            {
              "description": "Read one video in full",
              "prompt": "Open the most viral face close-up video in the library and break down why its hook works.",
              "tools_triggered": "list_videos, get_video",
              "expected_behavior": "Finds the top face close-up video by viral factor, reads it with get_video, quotes its hook and stats (views, viral factor, engagement rate) as returned, and analyses the hook without inventing figures; links the video's page."
            },
            {
              "description": "Write hooks modelled on viral examples",
              "prompt": "I run a budgeting app. Write 5 TikTok hooks based on viral finance videos.",
              "tools_triggered": "search_library, list_videos",
              "expected_behavior": "Reads viral finance videos, names the hook patterns they share with a linked example of each, then writes 5 new hooks for a budgeting app in those patterns, clearly marked as new writing rather than library data."
            },
            {
              "description": "Read the signed-in team's saved videos",
              "prompt": "Show me the videos my team has saved.",
              "tools_triggered": "list_saved_videos",
              "expected_behavior": "Lists the videos saved to the signed-in account's team with their hook, creator, views and viral factor and links, or says no videos are saved yet; does not offer to add or remove saved videos."
            }
          ],
          "negative": [
            {
              "description": "Live trends are out of scope",
              "prompt": "What is trending on TikTok right now, today?",
              "expected_behavior": "Explains that the library is a collection of past viral videos, not a live trend feed, and offers the most viral videos in the library for the user's niche instead."
            },
            {
              "description": "YouTube is out of scope",
              "prompt": "Find the most viral YouTube videos about cooking.",
              "expected_behavior": "States that the library covers TikTok and Instagram Reels only and offers viral cooking TikToks or Reels instead."
            },
            {
              "description": "Write actions are not supported",
              "prompt": "Save the top fitness video to my board and delete my other saved videos.",
              "expected_behavior": "Explains that the plugin is read-only and cannot save or remove videos, and points to viralswipefile.com to change saved videos."
            }
          ]
        },
        "commerce": false,
        "commerce_description": "This plugin does not sell products or process payments.",
        "demo_recording_url": "https://drive.google.com/file/d/1oy8MspKTyQE3BTuwpHmNvHOPpFgB7ZfK/view?usp=sharing"
      },
      "publication": {
        "release_notes": "1.2.0: Rewrites the listing, the skills and the suggested prompts around the job they do: knowing what to post, with viral hooks and formats by niche. Adds a what-to-post skill. MCP tools, sign-in and access are unchanged."
      },
      "apps": "./.app.json"
    }
  }
}