socialbridge-mcp

Fetch one account profile from any supported network as the unified Profile schema (id, username, displayName, bio, url, followers, following, postCount, verified, avatarUrl, externalUrl), tagged with its platform. Keyless on Instagram, TikTok, YouTube, Pinterest, Snapchat, and Threads. Twitter/X, Reddit, and Facebook need operator-side credentials (returns credentials_required until set); LinkedIn is quarantined (platform_disabled).

{
  "type": "object",
  "properties": {
    "platform": {
      "type": "string",
      "enum": [
        "instagram",
        "tiktok",
        "youtube",
        "twitter",
        "reddit",
        "facebook",
        "pinterest",
        "snapchat",
        "threads",
        "linkedin"
      ],
      "description": "Target social network."
    },
    "username": {
      "type": "string",
      "description": "Account handle / username (without @)."
    }
  },
  "required": [
    "platform",
    "username"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

An account's recent posts / videos / tweets / threads / pins as the unified Post[] schema (id, url, author, text, createdAt, like/comment/share/view counts, mediaType, mediaUrls, hashtags), tagged with its platform. Keyless on Instagram, TikTok, YouTube, Pinterest, Snapchat, and Threads. Twitter/X, Reddit, and Facebook need operator-side credentials; LinkedIn is quarantined. For a keyless Reddit history pull use reddit_history.

{
  "type": "object",
  "properties": {
    "platform": {
      "type": "string",
      "enum": [
        "instagram",
        "tiktok",
        "youtube",
        "twitter",
        "reddit",
        "facebook",
        "pinterest",
        "snapchat",
        "threads",
        "linkedin"
      ],
      "description": "Target social network."
    },
    "username": {
      "type": "string",
      "description": "Account handle / username (without @)."
    },
    "limit": {
      "description": "Max results, clamped 1-100. Default 20.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "Opaque pagination cursor from a previous response (where the platform supports paging).",
      "type": "string"
    }
  },
  "required": [
    "platform",
    "username"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Search a single network for posts matching a query, returned as the unified Post[] schema and tagged with its platform. Keyless on TikTok, YouTube, and Pinterest. Instagram, Twitter/X, Reddit, and Facebook need operator-side credentials (returns credentials_required until set). Snapchat and Threads do not support keyless search (returns not_supported); LinkedIn is quarantined. To fan one query across every network at once, use search_all.

{
  "type": "object",
  "properties": {
    "platform": {
      "type": "string",
      "enum": [
        "instagram",
        "tiktok",
        "youtube",
        "twitter",
        "reddit",
        "facebook",
        "pinterest",
        "snapchat",
        "threads",
        "linkedin"
      ],
      "description": "Target social network."
    },
    "q": {
      "type": "string",
      "description": "Search query."
    },
    "limit": {
      "description": "Max results, clamped 1-100. Default 20.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "Opaque pagination cursor from a previous response (where the platform supports paging).",
      "type": "string"
    }
  },
  "required": [
    "platform",
    "q"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Comments / replies on one post as the unified Comment[] schema, tagged with its platform. Provide url OR postId. Keyless on TikTok, YouTube, and Threads (and a single tweet via syndication on Twitter/X). Instagram, Reddit, and Facebook need operator-side credentials; Snapchat comments are not supported keyless; LinkedIn is quarantined.

{
  "type": "object",
  "properties": {
    "platform": {
      "type": "string",
      "enum": [
        "instagram",
        "tiktok",
        "youtube",
        "twitter",
        "reddit",
        "facebook",
        "pinterest",
        "snapchat",
        "threads",
        "linkedin"
      ],
      "description": "Target social network."
    },
    "url": {
      "description": "Post URL. Provide url OR postId.",
      "type": "string"
    },
    "postId": {
      "description": "Platform-native post id. Provide url OR postId.",
      "type": "string"
    },
    "limit": {
      "description": "Max results, clamped 1-100. Default 20.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "cursor": {
      "description": "Opaque pagination cursor from a previous response (where the platform supports paging).",
      "type": "string"
    }
  },
  "required": [
    "platform"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

The wedge no incumbent offers: fan one search query out across the requested platforms (default: all keyless, non-disabled) in parallel, merge the unified Post[], and tag each result with its platform. Gated / disabled / unsupported / throttled engines are listed under "skipped" with an honest reason — the call still returns whatever came back.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Search query."
    },
    "platforms": {
      "description": "Comma-separated subset of platforms to query (e.g. \"tiktok,youtube,threads\"). Omit for all keyless, non-disabled platforms.",
      "type": "string"
    },
    "limit": {
      "description": "Max results, clamped 1-50. Default 10.",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "required": [
    "q"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Keyless full-history pull via Arctic Shift — a user's or subreddit's posts, or a keyword search across Reddit history, returned as the unified Post[]. Provide at least one of username, subreddit, or q. Optional before/after bound the window by epoch-seconds or ISO timestamp.

{
  "type": "object",
  "properties": {
    "username": {
      "description": "Reddit username (without u/).",
      "type": "string"
    },
    "subreddit": {
      "description": "Subreddit (without r/).",
      "type": "string"
    },
    "q": {
      "description": "Keyword to search across history.",
      "type": "string"
    },
    "limit": {
      "description": "Max results, clamped 1-100. Default 25.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    },
    "before": {
      "description": "Return items created before this epoch-seconds / ISO timestamp.",
      "type": "string"
    },
    "after": {
      "description": "Return items created after this epoch-seconds / ISO timestamp.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Meta (Facebook/Instagram) Ad Library records as the unified Ad[] (id, pageName, adCreativeBody, adSnapshotUrl, startDate, currency, spend + impression ranges). Provide q OR pageId. GATED — needs operator-side FACEBOOK_ACCESS_TOKEN (with ads_read); returns credentials_required until set.

{
  "type": "object",
  "properties": {
    "q": {
      "description": "Free-text search across ad creative. Provide q OR pageId.",
      "type": "string"
    },
    "pageId": {
      "description": "Advertiser Page id. Provide q OR pageId.",
      "type": "string"
    },
    "country": {
      "description": "ISO-3166 alpha-2 country (upper-cased server-side). Default US.",
      "type": "string"
    },
    "limit": {
      "description": "Max results, clamped 1-100. Default 25.",
      "type": "integer",
      "minimum": 1,
      "maximum": 100
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Available caption-language list (and cue segments where retrievable) for a YouTube video. Provide url OR videoId. Keyless. NOTE: actual cue text is BotGuard-gated keyless, so it is reported honestly (available:false, empty segments) rather than fabricated.

{
  "type": "object",
  "properties": {
    "url": {
      "description": "YouTube watch URL. Provide url OR videoId.",
      "type": "string"
    },
    "videoId": {
      "description": "11-char video id. Provide url OR videoId.",
      "type": "string"
    },
    "lang": {
      "description": "Preferred caption language (BCP-47, e.g. \"en\").",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Fetch a single thread by shortcode or URL, including its replies, as the unified Post (with replies). Provide code OR url. Keyless.

{
  "type": "object",
  "properties": {
    "code": {
      "description": "Thread shortcode. Provide code OR url.",
      "type": "string"
    },
    "url": {
      "description": "Full thread URL. Provide code OR url.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

A creator's public Snapchat Spotlight feed as the unified Post[] with real view/comment/share counts. Keyless.

{
  "type": "object",
  "properties": {
    "username": {
      "description": "Account handle / username (without @).",
      "type": "string"
    },
    "limit": {
      "description": "Max results, clamped 1-50. Default 20.",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}