Skip to main content
Glama

SocialDataX 微博 Weibo MCP

by com.52choujiang
OverviewDiscussionsAdmin

weibo_get_post_detail_by_post_id

Read-only

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

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
post_idYes微博帖子长 ID；可从搜索、详情、转发或用户帖子列表结果中的 post_id 复用。

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
videoYes视频信息；无视频时为 null。
authorYes帖子作者信息；不可用时为 null。
imagesYes图片列表，包含链接及宽高；无图时为空数组。
pointsYes本次成功调用的积分消耗与调用完成时的账户积分余额。
contentYes微博帖子正文；不可用时为空字符串。
post_idYes微博帖子长 ID，可作为详情、评论、点赞或转发工具输入；查询评论回复时需与同一条一级评论的 comment_id 同时传入。
post_urlYes微博帖子或头条文章页面链接；需要打开帖子网页时优先使用此字段；不可用时为 null；不要自行拼接链接。
image_urlsYes图片链接列表；无图时为空数组。
like_countYes点赞数；不可用时为 null。
play_countYes帖子内视频播放数；没有视频或上游未返回时为 null，不是帖子浏览数。
read_countYes头条文章页阅读数的数值下界；含‘+’或中文单位时是近似值，非精确阅读量；非头条文章或未提供时为 null。
topic_tagsYes微博帖子话题标签列表；无标签时为空数组。
publish_timeYes发布时间，秒级 Unix 时间戳；不可用时为 null。
repost_countYes转发数；不可用时为 null。
comment_countYes评论数；不可用时为 null。
read_count_displayYes头条文章页显示的原始阅读数文本，例如‘102万+’；非头条文章或未提供时为 null。

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changed
    • 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"
+]
  2. Changed1 schema field changed
    • changedOutput schema / properties / post_url / description
      Previous value: -"微博帖子页面链接；需要打开帖子网页时优先使用此字段；不可用时为 null；不要自行拼接链接。"New value: +"微博帖子或头条文章页面链接；需要打开帖子网页时优先使用此字段；不可用时为 null；不要自行拼接链接。"
  3. Changed3 schema fields changed
    • 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"
+]
  4. Changed2 schema fields changed
    • 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"
+]
  5. Changed2 schema fields changed
    • 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"
+]
  6. Changed1 schema field changed
    • changedOutput schema / properties / play_count / description
      Previous value: -"播放数；不可用时为 null。"New value: +"帖子内视频播放数；没有视频或上游未返回时为 null，不是帖子浏览数。"
  7. First observed

TDQS

A3.8/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 the read-only nature is established. The description's 'get' is consistent with those annotations, but it adds no further behavioral context such as auth, rate limits, or pagination. No contradiction exists.

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?

The description is a single, compact sentence with no filler. The key information — the resource and the lookup key — is front-loaded, making it easy for an agent to parse quickly.

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?

Given the low complexity, full output schema, complete parameter documentation, and annotations covering read-only/open-world behavior, the description covers the essential invocation context. It only omits explicit sibling routing, which is a minor gap.

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 parameter is already described as a long ID reusable from other Weibo results. The description merely restates that post_id is the lookup key and adds no additional semantic value beyond the schema.

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

Purpose5/5

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

The description uses a specific verb (获取/get) with a clear resource (微博帖子详情/Weibo post detail) and identifies the lookup key (post_id). This directly distinguishes it from the sibling weibo_get_post_detail_by_post_url and makes the tool's role unambiguous.

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

Usage Guidelines3/5

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

The post_id wording implies the tool should be used when a post ID is already available, but the description does not explicitly state when to prefer this over the by_post_url variant or provide any exclusion conditions. Usage context is implied rather than stated.

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 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