SocialDataX 微博 Weibo MCP

weibo_get_post_detail_by_post_id

Read-only

根据 post_id 获取微博帖子详情。

Input Schema

Name	Required	Description	Default
`post_id`	Yes	微博帖子长 ID；可从搜索、详情、转发或用户帖子列表结果中的 post_id 复用。

Output Schema

Name	Required	Description
`video`	Yes	视频信息；无视频时为 null。
`author`	Yes	帖子作者信息；不可用时为 null。
`images`	Yes	图片列表，包含链接及宽高；无图时为空数组。
`points`	Yes	本次成功调用的积分消耗与账户积分余额。
`content`	Yes	微博帖子正文；不可用时为空字符串。
`post_id`	Yes	微博帖子长 ID，可作为详情、评论、点赞或转发工具输入；查询评论回复时需与同一条一级评论的 comment_id 同时传入。
`post_url`	Yes	微博帖子或头条文章页面链接；需要打开帖子网页时优先使用此字段；不可用时为 null；不要自行拼接链接。
`image_urls`	Yes	图片链接列表；无图时为空数组。
`like_count`	Yes	点赞数；不可用时为 null。
`play_count`	Yes	帖子内视频播放数；没有视频或上游未返回时为 null，不是帖子浏览数。
`read_count`	Yes	头条文章页阅读数的数值下界；含‘+’或中文单位时是近似值，非精确阅读量；非头条文章或未提供时为 null。
`topic_tags`	Yes	微博帖子话题标签列表；无标签时为空数组。
`publish_time`	Yes	发布时间，秒级 Unix 时间戳；不可用时为 null。
`repost_count`	Yes	转发数；不可用时为 null。
`comment_count`	Yes	评论数；不可用时为 null。
`read_count_display`	Yes	头条文章页显示的原始阅读数文本，例如‘102万+’；非头条文章或未提供时为 null。

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedNov 4, 2026

changedOutput schema / properties / points / description

Previous value: -"本次成功调用的积分消耗与调用完成时的账户积分余额。"New value: +"本次成功调用的积分消耗与账户积分余额。"

changedOutput schema / properties / points / properties / balance / description

Previous value: -"本次接口完成时看到的当前积分余额，可为负数。"New value: +"优先返回调用完成时查询到的账户积分余额。查询失败时，回退到本次预扣后的余额快照。余额可为负数。"

Changed2 schema fields changedNov 4, 2026
- changedOutput schema / properties / points / properties / balance / description
```
Previous value: -"本次接口完成时看到的当前积分余额。"New value: +"本次接口完成时看到的当前积分余额，可为负数。"
```
- removedOutput schema / properties / points / properties / balance / minimum
```
Removed value: -0
```

Changed22 schema fields changedNov 3, 2026

changedOutput schema / properties / author / anyOf

Previous value: -[
-  {
-    "properties": {
-      "avatar_url": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "头像链接；不可用时为 null。"
-      },
-      "name": {
-        "description": "微博用户名称；不可用时为空字符串。",
-        "type": "string"
-      },
-      "profile_url": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "微博用户主页链接；可用于打开用户主页；不可用时为 null；需要继续查询用户资料或用户帖子列表时优先使用非空 user_id。"
-      },
-      "user_id": {
-        "description": "微博用户 user_id；不可用时为空字符串；非空时可作为用户资料或用户帖子列表工具输入。",
-        "type": "string"
-      }
-    },
-    "required": [
-      "user_id",
-      "name",
-      "avatar_url",
-      "profile_url"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "properties": {
+      "avatar_url": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "头像链接；不可用时为 null。",
+        "title": "Avatar Url"
+      },
+      "name": {
+        "description": "微博用户名称；不可用时为空字符串。",
+        "title": "Name",
+        "type": "string"
+      },
+      "profile_url": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "微博用户主页链接；可用于打开用户主页；不可用时为 null；需要继续查询用户资料或用户帖子列表时优先使用非空 user_id。",
+        "title": "Profile Url"
+      },
+      "user_id": {
+        "description": "微博用户 user_id；不可用时为空字符串；非空时可作为用户资料或用户帖子列表工具输入。",
+        "title": "User Id",
+        "type": "string"
+      }
+    },
+    "required": [
+      "user_id",
+      "name",
+      "avatar_url",
+      "profile_url"
+    ],
+    "title": "WeiboAuthorData",
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

addedOutput schema / properties / comment_count / title
```
Added value: +"Comment Count"
```
addedOutput schema / properties / content / title
```
Added value: +"Content"
```
addedOutput schema / properties / image_urls / title
```
Added value: +"Image Urls"
```
addedOutput schema / properties / images / items / properties / height / title
```
Added value: +"Height"
```
addedOutput schema / properties / images / items / properties / url / title
```
Added value: +"Url"
```
addedOutput schema / properties / images / items / properties / width / title
```
Added value: +"Width"
```
addedOutput schema / properties / images / items / title
```
Added value: +"WeiboImageData"
```
addedOutput schema / properties / images / title
```
Added value: +"Images"
```
addedOutput schema / properties / like_count / title
```
Added value: +"Like Count"
```
addedOutput schema / properties / play_count / title
```
Added value: +"Play Count"
```
addedOutput schema / properties / post_id / title
```
Added value: +"Post Id"
```
addedOutput schema / properties / post_url / title
```
Added value: +"Post Url"
```
addedOutput schema / properties / publish_time / title
```
Added value: +"Publish Time"
```
addedOutput schema / properties / read_count / title
```
Added value: +"Read Count"
```
addedOutput schema / properties / read_count_display / title
```
Added value: +"Read Count Display"
```
addedOutput schema / properties / repost_count / title
```
Added value: +"Repost Count"
```
addedOutput schema / properties / topic_tags / items / properties / name / title
```
Added value: +"Name"
```
addedOutput schema / properties / topic_tags / items / title
```
Added value: +"WeiboTopicTagData"
```
addedOutput schema / properties / topic_tags / title
```
Added value: +"Topic Tags"
```

changedOutput schema / properties / video / anyOf

Previous value: -[
-  {
-    "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": "视频像素高度；不可用时为 null。"
-      },
-      "orientation": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "视频方向信息；不可用时为 null。"
-      },
-      "title": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "视频标题；不可用时为 null。"
-      },
-      "video_id": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "微博视频 ID；不可用时为 null。"
-      },
-      "video_page_url": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "微博视频页面链接；不可用时为 null。"
-      },
-      "video_url": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "视频播放链接；不可用时为 null。"
-      },
-      "width": {
-        "anyOf": [
-          {
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "视频像素宽度；不可用时为 null。"
-      }
-    },
-    "required": [
-      "video_page_url",
-      "title",
-      "video_id",
-      "duration_ms",
-      "video_url",
-      "cover_image_url",
-      "orientation",
-      "width",
-      "height"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "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": "视频像素高度；不可用时为 null。",
+        "title": "Height"
+      },
+      "orientation": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "视频方向信息；不可用时为 null。",
+        "title": "Orientation"
+      },
+      "title": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "视频标题；不可用时为 null。",
+        "title": "Title"
+      },
+      "video_id": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "微博视频 ID；不可用时为 null。",
+        "title": "Video Id"
+      },
+      "video_page_url": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "微博视频页面链接；不可用时为 null。",
+        "title": "Video Page Url"
+      },
+      "video_url": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "视频播放链接；不可用时为 null。",
+        "title": "Video Url"
+      },
+      "width": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "视频像素宽度；不可用时为 null。",
+        "title": "Width"
+      }
+    },
+    "required": [
+      "video_page_url",
+      "title",
+      "video_id",
+      "duration_ms",
+      "video_url",
+      "cover_image_url",
+      "orientation",
+      "width",
+      "height"
+    ],
+    "title": "WeiboVideoData",
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

addedOutput schema / title
```
Added value: +"WeiboPostDetailData"
```

Changed3 schema fields changedSep 18, 2026

addedOutput schema / properties / read_count

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "头条文章页阅读数的数值下界；含‘+’或中文单位时是近似值，非精确阅读量；非头条文章或未提供时为 null。"
+}

addedOutput schema / properties / read_count_display

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "头条文章页显示的原始阅读数文本，例如‘102万+’；非头条文章或未提供时为 null。"
+}

changedOutput schema / required

Previous value: -[
-  "post_id",
-  "content",
-  "publish_time",
-  "post_url",
-  "like_count",
-  "comment_count",
-  "repost_count",
-  "play_count",
-  "image_urls",
-  "images",
-  "topic_tags",
-  "author",
-  "video",
-  "points"
-]New value: +[
+  "post_id",
+  "content",
+  "publish_time",
+  "post_url",
+  "like_count",
+  "comment_count",
+  "repost_count",
+  "play_count",
+  "read_count",
+  "read_count_display",
+  "image_urls",
+  "images",
+  "topic_tags",
+  "author",
+  "video",
+  "points"
+]

Changed1 schema field changedSep 16, 2026

changedOutput schema / properties / post_url / description

Previous value: -"微博帖子页面链接；需要打开帖子网页时优先使用此字段；不可用时为 null；不要自行拼接链接。"New value: +"微博帖子或头条文章页面链接；需要打开帖子网页时优先使用此字段；不可用时为 null；不要自行拼接链接。"

Changed3 schema fields changedAug 26, 2026

addedOutput schema / properties / images

Added value: +{
+  "description": "图片列表，包含链接及宽高；无图时为空数组。",
+  "items": {
+    "properties": {
+      "height": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "图片高度，像素；不可用时为 null。"
+      },
+      "url": {
+        "description": "图片链接。",
+        "type": "string"
+      },
+      "width": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "图片宽度，像素；不可用时为 null。"
+      }
+    },
+    "required": [
+      "url",
+      "width",
+      "height"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

changedOutput schema / properties / video / anyOf

Previous value: -[
-  {
-    "properties": {
-      "cover_image_url": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "视频封面图链接；不可用时为 null。"
-      },
-      "duration_ms": {
-        "anyOf": [
-          {
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "视频时长，单位毫秒；不可用时为 null。"
-      },
-      "orientation": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "视频方向信息；不可用时为 null。"
-      },
-      "title": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "视频标题；不可用时为 null。"
-      },
-      "video_id": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "微博视频 ID；不可用时为 null。"
-      },
-      "video_page_url": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "微博视频页面链接；不可用时为 null。"
-      },
-      "video_url": {
-        "anyOf": [
-          {
-            "type": "string"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "视频播放链接；不可用时为 null。"
-      }
-    },
-    "required": [
-      "video_page_url",
-      "title",
-      "video_id",
-      "duration_ms",
-      "video_url",
-      "cover_image_url",
-      "orientation"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "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": "视频像素高度；不可用时为 null。"
+      },
+      "orientation": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "视频方向信息；不可用时为 null。"
+      },
+      "title": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "视频标题；不可用时为 null。"
+      },
+      "video_id": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "微博视频 ID；不可用时为 null。"
+      },
+      "video_page_url": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "微博视频页面链接；不可用时为 null。"
+      },
+      "video_url": {
+        "anyOf": [
+          {
+            "type": "string"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "视频播放链接；不可用时为 null。"
+      },
+      "width": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "视频像素宽度；不可用时为 null。"
+      }
+    },
+    "required": [
+      "video_page_url",
+      "title",
+      "video_id",
+      "duration_ms",
+      "video_url",
+      "cover_image_url",
+      "orientation",
+      "width",
+      "height"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

changedOutput schema / required

Previous value: -[
-  "post_id",
-  "content",
-  "publish_time",
-  "post_url",
-  "like_count",
-  "comment_count",
-  "repost_count",
-  "play_count",
-  "image_urls",
-  "topic_tags",
-  "author",
-  "video",
-  "points"
-]New value: +[
+  "post_id",
+  "content",
+  "publish_time",
+  "post_url",
+  "like_count",
+  "comment_count",
+  "repost_count",
+  "play_count",
+  "image_urls",
+  "images",
+  "topic_tags",
+  "author",
+  "video",
+  "points"
+]

Changed2 schema fields changedAug 17, 2026

addedOutput schema / properties / points

Added value: +{
+  "additionalProperties": false,
+  "description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
+  "properties": {
+    "balance": {
+      "description": "本次接口完成时看到的当前积分余额。",
+      "minimum": 0,
+      "type": "integer"
+    },
+    "cost": {
+      "description": "本次请求最终确认消耗的积分。",
+      "minimum": 0,
+      "type": "integer"
+    }
+  },
+  "required": [
+    "cost",
+    "balance"
+  ],
+  "type": "object"
+}

changedOutput schema / required

Previous value: -[
-  "post_id",
-  "content",
-  "publish_time",
-  "post_url",
-  "like_count",
-  "comment_count",
-  "repost_count",
-  "play_count",
-  "image_urls",
-  "topic_tags",
-  "author",
-  "video"
-]New value: +[
+  "post_id",
+  "content",
+  "publish_time",
+  "post_url",
+  "like_count",
+  "comment_count",
+  "repost_count",
+  "play_count",
+  "image_urls",
+  "topic_tags",
+  "author",
+  "video",
+  "points"
+]

Changed2 schema fields changedJul 2, 2026

addedOutput schema / properties / topic_tags

Added value: +{
+  "description": "微博帖子话题标签列表；无标签时为空数组。",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "name": {
+        "description": "话题标签名称。",
+        "type": "string"
+      }
+    },
+    "required": [
+      "name"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

changedOutput schema / required

Previous value: -[
-  "post_id",
-  "content",
-  "publish_time",
-  "post_url",
-  "like_count",
-  "comment_count",
-  "repost_count",
-  "play_count",
-  "image_urls",
-  "author",
-  "video"
-]New value: +[
+  "post_id",
+  "content",
+  "publish_time",
+  "post_url",
+  "like_count",
+  "comment_count",
+  "repost_count",
+  "play_count",
+  "image_urls",
+  "topic_tags",
+  "author",
+  "video"
+]

Changed1 schema field changedJun 24, 2026

changedOutput schema / properties / play_count / description

Previous value: -"播放数；不可用时为 null。"New value: +"帖子内视频播放数；没有视频或上游未返回时为 null，不是帖子浏览数。"

First observedJun 22, 2026

TDQS

C2.7/5.0

Behavior2/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 nothing beyond that — no note on auth requirements, rate limits, whether the post may be deleted or private, or what the detail payload emphasizes (author, metrics, media). With annotations doing all the work, this is a bare restatement.

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 short sentence with zero filler, front-loading the identifier and the action. It is efficient but so terse that concision comes at the cost of any differentiation or guidance.

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

Completeness3/5

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

With an output schema present, return values needn't be explained, and the single required parameter is fully documented in the schema. What's missing is routing context among the many post_id-taking siblings and any behavioral caveat for an openWorld read, which leaves the definition only minimally viable.

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 post_id property already documents itself as the long ID reusable from search, detail, repost, or user-post-list results. The description only repeats the parameter name, adding no format, validity, or error-handling meaning beyond the schema, so the baseline 3 applies.

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

Purpose3/5

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

The description names a verb (获取) and resource (微博帖子详情) plus the identifier used (post_id), so the operation is understandable. However, '根据 post_id 获取微博帖子详情' essentially translates the tool name, and it never distinguishes this from the sibling weibo_get_post_detail_by_post_url, leaving the ID-vs-URL split to be inferred from the names alone.

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

Usage Guidelines2/5

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

There is no when-to-use guidance: nothing says to pick this over weibo_get_post_detail_by_post_url, search results, or the comment/repost/liker list tools that also take post_id. The agent gets no prerequisites, no exclusions, and no alternative routing.

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

All SocialDataX 微博 Weibo MCP tools Inspect

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

Need Help?