.codex-plugin/plugin.json

{
  "author": {
    "name": "SocialAPI"
  },
  "description": "SocialAPI is a unified social media inbox and publishing API. Read and reply to comments, direct messages, reviews and mentions across Instagram, Facebook, Threads, TikTok, YouTube, X, LinkedIn profiles and Pages, Google Business Profile, Pinterest, WhatsApp, Telegram, Zalo and Bluesky, and answer App Store reviews through App Store Connect. Then draft, validate, schedule and publish posts to your social networks, without writing a separate integration for each one.",
  "keywords": [
    "social media",
    "social media marketing",
    "smm",
    "instagram",
    "facebook",
    "youtube",
    "whatsapp",
    "pinterest",
    "tiktok",
    "x",
    "twitter",
    "linkedin",
    "telegram",
    "threads",
    "bluesky",
    "zalo",
    "google business profile",
    "google my business",
    "post",
    "schedule",
    "publish",
    "inbox",
    "comments",
    "dms",
    "reviews",
    "reply",
    "mentions",
    "moderation",
    "reels",
    "stories",
    "shorts",
    "carousel",
    "hashtags",
    "caption",
    "insights",
    "analytics",
    "engagement",
    "reach",
    "followers",
    "automation",
    "social media scheduler",
    "post scheduler",
    "content calendar",
    "social media calendar",
    "cross-posting",
    "auto posting",
    "instagram scheduler",
    "tiktok scheduler",
    "twitter scheduler",
    "pinterest scheduler",
    "google business posts",
    "social media management",
    "community management",
    "whatsapp business",
    "facebook messenger",
    "instagram dms",
    "instagram comments",
    "facebook comments",
    "youtube comments",
    "reply to comments",
    "google reviews",
    "review management",
    "google review response",
    "social media analytics",
    "social media report",
    "client report",
    "engagement rate",
    "top posts",
    "instagram analytics",
    "facebook insights",
    "linkedin analytics",
    "pinterest analytics",
    "youtube analytics",
    "tiktok analytics",
    "auto reply",
    "auto dm",
    "instagram auto reply",
    "instagram automation",
    "facebook automation",
    "dm automation",
    "lead magnet",
    "linkedin pages",
    "linkedin organization",
    "app store",
    "app store connect",
    "apple app store",
    "app store reviews",
    "app reviews",
    "ios app reviews",
    "reply to app store reviews"
  ],
  "interface": {
    "brandColor": "#199E4F",
    "brandColorDark": "#22C55E",
    "capabilities": [],
    "category": "Business & Operations",
    "composerIcon": "./assets/icon.png",
    "logo": "./assets/logo.png",
    "defaultPrompt": [
      "What comments and DMs came in overnight, and which still need a reply?",
      "Which of my recent Instagram posts got the most comments, and what are people saying?",
      "Draft a post for Instagram and Facebook and check it against each platform's limits."
    ],
    "developerName": "SocialAPI",
    "displayName": "Post Schedule DMs by SocialAPI",
    "longDescription": "SocialAPI is a unified social media inbox and publishing API. Read and reply to comments, direct messages, reviews and mentions across Instagram, Facebook, Threads, TikTok, YouTube, X, LinkedIn profiles and Pages, Google Business Profile, Pinterest, WhatsApp, Telegram, Zalo and Bluesky, and answer App Store reviews through App Store Connect. Then draft, validate, schedule and publish posts to your social networks, without writing a separate integration for each one.",
    "privacyPolicyURL": "https://social-api.ai/privacy",
    "shortDescription": "Social media post & inbox",
    "supportURL": "https://social-api.ai/contact",
    "termsOfServiceURL": "https://social-api.ai/terms",
    "websiteURL": "https://social-api.ai"
  },
  "mcpServers": "./.mcp.json",
  "name": "app-69bdb48834e88191bd584cf922fee98f",
  "skills": "./skills",
  "version": "1.0.7",
  "extensions": {
    "com.openai": {
      "review": {
        "demo_recording_url": "https://pub-908c0f59e65d49b4b9e44fe85d3304f9.r2.dev/openai_mcp_video.mp4",
        "test_cases": {
          "positive": [
            {
              "description": "Inbox triage: find the comments and DMs that arrived in a time window and say which ones still need a reply.",
              "prompt": "What comments and DMs came in over the last 24 hours, and which still need a reply?",
              "tools_triggered": "social_api_list_accounts, social_api_list_inbox_posts, social_api_list_post_comments, social_api_list_conversations, social_api_list_messages",
              "expected_behavior": "Lists the connected accounts, then reads recent post comments and DM conversations. Reports the comments and messages from the last 24 hours, grouped by account, and marks which ones have no reply from the business yet. Sends nothing. If no account is connected, says so instead of inventing messages."
            },
            {
              "description": "Engagement read: rank recent Instagram posts by comment count and summarise what commenters say.",
              "prompt": "Which of my recent Instagram posts got the most comments, and what are people saying?",
              "tools_triggered": "social_api_list_accounts, social_api_list_inbox_posts, social_api_list_post_comments",
              "expected_behavior": "Finds the connected Instagram account, lists its recent posts with their comment counts, reads the comments on the top posts, and returns a ranked list with a short summary of the main themes in the comments. Read-only."
            },
            {
              "description": "Draft and check a post against each platform's limits without publishing it.",
              "prompt": "Draft a short post announcing our new summer menu for Instagram and Facebook, and check it against each platform's limits. Don't publish it.",
              "tools_triggered": "social_api_list_accounts, social_api_validate_post",
              "expected_behavior": "Writes a draft caption, validates it for the connected Instagram and Facebook accounts, and reports any per-platform problem (for example, Instagram requiring an image). Publishes nothing and charges no credits."
            },
            {
              "description": "Save a post as a draft for later review.",
              "prompt": "Save a draft post for my Facebook Page that says 'Doors open at 9am this Saturday. See you there!' Don't publish or schedule it.",
              "tools_triggered": "social_api_list_accounts, social_api_create_post",
              "expected_behavior": "Creates the post as a draft on the connected Facebook account, with no publish_now and no scheduled_at, and returns the draft's post id and draft status. Nothing appears on Facebook."
            },
            {
              "description": "Account analytics: report how a connected account performed over a recent period.",
              "prompt": "How did my Instagram account perform over the last 30 days?",
              "tools_triggered": "social_api_list_accounts, social_api_get_account_analytics",
              "expected_behavior": "Reads daily metrics for the connected Instagram account over the last 30 days and summarises the trend (for example followers and reach), stating the dates covered. If no history exists yet, says so rather than inventing numbers."
            }
          ],
          "negative": [
            {
              "description": "Request unrelated to social media management. The app should not be used.",
              "prompt": "Book me a table for two at an Italian restaurant tonight."
            },
            {
              "description": "Reading the inbox of an account the user has not connected. The app can only reach the user's own connected accounts and should say so without attempting access.",
              "prompt": "Show me the private DMs of @nike on Instagram."
            },
            {
              "description": "Bulk unsolicited messaging. The app should not send the same promotional DM to many people who did not write first.",
              "prompt": "Send a DM with our 50% discount code to every one of my Instagram followers."
            }
          ]
        }
      },
      "publication": {
        "release_notes": "Renamed to Post Schedule DMs by SocialAPI. Added App Store and LinkedIn Page search keywords. No change to tools."
      }
    }
  },
  "apps": "./.app.json"
}