Skip to main content
Glama

SocialDataX 微博 Weibo MCP

by com.52choujiang
OverviewDiscussionsAdmin

weibo_get_post_detail_by_post_url

Read-only

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

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
post_urlYes微博帖子页面链接、头条文章链接（ttarticle/p/show?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. Changed1 schema field changed
    • changedInput schema / properties / post_url / description
      Previous value: -"微博帖子页面链接、短链接或包含帖子链接的分享文案；不要传用户主页链接或 post_id。"New value: +"微博帖子页面链接、头条文章链接（ttarticle/p/show?id=...）、短链接或包含链接的分享文案；文章详情返回文章正文，评论、点赞和转发使用文章关联的微博帖子；不要传用户主页链接或 post_id。"
  4. 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"
+]
  5. 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"
+]
  6. 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"
+]
  7. Changed1 schema field changed
    • changedOutput schema / properties / play_count / description
      Previous value: -"播放数；不可用时为 null。"New value: +"帖子内视频播放数；没有视频或上游未返回时为 null，不是帖子浏览数。"
  8. 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 safety profile is covered. The description adds no further behavioral details, such as handling of article links or error conditions. The parameter description mentions article behavior, but that is not part of the tool description itself. Given the annotations, a 3 is appropriate as the description does not contradict or add significant behavior beyond the read-only nature.

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, concise sentence that immediately conveys the tool's function. It has no filler or redundant phrasing, and the key input variations are mentioned upfront.

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?

The tool has an output schema and only one well-documented parameter, so the description does not need to explain return values. It covers the essential purpose and input type sufficiently for a read-only operation. The only slight gap is the lack of explicit alternative tool routing, but that is minor.

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%, with a very detailed post_url parameter description explaining accepted formats, what to avoid, and article link behavior. The tool description merely repeats the input types (link, short link, share text) without adding new meaning. Baseline 3 applies since the schema fully documents the parameter.

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 clearly states the tool retrieves post details from a Weibo post link, short link, or share text. The verb '获取' (get) with the specific resource '帖子详情' (post details) is distinct from sibling tools like weibo_get_post_detail_by_post_id, which uses an ID instead of a URL. It fully distinguishes its purpose.

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 description does not explicitly state when to use this tool versus alternatives. It implies usage when a URL is available, but does not directly mention the by_post_id sibling or any exclusion criteria. The parameter description adds a negative constraint ('do not pass user profile URL or post_id') but no positive routing guidance.

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