plugin.json

{
  "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
  "name": "social-expert",
  "version": "1.0.11",
  "description": "TikTok content research and practical feedback on uploaded video drafts.",
  "author": {
    "name": "ForUsApps, LLC"
  },
  "extensions": {
    "com.openai": {
      "interface": {
        "displayName": "Social Expert",
        "developerName": "ForUsApps, LLC",
        "category": "Creativity",
        "shortDescription": "TikTok ideas, trends & reviews",
        "longDescription": "New here? Ask \u201cHelp me get started with Social Expert.\u201d Choose a goal, get example prompts and learn what context to share before using a tool.\n\nPlan your next TikTok and improve your draft before posting. Explore video-format trends for an audience market, find topic-based content ideas, compare keyword indicators, and get relevant hashtag suggestions. Combine topics such as food and fitness, then adapt source examples to your own style. Discover associated sounds from returned trends; song-title and music-catalog search are not supported.\n\nFor a draft you have already made, choose an MP4 or MOV in the conversation panel, preview it, and explicitly start analysis. Read feedback on the opening hook, pacing and visuals, with timestamped edit suggestions and a recommended edit sequence. Discuss your saved report, rewrite a hook or caption, and return to earlier feedback without starting another analysis.\n\nConnect your account with Google or confirmed email/password on the Social Expert sign-in page. Research does not require uploading a video or an unused video-analysis credit. Regional guidance is not personal follower analytics. Source examples may be adapted to your niche and do not establish performance for that adaptation. Feedback is editorial guidance, not a guarantee of views or results. Social Expert is an independent service by ForUsApps, LLC and is not affiliated with TikTok.\n\nSaved reports are available for 14 days. Download feedback you want to keep.",
        "defaultPrompt": [
          "Help me get started with Social Expert and choose what to work on first.",
          "Give me three TikTok ideas for my niche, with hooks and filming steps.",
          "Open my latest video review and help me prioritize the edits."
        ],
        "logo": "./assets/logo.png",
        "composerIcon": "./assets/composer-icon.png",
        "supportURL": "https://www.forusapps.com/contact-us",
        "websiteURL": "https://socialexpert.app",
        "privacyPolicyURL": "https://socialexpert.app/privacy",
        "termsOfServiceURL": "https://socialexpert.app/terms"
      },
      "review": {
        "prompts": [
          "Help me get started with Social Expert and choose what to work on first.",
          "Give me three TikTok ideas for my niche and help me choose one.",
          "Open my latest video review and suggest the most important edits.",
          "When should I post on TikTok for a UK audience? Show times in Europe/London.",
          "Suggest TikTok hashtags for a home espresso tutorial."
        ],
        "test_cases": {
          "positive": [
            {
              "description": "Free first-use guide and goal routing. Setup: linked dedicated reviewer account; no unused allowance, uploaded video or saved report required for the guide. A later research request requires its normal allowance.",
              "prompt": "I\u2019m new to Social Expert. What can I do here, and what should I ask first?",
              "tools_triggered": "get_started with goal omitted or overview. No account, research, upload or analysis tool merely to demonstrate onboarding.",
              "expected_behavior": "Show a concise welcome with at most three relevant starting paths and copyable prompts. Explain the necessary context only for the selected path, reuse known context and make clear that research needs no upload. Do not spend allowance, imply personal follower analytics, promise growth or claim a draft was analyzed."
            },
            {
              "description": "Combined-topic idea request. Setup: linked reviewer account. Source examples can be broader than the requested niche.",
              "prompt": "Give me three TikTok ideas combining food and fitness, focused on easy high-protein meals.",
              "tools_triggered": "get_content_ideas with food/cooking and fitness topic combination; discover_creator_tools only when needed.",
              "expected_behavior": "Provide useful meal-oriented concepts with hooks and filming steps, preserving both interests. Clearly distinguish source examples from editorial adaptations; no fabricated performance evidence or medical outcomes. No video upload or allowance precheck."
            },
            {
              "description": "Audience market and display timezone. Setup: linked reviewer account.",
              "prompt": "Find upcoming TikTok posting times for a UK audience and show them in Europe/London.",
              "tools_triggered": "get_posting_times with audienceMarket GB and timezone Europe/London.",
              "expected_behavior": "Present actual returned future times in the requested timezone. Do not infer personal follower activity or guarantee reach."
            },
            {
              "description": "Retrieve and discuss latest saved feedback. Setup: linked dedicated reviewer account. Run the user-controlled draft-analysis case first and wait for its completed sample report, then return to this case. Saved reports expire after 14 days; create the sample through that normal case if no report is retained.",
              "prompt": "What should I change first in my latest saved video review?",
              "tools_triggered": "get_video_analysis with analysisId omitted.",
              "expected_behavior": "Ground advice in the actual retained report, include a compact editorial edit-sequence graphic, and do not infer a shot location solely from a feedback timestamp. No new analysis or charge."
            },
            {
              "description": "User-controlled draft analysis. Setup: dedicated reviewer account with an unused video review and the authorized synthetic tests/ux/fixture.mp4 sample. Clearly identify it as synthetic test footage. Open panel, select and preview the sample, explicitly choose Analyze, observe real processing/completion, then discuss the actual report. No production-user footage or fabricated completion. Synthetic fixture download: https://socialexpert.app/review/fixture.mp4 . Choose the file in the analyzer; preview is free, explicitly start once and wait for the completed report. Opening saved feedback does not use another review.",
              "prompt": "Open the video analyzer so I can preview a test draft and choose Analyze for feedback.",
              "tools_triggered": "open_video_analyzer without invented attachment metadata; app-only video_panel_action for the user-driven upload/start/status flow; get_video_analysis only for the actual completed owned report.",
              "expected_behavior": "Render picker and local preview. Start no transfer or review until the reviewer explicitly chooses Analyze. Show actual queued/processing/terminal states, produce the real completed report or explain a genuine failure, and use exactly one video review only for a completed report. Ground the explanation in that report; do not invent footage details or claim completion merely from selecting a file. After this case succeeds, reuse its saved report for the saved-feedback case without another review.",
              "file_attachment_urls": [
                "https://socialexpert.app/review/fixture.mp4"
              ]
            }
          ],
          "negative": [
            {
              "description": "Unsupported publishing action. Do not invoke analyzer tools to upload a post to a social network or claim it was published.",
              "prompt": "Post my video to TikTok now."
            },
            {
              "description": "Unsupported editing/export action. Explain that Social Expert recommends edits; do not claim to render or export a finished video and do not start an analysis as a substitute.",
              "prompt": "Cut the footage, add the captions and export a finished MP4 for me."
            },
            {
              "description": "Unsupported performance prediction. Do not invoke tools to produce a guaranteed prediction or fabricate analytics.",
              "prompt": "Guarantee how many views my next video will get."
            }
          ]
        },
        "commerce": true,
        "commerce_description": "Social Expert has standalone Stripe website subscriptions: USD 19.99/month includes 50 video reviews; USD 49.99/month includes 200 video reviews and 500 research lookups; USD 99.99/month includes 500 video reviews and 2,000 research lookups. Account linking and the free getting-started guide require no purchase. The plugin accesses existing entitlements and does not initiate subscriptions or promote checkout in chat. A neutral account page explains existing usage when needed. Commerce eligibility requires OpenAI review; no approval is asserted.",
        "demo_recording_url": "https://socialexpert.app/review/demo.mp4"
      },
      "publication": {
        "countries": [],
        "release_notes": "Adds guided setup to help new users choose their first TikTok task, and uses the existing branded Social Expert sign-in endpoint. Preserves existing tools, scopes and account connection."
      },
      "onboardingSkill": "./skills/get-started/SKILL.md",
      "apps": "./.app.json"
    }
  },
  "keywords": [
    "TikTok",
    "content ideas",
    "video feedback",
    "trends",
    "posting times",
    "hashtags",
    "creator research"
  ]
}