Skip to main content
Glama

research_social_signals

Submit or retrieve one bounded social-research analysis. On submit, provide the user's natural-language request and only the explicitly requested public sources: X, Reddit, Xiaohongshu, Zhihu, or Threads. YouTube search, channel search, channel URL-to-ID lookup, channel detail, channel videos, and first-level comments use named youtube_* operations with target fields; read dataset social_resources. Douyin video, user, search, and billboard resources use named douyin_* operations with target fields; read dataset social_resources. TikTok video, user, comments, trending words, and search resources use named tiktok_* operations with target fields; read dataset social_resources. Optional structured search intent and source-specific constraints are mapped by the service; do not provide native platform operators. For X, search_scope may be auto, recent, or full_archive; use full_archive only with a bounded time range. For entity retrieval, use operation post_detail with X post_ids, user_account_post for a Xiaohongshu profile plus one bounded page, or user_posts for one bounded page of a Xiaohongshu user's posts. Zhihu detail, answer-list, hot-list, recommendation, preset-search, and Xiaohongshu suggestion resources use their named operation and business target fields, then read dataset social_resources. On get, provide only analysis_id. The service returns actual coverage without exposing internals.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "action": "<action>"
    },
    "name": "research_social_signals"
  }
}

Input Schema

NameRequiredDescriptionDefault
viewNo
scopeNo
actionYes
searchNo
targetNo
datasetNo
refreshNo
requestNo
operationNotopic_search
page_sizeNo
analysis_idNo
max_resultsNo
analysis_idsNo
channel_queryNo
result_budgetNo
result_cursorNo
research_depthNostandard
result_page_sizeNo

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • addedInput schema / $defs / ChannelSearchRequest
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "仅接受单渠道和关键词,不接受翻页、实体 ID 或研究参数。",
      +  "properties": {
      +    "channel": {
      +      "anyOf": [
      +        {
      +          "enum": [
      +            "google",
      +            "bing"
      +          ],
      +          "type": "string"
      +        },
      +        {
      +          "enum": [
      +            "x",
      +            "reddit",
      +            "xiaohongshu",
      +            "zhihu",
      +            "threads",
      +            "youtube",
      +            "instagram",
      +            "douyin",
      +            "tiktok"
      +          ],
      +          "type": "string"
      +        }
      +      ],
      +      "title": "Channel"
      +    },
      +    "keyword": {
      +      "maxLength": 250,
      +      "minLength": 1,
      +      "title": "Keyword",
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "channel",
      +    "keyword"
      +  ],
      +  "title": "ChannelSearchRequest",
      +  "type": "object"
      +}
    • addedInput schema / properties / channel_query
      Added value: +{
      +  "anyOf": [
      +    {
      +      "$ref": "#/$defs/ChannelSearchRequest"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null
      +}
    • changedInput schema / properties / operation / enum
      Previous value: -[
      -  "topic_search",
      -  "post_detail",
      -  "user_account_post",
      -  "user_posts",
      -  "zhihu_question_detail",
      -  "zhihu_answer_detail",
      -  "zhihu_question_answers",
      -  "zhihu_hot_list",
      -  "zhihu_hot_recommend",
      -  "zhihu_preset_search",
      -  "xiaohongshu_search_suggestions",
      -  "youtube_search",
      -  "youtube_channel_search",
      -  "youtube_channel_id",
      -  "youtube_channel_detail",
      -  "youtube_channel_videos",
      -  "youtube_video_comments",
      -  "instagram_general_search",
      -  "instagram_search_users",
      -  "instagram_hashtag_posts",
      -  "instagram_user_brief",
      -  "instagram_user_posts",
      -  "instagram_post_detail",
      -  "instagram_post_comments",
      -  "instagram_shortcode_to_media_id",
      -  "douyin_video_detail",
      -  "douyin_video_by_share_url",
      -  "douyin_video_statistics",
      -  "douyin_user_profile",
      -  "douyin_user_posts",
      -  "douyin_general_search_v1",
      -  "douyin_search_suggest",
      -  "douyin_user_search",
      -  "douyin_challenge_search_v1",
      -  "douyin_hot_video_list",
      -  "douyin_hot_topic_list",
      -  "douyin_hot_search_list",
      -  "tiktok_post_detail",
      -  "tiktok_trending_searchwords",
      -  "tiktok_user_profile",
      -  "tiktok_user_posts",
      -  "tiktok_post_comments",
      -  "tiktok_search_suggest",
      -  "tiktok_user_search",
      -  "tiktok_general_search",
      -  "tiktok_top_contents"
      -]New value: +[
      +  "topic_search",
      +  "post_detail",
      +  "user_account_post",
      +  "user_posts",
      +  "zhihu_question_detail",
      +  "zhihu_answer_detail",
      +  "zhihu_question_answers",
      +  "zhihu_hot_list",
      +  "zhihu_hot_recommend",
      +  "zhihu_preset_search",
      +  "xiaohongshu_search_suggestions",
      +  "youtube_search",
      +  "youtube_channel_search",
      +  "youtube_channel_id",
      +  "youtube_channel_detail",
      +  "youtube_channel_videos",
      +  "youtube_video_comments",
      +  "instagram_general_search",
      +  "instagram_search_users",
      +  "instagram_hashtag_posts",
      +  "instagram_user_brief",
      +  "instagram_user_posts",
      +  "instagram_post_detail",
      +  "instagram_post_comments",
      +  "instagram_shortcode_to_media_id",
      +  "douyin_video_detail",
      +  "douyin_video_by_share_url",
      +  "douyin_video_statistics",
      +  "douyin_user_profile",
      +  "douyin_user_posts",
      +  "douyin_general_search_v1",
      +  "douyin_search_suggest",
      +  "douyin_user_search",
      +  "douyin_challenge_search_v1",
      +  "douyin_hot_video_list",
      +  "douyin_hot_topic_list",
      +  "douyin_hot_search_list",
      +  "tiktok_post_detail",
      +  "tiktok_trending_searchwords",
      +  "tiktok_user_profile",
      +  "tiktok_user_posts",
      +  "tiktok_post_comments",
      +  "tiktok_search_suggest",
      +  "tiktok_user_search",
      +  "tiktok_general_search",
      +  "tiktok_top_contents",
      +  "free_channel_search"
      +]
  2. Changed49 schema fields changed
    • changedInput schema / $defs / ExcludeRepostsConstraint / properties / sources / items / enum
      Previous value: -[
      -  "x",
      -  "reddit",
      -  "xiaohongshu",
      -  "zhihu",
      -  "threads",
      -  "youtube",
      -  "instagram"
      -]New value: +[
      +  "x",
      +  "reddit",
      +  "xiaohongshu",
      +  "zhihu",
      +  "threads",
      +  "youtube",
      +  "instagram",
      +  "douyin",
      +  "tiktok"
      +]
    • changedInput schema / $defs / MinimumMetricConstraint / properties / sources / items / enum
      Previous value: -[
      -  "x",
      -  "reddit",
      -  "xiaohongshu",
      -  "zhihu",
      -  "threads",
      -  "youtube",
      -  "instagram"
      -]New value: +[
      +  "x",
      +  "reddit",
      +  "xiaohongshu",
      +  "zhihu",
      +  "threads",
      +  "youtube",
      +  "instagram",
      +  "douyin",
      +  "tiktok"
      +]
    • changedInput schema / $defs / SocialResearchScope / properties / platforms / items / enum
      Previous value: -[
      -  "x",
      -  "reddit",
      -  "xiaohongshu",
      -  "zhihu",
      -  "threads",
      -  "youtube",
      -  "instagram"
      -]New value: +[
      +  "x",
      +  "reddit",
      +  "xiaohongshu",
      +  "zhihu",
      +  "threads",
      +  "youtube",
      +  "instagram",
      +  "douyin",
      +  "tiktok"
      +]
    • addedInput schema / $defs / SocialResearchTarget / properties / douyin_aweme_id
      Added value: +{
      +  "anyOf": [
      +    {
      +      "pattern": "^[0-9]{1,32}$",
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Douyin Aweme Id"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / douyin_aweme_ids
      Added value: +{
      +  "anyOf": [
      +    {
      +      "items": {
      +        "pattern": "^[0-9]{1,32}$",
      +        "type": "string"
      +      },
      +      "maxItems": 100,
      +      "minItems": 1,
      +      "type": "array"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Douyin Aweme Ids"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / douyin_backtrace
      Added value: +{
      +  "default": "",
      +  "maxLength": 512,
      +  "title": "Douyin Backtrace",
      +  "type": "string"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / douyin_billboard_sub_type
      Added value: +{
      +  "default": 1001,
      +  "enum": [
      +    1001,
      +    1002,
      +    1003,
      +    1004,
      +    1005
      +  ],
      +  "title": "Douyin Billboard Sub Type",
      +  "type": "integer"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / douyin_channel
      Added value: +{
      +  "default": "normal",
      +  "enum": [
      +    "normal",
      +    "lite"
      +  ],
      +  "title": "Douyin Channel",
      +  "type": "string"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / douyin_content_type
      Added value: +{
      +  "default": "0",
      +  "enum": [
      +    "0",
      +    "1",
      +    "2",
      +    "3"
      +  ],
      +  "title": "Douyin Content Type",
      +  "type": "string"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / douyin_count
      Added value: +{
      +  "default": 20,
      +  "maximum": 100,
      +  "minimum": 1,
      +  "title": "Douyin Count",
      +  "type": "integer"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / douyin_cursor
      Added value: +{
      +  "default": 0,
      +  "minimum": 0,
      +  "title": "Douyin Cursor",
      +  "type": "integer"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / douyin_date_window
      Added value: +{
      +  "default": 24,
      +  "enum": [
      +    1,
      +    24,
      +    72,
      +    168
      +  ],
      +  "title": "Douyin Date Window",
      +  "type": "integer"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / douyin_filter_duration
      Added value: +{
      +  "default": "0",
      +  "enum": [
      +    "0",
      +    "0-1",
      +    "1-5",
      +    "5-10000"
      +  ],
      +  "title": "Douyin Filter Duration",
      +  "type": "string"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / douyin_keyword
      Added value: +{
      +  "anyOf": [
      +    {
      +      "maxLength": 128,
      +      "minLength": 1,
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Douyin Keyword"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / douyin_max_cursor
      Added value: +{
      +  "default": 0,
      +  "minimum": 0,
      +  "title": "Douyin Max Cursor",
      +  "type": "integer"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / douyin_page
      Added value: +{
      +  "default": 1,
      +  "maximum": 100,
      +  "minimum": 1,
      +  "title": "Douyin Page",
      +  "type": "integer"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / douyin_page_size
      Added value: +{
      +  "default": 10,
      +  "maximum": 100,
      +  "minimum": 1,
      +  "title": "Douyin Page Size",
      +  "type": "integer"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / douyin_publish_time
      Added value: +{
      +  "default": "0",
      +  "enum": [
      +    "0",
      +    "1",
      +    "7",
      +    "180"
      +  ],
      +  "title": "Douyin Publish Time",
      +  "type": "string"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / douyin_search_id
      Added value: +{
      +  "default": "",
      +  "maxLength": 512,
      +  "title": "Douyin Search Id",
      +  "type": "string"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / douyin_search_sort_type
      Added value: +{
      +  "default": "0",
      +  "enum": [
      +    "0",
      +    "1",
      +    "2"
      +  ],
      +  "title": "Douyin Search Sort Type",
      +  "type": "string"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / douyin_sec_user_id
      Added value: +{
      +  "anyOf": [
      +    {
      +      "pattern": "^[A-Za-z0-9_.-]{1,256}$",
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Douyin Sec User Id"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / douyin_share_url
      Added value: +{
      +  "anyOf": [
      +    {
      +      "maxLength": 2048,
      +      "minLength": 1,
      +      "pattern": "^https://(?:v\\.douyin\\.com|www\\.douyin\\.com|douyin\\.com)/[^\\s]+$",
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Douyin Share Url"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / douyin_sort_type
      Added value: +{
      +  "default": 0,
      +  "minimum": 0,
      +  "title": "Douyin Sort Type",
      +  "type": "integer"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / douyin_user_fans
      Added value: +{
      +  "default": "",
      +  "enum": [
      +    "",
      +    "0_1k",
      +    "1k_5k",
      +    "5k_10k",
      +    "10k_100k",
      +    "100k_1M",
      +    "1M_"
      +  ],
      +  "title": "Douyin User Fans",
      +  "type": "string"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / douyin_user_type
      Added value: +{
      +  "default": "",
      +  "enum": [
      +    "",
      +    "300",
      +    "900",
      +    "700",
      +    "800"
      +  ],
      +  "title": "Douyin User Type",
      +  "type": "string"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / tiktok_content_label_ids
      Added value: +{
      +  "default": "",
      +  "maxLength": 95,
      +  "title": "Tiktok Content Label Ids",
      +  "type": "string"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / tiktok_count
      Added value: +{
      +  "default": 15,
      +  "maximum": 100,
      +  "minimum": 1,
      +  "title": "Tiktok Count",
      +  "type": "integer"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / tiktok_cover_format
      Added value: +{
      +  "default": 2,
      +  "enum": [
      +    1,
      +    2
      +  ],
      +  "title": "Tiktok Cover Format",
      +  "type": "integer"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / tiktok_cursor
      Added value: +{
      +  "default": 0,
      +  "minimum": 0,
      +  "title": "Tiktok Cursor",
      +  "type": "integer"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / tiktok_item_id
      Added value: +{
      +  "anyOf": [
      +    {
      +      "pattern": "^[0-9]{1,32}$",
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Tiktok Item Id"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / tiktok_keyword
      Added value: +{
      +  "anyOf": [
      +    {
      +      "maxLength": 128,
      +      "minLength": 1,
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Tiktok Keyword"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / tiktok_limit
      Added value: +{
      +  "default": 20,
      +  "maximum": 100,
      +  "minimum": 1,
      +  "title": "Tiktok Limit",
      +  "type": "integer"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / tiktok_offset
      Added value: +{
      +  "default": 0,
      +  "minimum": 0,
      +  "title": "Tiktok Offset",
      +  "type": "integer"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / tiktok_order_by_metric
      Added value: +{
      +  "default": 1,
      +  "enum": [
      +    1,
      +    2,
      +    3
      +  ],
      +  "title": "Tiktok Order By Metric",
      +  "type": "integer"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / tiktok_organic_only
      Added value: +{
      +  "default": false,
      +  "title": "Tiktok Organic Only",
      +  "type": "boolean"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / tiktok_page
      Added value: +{
      +  "default": 1,
      +  "maximum": 100,
      +  "minimum": 1,
      +  "title": "Tiktok Page",
      +  "type": "integer"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / tiktok_period_dimension
      Added value: +{
      +  "default": 3,
      +  "enum": [
      +    1,
      +    3,
      +    5
      +  ],
      +  "title": "Tiktok Period Dimension",
      +  "type": "integer"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / tiktok_period_end_timestamp
      Added value: +{
      +  "anyOf": [
      +    {
      +      "maximum": 9999999999,
      +      "minimum": 1000000000,
      +      "type": "integer"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Tiktok Period End Timestamp"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / tiktok_publish_time
      Added value: +{
      +  "default": 0,
      +  "enum": [
      +    0,
      +    1,
      +    7,
      +    30,
      +    90,
      +    180
      +  ],
      +  "title": "Tiktok Publish Time",
      +  "type": "integer"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / tiktok_region
      Added value: +{
      +  "default": "US",
      +  "pattern": "^[A-Z]{2}$",
      +  "title": "Tiktok Region",
      +  "type": "string"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / tiktok_search_count
      Added value: +{
      +  "default": 20,
      +  "maximum": 100,
      +  "minimum": 1,
      +  "title": "Tiktok Search Count",
      +  "type": "integer"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / tiktok_search_sort_type
      Added value: +{
      +  "default": 0,
      +  "enum": [
      +    0,
      +    1
      +  ],
      +  "title": "Tiktok Search Sort Type",
      +  "type": "integer"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / tiktok_sec_uid
      Added value: +{
      +  "anyOf": [
      +    {
      +      "pattern": "^[A-Za-z0-9_.-]{1,256}$",
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Tiktok Sec Uid"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / tiktok_unique_id
      Added value: +{
      +  "anyOf": [
      +    {
      +      "pattern": "^[A-Za-z0-9._]{1,128}$",
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Tiktok Unique Id"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / tiktok_user_follower_count
      Added value: +{
      +  "default": "",
      +  "enum": [
      +    "",
      +    "ZERO_TO_ONE_K",
      +    "ONE_K_TO_TEN_K",
      +    "TEN_K_TO_ONE_H_K",
      +    "ONE_H_K_PLUS"
      +  ],
      +  "title": "Tiktok User Follower Count",
      +  "type": "string"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / tiktok_user_other_pref
      Added value: +{
      +  "default": "",
      +  "enum": [
      +    "",
      +    "USERNAME"
      +  ],
      +  "title": "Tiktok User Other Pref",
      +  "type": "string"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / tiktok_user_profile_type
      Added value: +{
      +  "default": "",
      +  "enum": [
      +    "",
      +    "VERIFIED"
      +  ],
      +  "title": "Tiktok User Profile Type",
      +  "type": "string"
      +}
    • changedInput schema / $defs / SocialResultBudget / properties / per_source / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": {
      -      "type": "integer"
      -    },
      -    "propertyNames": {
      -      "enum": [
      -        "x",
      -        "reddit",
      -        "xiaohongshu",
      -        "zhihu",
      -        "threads",
      -        "youtube",
      -        "instagram"
      -      ]
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {
      +      "type": "integer"
      +    },
      +    "propertyNames": {
      +      "enum": [
      +        "x",
      +        "reddit",
      +        "xiaohongshu",
      +        "zhihu",
      +        "threads",
      +        "youtube",
      +        "instagram",
      +        "douyin",
      +        "tiktok"
      +      ]
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / operation / enum
      Previous value: -[
      -  "topic_search",
      -  "post_detail",
      -  "user_account_post",
      -  "user_posts",
      -  "zhihu_question_detail",
      -  "zhihu_answer_detail",
      -  "zhihu_question_answers",
      -  "zhihu_hot_list",
      -  "zhihu_hot_recommend",
      -  "zhihu_preset_search",
      -  "xiaohongshu_search_suggestions",
      -  "youtube_search",
      -  "youtube_channel_search",
      -  "youtube_channel_id",
      -  "youtube_channel_detail",
      -  "youtube_channel_videos",
      -  "youtube_video_comments",
      -  "instagram_general_search",
      -  "instagram_search_users",
      -  "instagram_hashtag_posts",
      -  "instagram_user_brief",
      -  "instagram_user_posts",
      -  "instagram_post_detail",
      -  "instagram_post_comments",
      -  "instagram_shortcode_to_media_id"
      -]New value: +[
      +  "topic_search",
      +  "post_detail",
      +  "user_account_post",
      +  "user_posts",
      +  "zhihu_question_detail",
      +  "zhihu_answer_detail",
      +  "zhihu_question_answers",
      +  "zhihu_hot_list",
      +  "zhihu_hot_recommend",
      +  "zhihu_preset_search",
      +  "xiaohongshu_search_suggestions",
      +  "youtube_search",
      +  "youtube_channel_search",
      +  "youtube_channel_id",
      +  "youtube_channel_detail",
      +  "youtube_channel_videos",
      +  "youtube_video_comments",
      +  "instagram_general_search",
      +  "instagram_search_users",
      +  "instagram_hashtag_posts",
      +  "instagram_user_brief",
      +  "instagram_user_posts",
      +  "instagram_post_detail",
      +  "instagram_post_comments",
      +  "instagram_shortcode_to_media_id",
      +  "douyin_video_detail",
      +  "douyin_video_by_share_url",
      +  "douyin_video_statistics",
      +  "douyin_user_profile",
      +  "douyin_user_posts",
      +  "douyin_general_search_v1",
      +  "douyin_search_suggest",
      +  "douyin_user_search",
      +  "douyin_challenge_search_v1",
      +  "douyin_hot_video_list",
      +  "douyin_hot_topic_list",
      +  "douyin_hot_search_list",
      +  "tiktok_post_detail",
      +  "tiktok_trending_searchwords",
      +  "tiktok_user_profile",
      +  "tiktok_user_posts",
      +  "tiktok_post_comments",
      +  "tiktok_search_suggest",
      +  "tiktok_user_search",
      +  "tiktok_general_search",
      +  "tiktok_top_contents"
      +]
  3. Changed21 schema fields changed
    • changedInput schema / $defs / ExcludeRepostsConstraint / properties / sources / items / enum
      Previous value: -[
      -  "x",
      -  "reddit",
      -  "xiaohongshu",
      -  "zhihu",
      -  "threads",
      -  "youtube"
      -]New value: +[
      +  "x",
      +  "reddit",
      +  "xiaohongshu",
      +  "zhihu",
      +  "threads",
      +  "youtube",
      +  "instagram"
      +]
    • changedInput schema / $defs / MinimumMetricConstraint / properties / sources / items / enum
      Previous value: -[
      -  "x",
      -  "reddit",
      -  "xiaohongshu",
      -  "zhihu",
      -  "threads",
      -  "youtube"
      -]New value: +[
      +  "x",
      +  "reddit",
      +  "xiaohongshu",
      +  "zhihu",
      +  "threads",
      +  "youtube",
      +  "instagram"
      +]
    • changedInput schema / $defs / SocialResearchScope / properties / platforms / items / enum
      Previous value: -[
      -  "x",
      -  "reddit",
      -  "xiaohongshu",
      -  "zhihu",
      -  "threads",
      -  "youtube"
      -]New value: +[
      +  "x",
      +  "reddit",
      +  "xiaohongshu",
      +  "zhihu",
      +  "threads",
      +  "youtube",
      +  "instagram"
      +]
    • addedInput schema / $defs / SocialResearchTarget / properties / after
      Added value: +{
      +  "anyOf": [
      +    {
      +      "maxLength": 4096,
      +      "minLength": 1,
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "After"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / before
      Added value: +{
      +  "anyOf": [
      +    {
      +      "maxLength": 4096,
      +      "minLength": 1,
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Before"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / count
      Added value: +{
      +  "default": 12,
      +  "maximum": 50,
      +  "minimum": 1,
      +  "title": "Count",
      +  "type": "integer"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / enable_metadata
      Added value: +{
      +  "default": true,
      +  "title": "Enable Metadata",
      +  "type": "boolean"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / first
      Added value: +{
      +  "default": 12,
      +  "maximum": 50,
      +  "minimum": 1,
      +  "title": "First",
      +  "type": "integer"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / instagram_code_or_url
      Added value: +{
      +  "anyOf": [
      +    {
      +      "maxLength": 2048,
      +      "minLength": 1,
      +      "pattern": "^(?:[A-Za-z0-9_-]{1,128}|https://(?:www\\.)?instagram\\.com/(?:p|reel|reels|tv)/[A-Za-z0-9_-]+/?(?:\\?.*)?)$",
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Instagram Code Or Url"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / instagram_comment_sort_by
      Added value: +{
      +  "default": "recent",
      +  "enum": [
      +    "recent",
      +    "popular"
      +  ],
      +  "title": "Instagram Comment Sort By",
      +  "type": "string"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / instagram_feed_type
      Added value: +{
      +  "anyOf": [
      +    {
      +      "enum": [
      +        "top",
      +        "recent",
      +        "reels"
      +      ],
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Instagram Feed Type"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / instagram_media_id
      Added value: +{
      +  "anyOf": [
      +    {
      +      "pattern": "^[0-9]{1,24}$",
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Instagram Media Id"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / instagram_post_url
      Added value: +{
      +  "anyOf": [
      +    {
      +      "maxLength": 2048,
      +      "pattern": "^https://(?:www\\.)?instagram\\.com/(?:p|reel|reels|tv)/[A-Za-z0-9_-]+/?(?:\\?.*)?$",
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Instagram Post Url"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / instagram_shortcode
      Added value: +{
      +  "anyOf": [
      +    {
      +      "pattern": "^[A-Za-z0-9_-]{1,128}$",
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Instagram Shortcode"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / instagram_user_id
      Added value: +{
      +  "anyOf": [
      +    {
      +      "pattern": "^[0-9]{1,24}$",
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Instagram User Id"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / instagram_username
      Added value: +{
      +  "anyOf": [
      +    {
      +      "pattern": "^[A-Za-z0-9._]{1,30}$",
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Instagram Username"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / last
      Added value: +{
      +  "anyOf": [
      +    {
      +      "maximum": 50,
      +      "minimum": 1,
      +      "type": "integer"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Last"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / pagination_token
      Added value: +{
      +  "anyOf": [
      +    {
      +      "maxLength": 4096,
      +      "minLength": 1,
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Pagination Token"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / rank_token
      Added value: +{
      +  "anyOf": [
      +    {
      +      "maxLength": 4096,
      +      "minLength": 1,
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Rank Token"
      +}
    • changedInput schema / $defs / SocialResultBudget / properties / per_source / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": {
      -      "type": "integer"
      -    },
      -    "propertyNames": {
      -      "enum": [
      -        "x",
      -        "reddit",
      -        "xiaohongshu",
      -        "zhihu",
      -        "threads",
      -        "youtube"
      -      ]
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {
      +      "type": "integer"
      +    },
      +    "propertyNames": {
      +      "enum": [
      +        "x",
      +        "reddit",
      +        "xiaohongshu",
      +        "zhihu",
      +        "threads",
      +        "youtube",
      +        "instagram"
      +      ]
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / operation / enum
      Previous value: -[
      -  "topic_search",
      -  "post_detail",
      -  "user_account_post",
      -  "user_posts",
      -  "zhihu_question_detail",
      -  "zhihu_answer_detail",
      -  "zhihu_question_answers",
      -  "zhihu_hot_list",
      -  "zhihu_hot_recommend",
      -  "zhihu_preset_search",
      -  "xiaohongshu_search_suggestions",
      -  "youtube_search",
      -  "youtube_channel_search",
      -  "youtube_channel_id",
      -  "youtube_channel_detail",
      -  "youtube_channel_videos",
      -  "youtube_video_comments"
      -]New value: +[
      +  "topic_search",
      +  "post_detail",
      +  "user_account_post",
      +  "user_posts",
      +  "zhihu_question_detail",
      +  "zhihu_answer_detail",
      +  "zhihu_question_answers",
      +  "zhihu_hot_list",
      +  "zhihu_hot_recommend",
      +  "zhihu_preset_search",
      +  "xiaohongshu_search_suggestions",
      +  "youtube_search",
      +  "youtube_channel_search",
      +  "youtube_channel_id",
      +  "youtube_channel_detail",
      +  "youtube_channel_videos",
      +  "youtube_video_comments",
      +  "instagram_general_search",
      +  "instagram_search_users",
      +  "instagram_hashtag_posts",
      +  "instagram_user_brief",
      +  "instagram_user_posts",
      +  "instagram_post_detail",
      +  "instagram_post_comments",
      +  "instagram_shortcode_to_media_id"
      +]
  4. Changed12 schema fields changed
    • changedInput schema / $defs / ExcludeRepostsConstraint / properties / sources / items / enum
      Previous value: -[
      -  "x",
      -  "reddit",
      -  "xiaohongshu",
      -  "zhihu",
      -  "threads"
      -]New value: +[
      +  "x",
      +  "reddit",
      +  "xiaohongshu",
      +  "zhihu",
      +  "threads",
      +  "youtube"
      +]
    • changedInput schema / $defs / MinimumMetricConstraint / properties / sources / items / enum
      Previous value: -[
      -  "x",
      -  "reddit",
      -  "xiaohongshu",
      -  "zhihu",
      -  "threads"
      -]New value: +[
      +  "x",
      +  "reddit",
      +  "xiaohongshu",
      +  "zhihu",
      +  "threads",
      +  "youtube"
      +]
    • changedInput schema / $defs / SocialResearchScope / properties / platforms / items / enum
      Previous value: -[
      -  "x",
      -  "reddit",
      -  "xiaohongshu",
      -  "zhihu",
      -  "threads"
      -]New value: +[
      +  "x",
      +  "reddit",
      +  "xiaohongshu",
      +  "zhihu",
      +  "threads",
      +  "youtube"
      +]
    • addedInput schema / $defs / SocialResearchTarget / properties / channel_id
      Added value: +{
      +  "anyOf": [
      +    {
      +      "pattern": "^UC[A-Za-z0-9_-]{22}$",
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Channel Id"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / channel_url
      Added value: +{
      +  "anyOf": [
      +    {
      +      "maxLength": 2048,
      +      "minLength": 1,
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Channel Url"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / continuation_token
      Added value: +{
      +  "anyOf": [
      +    {
      +      "maxLength": 4096,
      +      "minLength": 1,
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Continuation Token"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / country_code
      Added value: +{
      +  "default": "US",
      +  "description": "ISO two-letter country code for YouTube search and resource requests.",
      +  "pattern": "^[A-Z]{2}$",
      +  "title": "Country Code",
      +  "type": "string"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / language_code
      Added value: +{
      +  "anyOf": [
      +    {
      +      "maxLength": 16,
      +      "minLength": 2,
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Language Code"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / sort_by
      Added value: +{
      +  "default": "top",
      +  "enum": [
      +    "top",
      +    "newest"
      +  ],
      +  "title": "Sort By",
      +  "type": "string"
      +}
    • addedInput schema / $defs / SocialResearchTarget / properties / video_id
      Added value: +{
      +  "anyOf": [
      +    {
      +      "pattern": "^[A-Za-z0-9_-]{11}$",
      +      "type": "string"
      +    },
      +    {
      +      "type": "null"
      +    }
      +  ],
      +  "default": null,
      +  "title": "Video Id"
      +}
    • changedInput schema / $defs / SocialResultBudget / properties / per_source / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": {
      -      "type": "integer"
      -    },
      -    "propertyNames": {
      -      "enum": [
      -        "x",
      -        "reddit",
      -        "xiaohongshu",
      -        "zhihu",
      -        "threads"
      -      ]
      -    },
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {
      +      "type": "integer"
      +    },
      +    "propertyNames": {
      +      "enum": [
      +        "x",
      +        "reddit",
      +        "xiaohongshu",
      +        "zhihu",
      +        "threads",
      +        "youtube"
      +      ]
      +    },
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • changedInput schema / properties / operation / enum
      Previous value: -[
      -  "topic_search",
      -  "post_detail",
      -  "user_account_post",
      -  "user_posts",
      -  "zhihu_question_detail",
      -  "zhihu_answer_detail",
      -  "zhihu_question_answers",
      -  "zhihu_hot_list",
      -  "zhihu_hot_recommend",
      -  "zhihu_preset_search",
      -  "xiaohongshu_search_suggestions"
      -]New value: +[
      +  "topic_search",
      +  "post_detail",
      +  "user_account_post",
      +  "user_posts",
      +  "zhihu_question_detail",
      +  "zhihu_answer_detail",
      +  "zhihu_question_answers",
      +  "zhihu_hot_list",
      +  "zhihu_hot_recommend",
      +  "zhihu_preset_search",
      +  "xiaohongshu_search_suggestions",
      +  "youtube_search",
      +  "youtube_channel_search",
      +  "youtube_channel_id",
      +  "youtube_channel_detail",
      +  "youtube_channel_videos",
      +  "youtube_video_comments"
      +]
  5. First observed

TDQS

B3.4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full behavioral burden. It does add real context: results are bounded, the service maps intent itself, native platform operators are rejected, and coverage is honestly reported. But it never states whether submit is asynchronous and requires polling via get, what permissions/authorization are involved, or whether submissions are idempotent or cost-bearing.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness2/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The whole definition is a single unstructured paragraph mixing purpose, per-platform routing, entity operations, and get behavior. It repeats "use named ..._* operations with target fields; read dataset social_resources" three times, and the dense run-on scanning burden obscures the genuinely useful rules. Front-loading the purpose is the one structural strength.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For an 18-parameter tool with nested defs, an output schema, and zero annotation coverage, the description covers the submit/get split and platform routing adequately. It is still incomplete on budgets, depth, pagination cursors, refresh, and view semantics, which are exactly the params an agent must set to use the tool well.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description must compensate, and it does explain the key params: request, scope/sources, search_scope values and their full_archive caveat, operation, target fields, and analysis_id on get. However, of 18 top-level params it leaves result_budget, research_depth, max_results, page_size, result_page_size, result_cursor, view, refresh, dataset, and channel_query entirely unexplained.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb pair and resource: "Submit or retrieve one bounded social-research analysis," and clarifies that this is an explicitly scoped public-source study. An agent can tell it apart from research_seo_signals by domain, though the description never states that distinction itself.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives concrete routing rules: submit the user's natural-language request plus only explicitly requested sources, use named youtube_*/douyin_*/tiktok_* operations for those resources, and on get supply only analysis_id. It also bounds full_archive to a bounded time range. What is missing is any statement of when NOT to use this tool or explicit comparison with the sibling research_seo_signals.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources