Skip to main content
Glama
Sign In

SocialDataX X / Twitter MCP

by com.52choujiang
OverviewDiscussionsAdmin

x_search_posts

Read-only

按搜索词搜索 X / Twitter 公开帖子，只返回帖子结果。用户需要按搜索词查找帖子时使用；已有 post_id 或 post_url 时使用帖子详情或评论工具；已有 user_id、username 或 profile_url 时使用用户信息或用户帖子工具；支持 page_token 翻页和热门/最新排序。

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": {
      "keyword": "<keyword>"
    },
    "name": "x_search_posts"
  }
}

Input Schema

NameRequiredDescriptionDefault
keywordYesX / Twitter 帖子搜索词，可传关键词或短语，例如品牌名、话题、人物名或内容需求；不要传帖子链接、用户主页链接、接口地址、post_id、user_id、username 或 page_token。
sort_typeNo搜索排序：hot=热门，time_descending=最新；需要 latest/newest sorting 时也传 time_descending。如无明确排序需求，保持 hot。hot
page_tokenNoX 搜索分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一关键词和同一搜索排序链路；更换关键词或 sort_type 时，请清空 page_token 后从第一页重新搜索。

Output Schema

NameRequiredDescriptionDefault
itemsYes当前页 X 搜索结果列表；已过滤掉用户、媒体页、列表等非帖子结果；当前页可能为空，是否可继续翻页以 next_page_token 是否为空为准。
pointsYes本次成功调用的积分消耗与账户积分余额。
next_page_tokenYes下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回；只用于当前搜索续页；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedOutput schema / properties / points / description
      Previous value: -"本次成功调用的积分消耗与调用完成时的账户积分余额。"New value: +"本次成功调用的积分消耗与账户积分余额。"
    • changedOutput schema / properties / points / properties / balance / description
      Previous value: -"本次接口完成时看到的当前积分余额，可为负数。"New value: +"优先返回调用完成时查询到的账户积分余额。查询失败时，回退到本次预扣后的余额快照。余额可为负数。"
  2. Changed2 schema fields changed
    • changedOutput schema / properties / points / properties / balance / description
      Previous value: -"本次接口完成时看到的当前积分余额。"New value: +"本次接口完成时看到的当前积分余额，可为负数。"
    • removedOutput schema / properties / points / properties / balance / minimum
      Removed value: -0
  3. Changed44 schema fields changed
    • changedOutput schema / properties / items / items / properties / author / anyOf
      Previous value: -[
-  {
-    "properties": {
-      "avatar_url": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "头像链接；不可用时为 null。"
-      },
-      "bio": {
-        "description": "用户个人简介；没有或不可用时为空字符串。",
-        "type": "string"
-      },
-      "external_url": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "用户主页填写的网站或外部链接；不是帖子链接；标准用户主页请使用 author.profile_url；不可用时为 null。"
-      },
-      "follower_count": {
-        "anyOf": [
-          {
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "粉丝数；不可用时为 null。"
-      },
-      "following_count": {
-        "anyOf": [
-          {
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "关注数；不可用时为 null。"
-      },
-      "is_verified": {
-        "anyOf": [
-          {
-            "type": "boolean"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "是否显示 X 认证标识；不可用时为 null。"
-      },
-      "location": {
-        "description": "用户主页资料里填写的所在地；不是 IP 属地；不可用时为空字符串。",
-        "type": "string"
-      },
-      "name": {
-        "description": "用户展示名；不是 username；不可用时为空字符串。",
-        "type": "string"
-      },
-      "profile_url": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "用户主页链接；不可用时为 null。"
-      },
-      "user_id": {
-        "description": "X 用户稳定数字 ID；不可用时为空字符串。",
-        "type": "string"
-      },
-      "username": {
-        "description": "X 用户名，不带 @；不可用时为空字符串。",
-        "type": "string"
-      },
-      "verified_type": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "认证类型补充信息；可能在 is_verified 为 false 时仍有值；没有或不可用时为 null。"
-      }
-    },
-    "required": [
-      "user_id",
-      "username",
-      "name",
-      "avatar_url",
-      "profile_url",
-      "bio",
-      "is_verified",
-      "verified_type",
-      "follower_count",
-      "following_count",
-      "location",
-      "external_url"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "properties": {
+      "avatar_url": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "头像链接；不可用时为 null。",
+        "title": "Avatar Url"
+      },
+      "bio": {
+        "description": "用户个人简介；没有或不可用时为空字符串。",
+        "title": "Bio",
+        "type": "string"
+      },
+      "external_url": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "用户主页填写的网站或外部链接；不是帖子链接；标准用户主页请使用 author.profile_url；不可用时为 null。",
+        "title": "External Url"
+      },
+      "follower_count": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "粉丝数；不可用时为 null。",
+        "title": "Follower Count"
+      },
+      "following_count": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "关注数；不可用时为 null。",
+        "title": "Following Count"
+      },
+      "is_verified": {
+        "anyOf": [
+          {
+            "type": "boolean"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "是否显示 X 认证标识；不可用时为 null。",
+        "title": "Is Verified"
+      },
+      "location": {
+        "description": "用户主页资料里填写的所在地；不是 IP 属地；不可用时为空字符串。",
+        "title": "Location",
+        "type": "string"
+      },
+      "name": {
+        "description": "用户展示名；不是 username；不可用时为空字符串。",
+        "title": "Name",
+        "type": "string"
+      },
+      "profile_url": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "用户主页链接；不可用时为 null。",
+        "title": "Profile Url"
+      },
+      "user_id": {
+        "description": "X 用户稳定数字 ID；不可用时为空字符串。",
+        "title": "User Id",
+        "type": "string"
+      },
+      "username": {
+        "description": "X 用户名，不带 @；不可用时为空字符串。",
+        "title": "Username",
+        "type": "string"
+      },
+      "verified_type": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "认证类型补充信息；可能在 is_verified 为 false 时仍有值；没有或不可用时为 null。",
+        "title": "Verified Type"
+      }
+    },
+    "required": [
+      "user_id",
+      "username",
+      "name",
+      "avatar_url",
+      "profile_url",
+      "bio",
+      "is_verified",
+      "verified_type",
+      "follower_count",
+      "following_count",
+      "location",
+      "external_url"
+    ],
+    "title": "XUserSummaryData",
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]
    • addedOutput schema / properties / items / items / properties / bookmark_count / title
      Added value: +"Bookmark Count"
    • addedOutput schema / properties / items / items / properties / conversation_id / title
      Added value: +"Conversation Id"
    • addedOutput schema / properties / items / items / properties / cover_image_url / title
      Added value: +"Cover Image Url"
    • addedOutput schema / properties / items / items / properties / external_links / items / properties / short_url / title
      Added value: +"Short Url"
    • addedOutput schema / properties / items / items / properties / external_links / items / properties / target_url / title
      Added value: +"Target Url"
    • addedOutput schema / properties / items / items / properties / external_links / items / title
      Added value: +"XExternalLinkData"
    • addedOutput schema / properties / items / items / properties / external_links / title
      Added value: +"External Links"
    • addedOutput schema / properties / items / items / properties / lang / title
      Added value: +"Lang"
    • addedOutput schema / properties / items / items / properties / like_count / title
      Added value: +"Like Count"
    • addedOutput schema / properties / items / items / properties / media_count / title
      Added value: +"Media Count"
    • addedOutput schema / properties / items / items / properties / media_items / items / properties / cover_image_url / title
      Added value: +"Cover Image Url"
    • addedOutput schema / properties / items / items / properties / media_items / items / properties / duration_ms / title
      Added value: +"Duration Ms"
    • addedOutput schema / properties / items / items / properties / media_items / items / properties / height / title
      Added value: +"Height"
    • addedOutput schema / properties / items / items / properties / media_items / items / properties / media_id / title
      Added value: +"Media Id"
    • addedOutput schema / properties / items / items / properties / media_items / items / properties / media_type / title
      Added value: +"Media Type"
    • addedOutput schema / properties / items / items / properties / media_items / items / properties / video_url / title
      Added value: +"Video Url"
    • addedOutput schema / properties / items / items / properties / media_items / items / properties / width / title
      Added value: +"Width"
    • addedOutput schema / properties / items / items / properties / media_items / items / title
      Added value: +"XMediaItemData"
    • addedOutput schema / properties / items / items / properties / media_items / title
      Added value: +"Media Items"
    • addedOutput schema / properties / items / items / properties / mentioned_users / items / properties / name / title
      Added value: +"Name"
    • addedOutput schema / properties / items / items / properties / mentioned_users / items / properties / user_id / title
      Added value: +"User Id"
    • addedOutput schema / properties / items / items / properties / mentioned_users / items / properties / username / title
      Added value: +"Username"
    • addedOutput schema / properties / items / items / properties / mentioned_users / items / title
      Added value: +"XMentionedUserData"
    • addedOutput schema / properties / items / items / properties / mentioned_users / title
      Added value: +"Mentioned Users"
    • addedOutput schema / properties / items / items / properties / post_id / title
      Added value: +"Post Id"
    • addedOutput schema / properties / items / items / properties / post_type / title
      Added value: +"Post Type"
    • addedOutput schema / properties / items / items / properties / post_url / title
      Added value: +"Post Url"
    • addedOutput schema / properties / items / items / properties / publish_time / title
      Added value: +"Publish Time"
    • addedOutput schema / properties / items / items / properties / quote_count / title
      Added value: +"Quote Count"
    • changedOutput schema / properties / items / items / properties / quoted_post / anyOf
      Previous value: -[
-  {
-    "properties": {
-      "author": {
-        "anyOf": [
-          {
-            "properties": {
-              "avatar_url": {
-                "anyOf": [
-                  {
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ],
-                "description": "头像链接；不可用时为 null。"
-              },
-              "bio": {
-                "description": "用户个人简介；没有或不可用时为空字符串。",
-                "type": "string"
-              },
-              "external_url": {
-                "anyOf": [
-                  {
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ],
-                "description": "用户主页填写的网站或外部链接；不是帖子链接；标准用户主页请使用 author.profile_url；不可用时为 null。"
-              },
-              "follower_count": {
-                "anyOf": [
-                  {
-                    "type": "integer"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ],
-                "description": "粉丝数；不可用时为 null。"
-              },
-              "following_count": {
-                "anyOf": [
-                  {
-                    "type": "integer"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ],
-                "description": "关注数；不可用时为 null。"
-              },
-              "is_verified": {
-                "anyOf": [
-                  {
-                    "type": "boolean"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ],
-                "description": "是否显示 X 认证标识；不可用时为 null。"
-              },
-              "location": {
-                "description": "用户主页资料里填写的所在地；不是 IP 属地；不可用时为空字符串。",
-                "type": "string"
-              },
-              "name": {
-                "description": "用户展示名；不是 username；不可用时为空字符串。",
-                "type": "string"
-              },
-              "profile_url": {
-                "anyOf": [
-                  {
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ],
-                "description": "用户主页链接；不可用时为 null。"
-              },
-              "user_id": {
-                "description": "X 用户稳定数字 ID；不可用时为空字符串。",
-                "type": "string"
-              },
-              "username": {
-                "description": "X 用户名，不带 @；不可用时为空字符串。",
-                "type": "string"
-              },
-              "verified_type": {
-                "anyOf": [
-                  {
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ],
-                "description": "认证类型补充信息；可能在 is_verified 为 false 时仍有值；没有或不可用时为 null。"
-              }
-            },
-            "required": [
-              "user_id",
-              "username",
-              "name",
-              "avatar_url",
-              "profile_url",
-              "bio",
-              "is_verified",
-              "verified_type",
-              "follower_count",
-              "following_count",
-              "location",
-              "external_url"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "被引用帖子作者信息；不可用时为 null。"
-      },
-      "bookmark_count": {
-        "anyOf": [
-          {
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "被引用帖子自身的累计书签数；不可用时为 null。"
-      },
-      "like_count": {
-        "anyOf": [
-          {
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "被引用帖子自身的累计点赞数；不可用时为 null。"
-      },
-      "media_items": {
-        "description": "被引用帖子携带的图片/视频媒体列表；无媒体或不可用时为空数组。",
-        "items": {
-          "properties": {
-            "cover_image_url": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "description": "媒体项封面图链接；图片媒体为图片本身，视频媒体为视频封面；不可用时为 null。"
-            },
-            "duration_ms": {
-              "anyOf": [
-                {
-                  "type": "integer"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "description": "视频时长，单位毫秒；图片媒体或不可用时为 null。"
-            },
-            "height": {
-              "anyOf": [
-                {
-                  "type": "integer"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "description": "媒体高度，像素；视频实际清晰度以 video_url 资源为准；不可用时为 null。"
-            },
-            "media_id": {
-              "description": "媒体项 ID；不可用时为空字符串。",
-              "type": "string"
-            },
-            "media_type": {
-              "description": "媒体项类型；photo 表示图片，video 表示视频。",
-              "enum": [
-                "photo",
-                "video"
-              ],
-              "type": "string"
-            },
-            "video_url": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "description": "视频播放资源链接；图片媒体或不可用时为 null。"
-            },
-            "width": {
-              "anyOf": [
-                {
-                  "type": "integer"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "description": "媒体宽度，像素；视频实际清晰度以 video_url 资源为准；不可用时为 null。"
-            }
-          },
-          "required": [
-            "media_id",
-            "media_type",
-            "cover_image_url",
-            "video_url",
-            "width",
-            "height",
-            "duration_ms"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "post_id": {
-        "description": "被引用的 X 帖子数字 ID；quoted_post 不为 null 时，引用帖详情或评论列表查询优先使用该字段；请按字符串原样保留。",
-        "type": "string"
-      },
-      "post_url": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "被引用帖子详情页链接；主要用于展示；引用帖详情或评论列表查询优先使用 quoted_post.post_id，只有没有被引用帖 post_id 时再作为 URL 入口；不是正文里的链接；不可用时为 null。"
-      },
-      "publish_time": {
-        "anyOf": [
-          {
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "被引用帖子发布时间，秒级 Unix 时间戳；不可用时为 null。"
-      },
-      "quote_count": {
-        "anyOf": [
-          {
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "被引用帖子自身被引用次数；不是 quoted_post 对象数量；不可用时为 null。"
-      },
-      "reply_count": {
-        "anyOf": [
-          {
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "被引用帖子自身的累计回复/评论统计；不是评论列表当前页 items 数量；不可用时为 null。"
-      },
-      "repost_count": {
-        "anyOf": [
-          {
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "被引用帖子自身的累计转帖数；不可用时为 null。"
-      },
-      "text": {
-        "description": "被引用帖子正文文本；不可用时为空字符串。",
-        "type": "string"
-      },
-      "view_count": {
-        "anyOf": [
-          {
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "被引用帖子自身的累计浏览/观看数；不可用时为 null。"
-      }
-    },
-    "required": [
-      "post_id",
-      "post_url",
-      "text",
-      "media_items",
-      "like_count",
-      "reply_count",
-      "repost_count",
-      "quote_count",
-      "bookmark_count",
-      "view_count",
-      "publish_time",
-      "author"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "properties": {
+      "author": {
+        "anyOf": [
+          {
+            "properties": {
+              "avatar_url": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "头像链接；不可用时为 null。",
+                "title": "Avatar Url"
+              },
+              "bio": {
+                "description": "用户个人简介；没有或不可用时为空字符串。",
+                "title": "Bio",
+                "type": "string"
+              },
+              "external_url": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "用户主页填写的网站或外部链接；不是帖子链接；标准用户主页请使用 author.profile_url；不可用时为 null。",
+                "title": "External Url"
+              },
+              "follower_count": {
+                "anyOf": [
+                  {
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "粉丝数；不可用时为 null。",
+                "title": "Follower Count"
+              },
+              "following_count": {
+                "anyOf": [
+                  {
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "关注数；不可用时为 null。",
+                "title": "Following Count"
+              },
+              "is_verified": {
+                "anyOf": [
+                  {
+                    "type": "boolean"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "是否显示 X 认证标识；不可用时为 null。",
+                "title": "Is Verified"
+              },
+              "location": {
+                "description": "用户主页资料里填写的所在地；不是 IP 属地；不可用时为空字符串。",
+                "title": "Location",
+                "type": "string"
+              },
+              "name": {
+                "description": "用户展示名；不是 username；不可用时为空字符串。",
+                "title": "Name",
+                "type": "string"
+              },
+              "profile_url": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "用户主页链接；不可用时为 null。",
+                "title": "Profile Url"
+              },
+              "user_id": {
+                "description": "X 用户稳定数字 ID；不可用时为空字符串。",
+                "title": "User Id",
+                "type": "string"
+              },
+              "username": {
+                "description": "X 用户名，不带 @；不可用时为空字符串。",
+                "title": "Username",
+                "type": "string"
+              },
+              "verified_type": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "认证类型补充信息；可能在 is_verified 为 false 时仍有值；没有或不可用时为 null。",
+                "title": "Verified Type"
+              }
+            },
+            "required": [
+              "user_id",
+              "username",
+              "name",
+              "avatar_url",
+              "profile_url",
+              "bio",
+              "is_verified",
+              "verified_type",
+              "follower_count",
+              "following_count",
+              "location",
+              "external_url"
+            ],
+            "title": "XUserSummaryData",
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "被引用帖子作者信息；不可用时为 null。"
+      },
+      "bookmark_count": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "被引用帖子自身的累计书签数；不可用时为 null。",
+        "title": "Bookmark Count"
+      },
+      "like_count": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "被引用帖子自身的累计点赞数；不可用时为 null。",
+        "title": "Like Count"
+      },
+      "media_items": {
+        "description": "被引用帖子携带的图片/视频媒体列表；无媒体或不可用时为空数组。",
+        "items": {
+          "properties": {
+            "cover_image_url": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "媒体项封面图链接；图片媒体为图片本身，视频媒体为视频封面；不可用时为 null。",
+              "title": "Cover Image Url"
+            },
+            "duration_ms": {
+              "anyOf": [
+                {
+                  "type": "integer"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "视频时长，单位毫秒；图片媒体或不可用时为 null。",
+              "title": "Duration Ms"
+            },
+            "height": {
+              "anyOf": [
+                {
+                  "type": "integer"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "媒体高度，像素；视频实际清晰度以 video_url 资源为准；不可用时为 null。",
+              "title": "Height"
+            },
+            "media_id": {
+              "description": "媒体项 ID；不可用时为空字符串。",
+              "title": "Media Id",
+              "type": "string"
+            },
+            "media_type": {
+              "description": "媒体项类型；photo 表示图片，video 表示视频。",
+              "enum": [
+                "photo",
+                "video"
+              ],
+              "title": "Media Type",
+              "type": "string"
+            },
+            "video_url": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "视频播放资源链接；图片媒体或不可用时为 null。",
+              "title": "Video Url"
+            },
+            "width": {
+              "anyOf": [
+                {
+                  "type": "integer"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "媒体宽度，像素；视频实际清晰度以 video_url 资源为准；不可用时为 null。",
+              "title": "Width"
+            }
+          },
+          "required": [
+            "media_id",
+            "media_type",
+            "cover_image_url",
+            "video_url",
+            "width",
+            "height",
+            "duration_ms"
+          ],
+          "title": "XMediaItemData",
+          "type": "object"
+        },
+        "title": "Media Items",
+        "type": "array"
+      },
+      "post_id": {
+        "description": "被引用的 X 帖子数字 ID；quoted_post 不为 null 时，引用帖详情或评论列表查询优先使用该字段；请按字符串原样保留。",
+        "title": "Post Id",
+        "type": "string"
+      },
+      "post_url": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "被引用帖子详情页链接；主要用于展示；引用帖详情或评论列表查询优先使用 quoted_post.post_id，只有没有被引用帖 post_id 时再作为 URL 入口；不是正文里的链接；不可用时为 null。",
+        "title": "Post Url"
+      },
+      "publish_time": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "被引用帖子发布时间，秒级 Unix 时间戳；不可用时为 null。",
+        "title": "Publish Time"
+      },
+      "quote_count": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "被引用帖子自身被引用次数；不是 quoted_post 对象数量；不可用时为 null。",
+        "title": "Quote Count"
+      },
+      "reply_count": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "被引用帖子自身的累计回复/评论统计；不是评论列表当前页 items 数量；不可用时为 null。",
+        "title": "Reply Count"
+      },
+      "repost_count": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "被引用帖子自身的累计转帖数；不可用时为 null。",
+        "title": "Repost Count"
+      },
+      "text": {
+        "description": "被引用帖子正文文本；不可用时为空字符串。",
+        "title": "Text",
+        "type": "string"
+      },
+      "view_count": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "被引用帖子自身的累计浏览/观看数；不可用时为 null。",
+        "title": "View Count"
+      }
+    },
+    "required": [
+      "post_id",
+      "post_url",
+      "text",
+      "media_items",
+      "like_count",
+      "reply_count",
+      "repost_count",
+      "quote_count",
+      "bookmark_count",
+      "view_count",
+      "publish_time",
+      "author"
+    ],
+    "title": "XQuotedPostData",
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]
    • addedOutput schema / properties / items / items / properties / reply_count / title
      Added value: +"Reply Count"
    • addedOutput schema / properties / items / items / properties / reply_to_post_id / title
      Added value: +"Reply To Post Id"
    • addedOutput schema / properties / items / items / properties / repost_count / title
      Added value: +"Repost Count"
    • changedOutput schema / properties / items / items / properties / reposted_post / anyOf
      Previous value: -[
-  {
-    "properties": {
-      "author": {
-        "anyOf": [
-          {
-            "properties": {
-              "avatar_url": {
-                "anyOf": [
-                  {
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ],
-                "description": "头像链接；不可用时为 null。"
-              },
-              "bio": {
-                "description": "用户个人简介；没有或不可用时为空字符串。",
-                "type": "string"
-              },
-              "external_url": {
-                "anyOf": [
-                  {
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ],
-                "description": "用户主页填写的网站或外部链接；不是帖子链接；标准用户主页请使用 author.profile_url；不可用时为 null。"
-              },
-              "follower_count": {
-                "anyOf": [
-                  {
-                    "type": "integer"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ],
-                "description": "粉丝数；不可用时为 null。"
-              },
-              "following_count": {
-                "anyOf": [
-                  {
-                    "type": "integer"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ],
-                "description": "关注数；不可用时为 null。"
-              },
-              "is_verified": {
-                "anyOf": [
-                  {
-                    "type": "boolean"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ],
-                "description": "是否显示 X 认证标识；不可用时为 null。"
-              },
-              "location": {
-                "description": "用户主页资料里填写的所在地；不是 IP 属地；不可用时为空字符串。",
-                "type": "string"
-              },
-              "name": {
-                "description": "用户展示名；不是 username；不可用时为空字符串。",
-                "type": "string"
-              },
-              "profile_url": {
-                "anyOf": [
-                  {
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ],
-                "description": "用户主页链接；不可用时为 null。"
-              },
-              "user_id": {
-                "description": "X 用户稳定数字 ID；不可用时为空字符串。",
-                "type": "string"
-              },
-              "username": {
-                "description": "X 用户名，不带 @；不可用时为空字符串。",
-                "type": "string"
-              },
-              "verified_type": {
-                "anyOf": [
-                  {
-                    "type": "string"
-                  },
-                  {
-                    "type": "null"
-                  }
-                ],
-                "description": "认证类型补充信息；可能在 is_verified 为 false 时仍有值；没有或不可用时为 null。"
-              }
-            },
-            "required": [
-              "user_id",
-              "username",
-              "name",
-              "avatar_url",
-              "profile_url",
-              "bio",
-              "is_verified",
-              "verified_type",
-              "follower_count",
-              "following_count",
-              "location",
-              "external_url"
-            ],
-            "type": "object"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "被转帖原帖作者信息；不可用时为 null。"
-      },
-      "bookmark_count": {
-        "anyOf": [
-          {
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "被转帖原帖自身的累计书签数；不可用时为 null。"
-      },
-      "like_count": {
-        "anyOf": [
-          {
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "被转帖原帖自身的累计点赞数；不可用时为 null。"
-      },
-      "media_items": {
-        "description": "被转帖原帖携带的图片/视频媒体列表；无媒体或不可用时为空数组。",
-        "items": {
-          "properties": {
-            "cover_image_url": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "description": "媒体项封面图链接；图片媒体为图片本身，视频媒体为视频封面；不可用时为 null。"
-            },
-            "duration_ms": {
-              "anyOf": [
-                {
-                  "type": "integer"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "description": "视频时长，单位毫秒；图片媒体或不可用时为 null。"
-            },
-            "height": {
-              "anyOf": [
-                {
-                  "type": "integer"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "description": "媒体高度，像素；视频实际清晰度以 video_url 资源为准；不可用时为 null。"
-            },
-            "media_id": {
-              "description": "媒体项 ID；不可用时为空字符串。",
-              "type": "string"
-            },
-            "media_type": {
-              "description": "媒体项类型；photo 表示图片，video 表示视频。",
-              "enum": [
-                "photo",
-                "video"
-              ],
-              "type": "string"
-            },
-            "video_url": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "description": "视频播放资源链接；图片媒体或不可用时为 null。"
-            },
-            "width": {
-              "anyOf": [
-                {
-                  "type": "integer"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "description": "媒体宽度，像素；视频实际清晰度以 video_url 资源为准；不可用时为 null。"
-            }
-          },
-          "required": [
-            "media_id",
-            "media_type",
-            "cover_image_url",
-            "video_url",
-            "width",
-            "height",
-            "duration_ms"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "post_id": {
-        "description": "被转帖的原帖数字 ID；reposted_post 不为 null 时，原帖详情或评论列表查询优先使用该字段；请按字符串原样保留。",
-        "type": "string"
-      },
-      "post_url": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "被转帖原帖详情页链接；主要用于展示；原帖详情或评论列表查询优先使用 reposted_post.post_id，只有没有原帖 post_id 时再作为 URL 入口；不是正文里的链接；不可用时为 null。"
-      },
-      "publish_time": {
-        "anyOf": [
-          {
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "被转帖原帖发布时间，秒级 Unix 时间戳；不可用时为 null。"
-      },
-      "quote_count": {
-        "anyOf": [
-          {
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "被转帖原帖自身被引用次数；不是 reposted_post 对象数量；不可用时为 null。"
-      },
-      "reply_count": {
-        "anyOf": [
-          {
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "被转帖原帖自身的累计回复/评论统计；不是评论列表当前页 items 数量；不可用时为 null。"
-      },
-      "repost_count": {
-        "anyOf": [
-          {
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "被转帖原帖自身的累计转帖数；不可用时为 null。"
-      },
-      "text": {
-        "description": "被转帖原帖正文文本；不可用时为空字符串。",
-        "type": "string"
-      },
-      "view_count": {
-        "anyOf": [
-          {
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "被转帖原帖自身的累计浏览/观看数；不可用时为 null。"
-      }
-    },
-    "required": [
-      "post_id",
-      "post_url",
-      "text",
-      "media_items",
-      "like_count",
-      "reply_count",
-      "repost_count",
-      "quote_count",
-      "bookmark_count",
-      "view_count",
-      "publish_time",
-      "author"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "properties": {
+      "author": {
+        "anyOf": [
+          {
+            "properties": {
+              "avatar_url": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "头像链接；不可用时为 null。",
+                "title": "Avatar Url"
+              },
+              "bio": {
+                "description": "用户个人简介；没有或不可用时为空字符串。",
+                "title": "Bio",
+                "type": "string"
+              },
+              "external_url": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "用户主页填写的网站或外部链接；不是帖子链接；标准用户主页请使用 author.profile_url；不可用时为 null。",
+                "title": "External Url"
+              },
+              "follower_count": {
+                "anyOf": [
+                  {
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "粉丝数；不可用时为 null。",
+                "title": "Follower Count"
+              },
+              "following_count": {
+                "anyOf": [
+                  {
+                    "type": "integer"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "关注数；不可用时为 null。",
+                "title": "Following Count"
+              },
+              "is_verified": {
+                "anyOf": [
+                  {
+                    "type": "boolean"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "是否显示 X 认证标识；不可用时为 null。",
+                "title": "Is Verified"
+              },
+              "location": {
+                "description": "用户主页资料里填写的所在地；不是 IP 属地；不可用时为空字符串。",
+                "title": "Location",
+                "type": "string"
+              },
+              "name": {
+                "description": "用户展示名；不是 username；不可用时为空字符串。",
+                "title": "Name",
+                "type": "string"
+              },
+              "profile_url": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "用户主页链接；不可用时为 null。",
+                "title": "Profile Url"
+              },
+              "user_id": {
+                "description": "X 用户稳定数字 ID；不可用时为空字符串。",
+                "title": "User Id",
+                "type": "string"
+              },
+              "username": {
+                "description": "X 用户名，不带 @；不可用时为空字符串。",
+                "title": "Username",
+                "type": "string"
+              },
+              "verified_type": {
+                "anyOf": [
+                  {
+                    "type": "string"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ],
+                "description": "认证类型补充信息；可能在 is_verified 为 false 时仍有值；没有或不可用时为 null。",
+                "title": "Verified Type"
+              }
+            },
+            "required": [
+              "user_id",
+              "username",
+              "name",
+              "avatar_url",
+              "profile_url",
+              "bio",
+              "is_verified",
+              "verified_type",
+              "follower_count",
+              "following_count",
+              "location",
+              "external_url"
+            ],
+            "title": "XUserSummaryData",
+            "type": "object"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "被转帖原帖作者信息；不可用时为 null。"
+      },
+      "bookmark_count": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "被转帖原帖自身的累计书签数；不可用时为 null。",
+        "title": "Bookmark Count"
+      },
+      "like_count": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "被转帖原帖自身的累计点赞数；不可用时为 null。",
+        "title": "Like Count"
+      },
+      "media_items": {
+        "description": "被转帖原帖携带的图片/视频媒体列表；无媒体或不可用时为空数组。",
+        "items": {
+          "properties": {
+            "cover_image_url": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "媒体项封面图链接；图片媒体为图片本身，视频媒体为视频封面；不可用时为 null。",
+              "title": "Cover Image Url"
+            },
+            "duration_ms": {
+              "anyOf": [
+                {
+                  "type": "integer"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "视频时长，单位毫秒；图片媒体或不可用时为 null。",
+              "title": "Duration Ms"
+            },
+            "height": {
+              "anyOf": [
+                {
+                  "type": "integer"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "媒体高度，像素；视频实际清晰度以 video_url 资源为准；不可用时为 null。",
+              "title": "Height"
+            },
+            "media_id": {
+              "description": "媒体项 ID；不可用时为空字符串。",
+              "title": "Media Id",
+              "type": "string"
+            },
+            "media_type": {
+              "description": "媒体项类型；photo 表示图片，video 表示视频。",
+              "enum": [
+                "photo",
+                "video"
+              ],
+              "title": "Media Type",
+              "type": "string"
+            },
+            "video_url": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "视频播放资源链接；图片媒体或不可用时为 null。",
+              "title": "Video Url"
+            },
+            "width": {
+              "anyOf": [
+                {
+                  "type": "integer"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "媒体宽度，像素；视频实际清晰度以 video_url 资源为准；不可用时为 null。",
+              "title": "Width"
+            }
+          },
+          "required": [
+            "media_id",
+            "media_type",
+            "cover_image_url",
+            "video_url",
+            "width",
+            "height",
+            "duration_ms"
+          ],
+          "title": "XMediaItemData",
+          "type": "object"
+        },
+        "title": "Media Items",
+        "type": "array"
+      },
+      "post_id": {
+        "description": "被转帖的原帖数字 ID；reposted_post 不为 null 时，原帖详情或评论列表查询优先使用该字段；请按字符串原样保留。",
+        "title": "Post Id",
+        "type": "string"
+      },
+      "post_url": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "被转帖原帖详情页链接；主要用于展示；原帖详情或评论列表查询优先使用 reposted_post.post_id，只有没有原帖 post_id 时再作为 URL 入口；不是正文里的链接；不可用时为 null。",
+        "title": "Post Url"
+      },
+      "publish_time": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "被转帖原帖发布时间，秒级 Unix 时间戳；不可用时为 null。",
+        "title": "Publish Time"
+      },
+      "quote_count": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "被转帖原帖自身被引用次数；不是 reposted_post 对象数量；不可用时为 null。",
+        "title": "Quote Count"
+      },
+      "reply_count": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "被转帖原帖自身的累计回复/评论统计；不是评论列表当前页 items 数量；不可用时为 null。",
+        "title": "Reply Count"
+      },
+      "repost_count": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "被转帖原帖自身的累计转帖数；不可用时为 null。",
+        "title": "Repost Count"
+      },
+      "text": {
+        "description": "被转帖原帖正文文本；不可用时为空字符串。",
+        "title": "Text",
+        "type": "string"
+      },
+      "view_count": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "被转帖原帖自身的累计浏览/观看数；不可用时为 null。",
+        "title": "View Count"
+      }
+    },
+    "required": [
+      "post_id",
+      "post_url",
+      "text",
+      "media_items",
+      "like_count",
+      "reply_count",
+      "repost_count",
+      "quote_count",
+      "bookmark_count",
+      "view_count",
+      "publish_time",
+      "author"
+    ],
+    "title": "XRepostedPostData",
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]
    • addedOutput schema / properties / items / items / properties / text / title
      Added value: +"Text"
    • addedOutput schema / properties / items / items / properties / topic_tags / items / properties / name / title
      Added value: +"Name"
    • addedOutput schema / properties / items / items / properties / topic_tags / items / title
      Added value: +"XTopicTagData"
    • addedOutput schema / properties / items / items / properties / topic_tags / title
      Added value: +"Topic Tags"
    • addedOutput schema / properties / items / items / properties / view_count / title
      Added value: +"View Count"
    • addedOutput schema / properties / items / items / title
      Added value: +"XPostSearchItemData"
    • addedOutput schema / properties / items / title
      Added value: +"Items"
    • addedOutput schema / properties / next_page_token / title
      Added value: +"Next Page Token"
    • addedOutput schema / title
      Added value: +"XPostSearchResult"
  4. First observed

TDQS

A4.4/5.0
Behavior4/5

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

Annotations already declare readOnlyHint=true and openWorldHint=true, so the safety profile is covered. The description adds useful behavior beyond that: results are limited to posts only, and the call supports pagination and hot/latest sorting. It stops short of describing result volume, rate limits, or empty-result behavior, so it is strong but not exhaustive.

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

Conciseness4/5

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

A single dense sentence structured as purpose → routing rules → pagination/sort note, with the core purpose front-loaded. Efficient, though the semicolon-chained routing clauses are compact enough that they read as a run-on rather than cleanly separated guidance.

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

Completeness5/5

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

An output schema exists, so return values need no explanation; all three parameters are fully documented in the schema, and the description covers scope, disambiguation, and pagination/sorting. For a 3-parameter read-only search tool this is complete.

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 100%, and the keyword, sort_type, and page_token descriptions in the schema are themselves detailed (including opaque-token handling and reset-on-keyword-change rules). The description only restates pagination and sort support at a high level, adding little meaning beyond the schema. Baseline 3 applies.

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

Purpose5/5

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

The description opens with a specific verb+resource+scope: searching X/Twitter public posts by keyword and returning only post results. It also distinguishes itself from the many sibling tools by naming the routing conditions (post detail/comments when post_id or post_url exists, user tools when user identifiers exist).

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

Usage Guidelines5/5

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

Explicit when-to-use ('用户需要按搜索词查找帖子时使用') and explicit when-not-to-use with named alternatives for each case (post_id/post_url → detail or comment tools; user_id/username/profile_url → user info or user posts tools). Nothing is left to inference for an agent choosing among ~20 siblings.

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

All SocialDataX X / Twitter MCP toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources