SocialDataX 微博 Weibo MCP

weibo_get_post_detail_by_post_url

Read-only

根据微博帖子链接、短链接或分享文案获取帖子详情。

Input Schema

Name	Required	Description	Default
`post_url`	Yes	微博帖子页面链接、头条文章链接（ttarticle/p/show?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；不要自行拼接链接。"

Changed1 schema field changedSep 16, 2026

changedInput schema / properties / post_url / description

Previous value: -"微博帖子页面链接、短链接或包含帖子链接的分享文案；不要传用户主页链接或 post_id。"New value: +"微博帖子页面链接、头条文章链接（ttarticle/p/show?id=...）、短链接或包含链接的分享文案；文章详情返回文章正文，评论、点赞和转发使用文章关联的微博帖子；不要传用户主页链接或 post_id。"

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.9/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 low-risk read profile is covered. The description adds nothing beyond that — the genuinely useful behavioral detail (article links return the article body while comments/likes/reposts operate on the associated Weibo post) is confined to the parameter schema, not the description.

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 well-formed sentence with no filler, and the input variants are front-loaded. It is arguably too terse rather than bloated, which is a completeness issue rather than a structure issue.

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?

An output schema exists, so return values need no explanation, and the sole parameter is fully documented in the schema. Still, for a tool whose name collides with a sibling differing only in identifier type, the description should have stated which identifier form routes here and which does not.

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 single parameter already documents the accepted URL types plus the exclusions. The description merely echoes the accepted input variants without adding syntax, format, or failure-mode detail beyond the schema, so the baseline of 3 applies.

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

Purpose4/5

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

The description names a specific verb (获取帖子详情) and enumerates the accepted input forms (帖子链接、短链接、分享文案), so the resource and scope are clear. However, it does not contrast itself with the close sibling weibo_get_post_detail_by_post_id, leaving the agent to infer the distinction from the tool name 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?

The description says only what the tool does; it gives no when-to-use or when-not-to-use guidance and never names an alternative such as weibo_get_post_detail_by_post_id. The exclusion rules (no profile URLs, no post_id) exist, but they live in the input schema, not the description.

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?