Skip to main content
Glama
Sign In

SocialDataX X / Twitter MCP

by com.52choujiang
OverviewDiscussionsAdmin

x_get_post_detail_by_post_id

Read-only

根据 X 帖子 ID 获取公开帖子详情；已知 post_id 时优先使用，不要传帖子链接。

Input Schema

NameRequiredDescriptionDefault
post_idYesX 帖子 ID；用户已提供时原样使用，否则可从搜索结果、详情结果、quoted_post、reposted_post 或用户帖子列表结果复制 post_id；必须是数字字符串；不要传帖子链接、用户名或分享文案。

Output Schema

NameRequiredDescriptionDefault
langYes帖子语言代码；不可用时为空字符串。
textYes帖子正文文本；不可用时为空字符串。
authorYes帖子作者信息；不可用时为 null。
pointsYes本次成功调用的积分消耗与账户积分余额。
post_idYesX 帖子数字 ID；帖子详情或评论列表查询优先使用该字段；请按字符串原样保留。
post_urlYesX 帖子详情页链接；主要用于展示；详情或评论列表查询优先使用 post_id，只有没有 post_id 时再作为 URL 入口；不是帖子正文里的链接；不可用时为 null。
post_typeYes帖子类型；text=未返回图片/视频媒体的文字帖，photo=图片帖，video=包含视频的帖子。
like_countYes该帖累计点赞数；不可用时为 null。
topic_tagsYes帖子中的话题标签；无话题标签或不可用时为空数组；每项只返回 name，不带 #。
view_countYes该帖累计浏览/观看数；不可用时为 null。
media_countYes帖子包含的媒体数量；等于返回的 media_items 数量。
media_itemsYes帖子包含的图片/视频媒体列表；无媒体或不可用时为空数组。
quote_countYes该帖被引用次数；不是 quoted_post 对象数量；不可用时为 null。
quoted_postYes被引用的帖子摘要；不是完整帖子详情结构；没有引用帖或不可用时为 null。
reply_countYes该帖累计回复/评论统计；不是评论列表当前页 items 数量；不可用时为 null。
is_sensitiveYes是否带有平台敏感内容标记；不可用时为 null。
publish_timeYes发布时间，秒级 Unix 时间戳；不可用时为 null。
repost_countYes该帖累计转帖数；不可用时为 null。
reposted_postYes被转帖的原帖摘要；不是引用帖，也不是完整帖子详情结构；没有转帖原帖或不可用时为 null。
bookmark_countYes该帖累计书签数；不可用时为 null。
external_linksYes帖子正文中的链接列表；可能包含外部网站或 X 内部链接；无链接或不可用时为空数组。
conversation_idYes会话/讨论串归组 ID；不是评论 ID；不可用时为空字符串。
cover_image_urlYes帖子首个可用媒体封面图链接；无媒体或不可用时为 null。
mentioned_usersYes帖子中 @ 到的用户；无 @ 或不可用时为空数组。
reply_to_post_idYes该帖回复的上级帖子 ID；不是评论 ID；没有或不可用时为空字符串。

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. Changed42 schema fields changed
    • changedOutput schema / 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 / bookmark_count / title
      Added value: +"Bookmark Count"
    • addedOutput schema / properties / conversation_id / title
      Added value: +"Conversation Id"
    • addedOutput schema / properties / cover_image_url / title
      Added value: +"Cover Image Url"
    • addedOutput schema / properties / external_links / items / properties / short_url / title
      Added value: +"Short Url"
    • addedOutput schema / properties / external_links / items / properties / target_url / title
      Added value: +"Target Url"
    • addedOutput schema / properties / external_links / items / title
      Added value: +"XExternalLinkData"
    • addedOutput schema / properties / external_links / title
      Added value: +"External Links"
    • addedOutput schema / properties / is_sensitive / title
      Added value: +"Is Sensitive"
    • addedOutput schema / properties / lang / title
      Added value: +"Lang"
    • addedOutput schema / properties / like_count / title
      Added value: +"Like Count"
    • addedOutput schema / properties / media_count / title
      Added value: +"Media Count"
    • addedOutput schema / properties / media_items / items / properties / cover_image_url / title
      Added value: +"Cover Image Url"
    • addedOutput schema / properties / media_items / items / properties / duration_ms / title
      Added value: +"Duration Ms"
    • addedOutput schema / properties / media_items / items / properties / height / title
      Added value: +"Height"
    • addedOutput schema / properties / media_items / items / properties / media_id / title
      Added value: +"Media Id"
    • addedOutput schema / properties / media_items / items / properties / media_type / title
      Added value: +"Media Type"
    • addedOutput schema / properties / media_items / items / properties / video_url / title
      Added value: +"Video Url"
    • addedOutput schema / properties / media_items / items / properties / width / title
      Added value: +"Width"
    • addedOutput schema / properties / media_items / items / title
      Added value: +"XMediaItemData"
    • addedOutput schema / properties / media_items / title
      Added value: +"Media Items"
    • addedOutput schema / properties / mentioned_users / items / properties / name / title
      Added value: +"Name"
    • addedOutput schema / properties / mentioned_users / items / properties / user_id / title
      Added value: +"User Id"
    • addedOutput schema / properties / mentioned_users / items / properties / username / title
      Added value: +"Username"
    • addedOutput schema / properties / mentioned_users / items / title
      Added value: +"XMentionedUserData"
    • addedOutput schema / properties / mentioned_users / title
      Added value: +"Mentioned Users"
    • addedOutput schema / properties / post_id / title
      Added value: +"Post Id"
    • addedOutput schema / properties / post_type / title
      Added value: +"Post Type"
    • addedOutput schema / properties / post_url / title
      Added value: +"Post Url"
    • addedOutput schema / properties / publish_time / title
      Added value: +"Publish Time"
    • addedOutput schema / properties / quote_count / title
      Added value: +"Quote Count"
    • changedOutput schema / 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 / reply_count / title
      Added value: +"Reply Count"
    • addedOutput schema / properties / reply_to_post_id / title
      Added value: +"Reply To Post Id"
    • addedOutput schema / properties / repost_count / title
      Added value: +"Repost Count"
    • changedOutput schema / 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 / text / title
      Added value: +"Text"
    • addedOutput schema / properties / topic_tags / items / properties / name / title
      Added value: +"Name"
    • addedOutput schema / properties / topic_tags / items / title
      Added value: +"XTopicTagData"
    • addedOutput schema / properties / topic_tags / title
      Added value: +"Topic Tags"
    • addedOutput schema / properties / view_count / title
      Added value: +"View Count"
    • addedOutput schema / title
      Added value: +"XPostDetailData"
  4. First observed

TDQS

A4/5.0
Behavior3/5

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

Annotations already declare readOnlyHint=true and openWorldHint=true, so safety and external-reach are covered. The description adds only the qualifier that results are limited to public posts; it says nothing about rate limits, auth, or what happens for private/suspended accounts.

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

Conciseness5/5

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

Two short clauses, action first, constraint second, with zero filler. Every phrase carries operational meaning.

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

Completeness4/5

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

For a single-parameter read tool with a full output schema and rich annotations, this is close to sufficient — the selection rule and input format are both covered. The only gap is the undefined behavior for non-public or invalid post IDs, which an agent may need when the call fails.

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 coverage is 100% and the post_id property description is already detailed (numeric string, copy from search/detail/quoted/reposted results, no links or usernames). The description merely restates the no-link constraint, adding little 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?

States a specific verb and resource — retrieve public post detail by X post ID — and immediately scopes it against the URL-based variant with “不要传帖子链接”. An agent can tell this apart from x_get_post_detail_by_post_url without opening either schema.

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?

Gives an explicit selection rule (“已知 post_id 时优先使用”) plus a prohibition on passing links, which effectively routes the agent to the URL sibling. It stops short of naming that sibling tool or stating any fallback behavior when the post_id is invalid or the post is non-public.

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