SocialDataX 快手 Kuaishou MCP

kuaishou_get_video_detail_by_url

Read-only

根据快手作品链接、短链接或分享文案获取视频或图片/图集作品详情；不要传用户主页链接。如果上一步结果已返回 photo_id，可直接使用 photo_id 入口。

Input Schema

TableJSON Schema

Name	Required	Description	Default
`url`	Yes	快手作品页链接、短链接或分享文案；不要传用户主页链接。如果上一步结果已返回 photo_id，可直接使用 photo_id 入口。

Output Schema

TableJSON Schema

Name	Required	Description
`video`	Yes	播放资源；视频作品返回播放资源，非视频作品为 null。
`author`	Yes	作品作者信息。
`images`	Yes	图片或图集作品按顺序返回图片列表；视频作品为空数组。
`points`	Yes	本次成功调用的积分消耗与调用完成时的账户积分余额。
`photo_id`	Yes	快手作品 photo_id；可作为后续需要快手作品 photo_id 的工具输入。
`share_url`	Yes	作品分享页链接；不是播放资源或封面资源链接；可作为后续需要快手作品 URL 的工具输入。
`like_count`	Yes	点赞数；不可用时为 null。
`topic_tags`	Yes	作品话题标签列表；无标签时为空数组。
`view_count`	Yes	播放数；不可用时为 null。
`description`	Yes	作者发布文本/作品文案，可能包含话题标签；不可用时为空字符串。
`share_count`	Yes	分享数；不可用时为 null。
`content_type`	Yes	作品内容类型；video 表示视频，image 表示图片或图集。
`publish_time`	Yes	发布时间，秒级 Unix 时间戳；不可用时为 null。
`collect_count`	Yes	收藏数；不可用时为 null。
`comment_count`	Yes	评论数；不可用时为 null。
`cover_image_url`	Yes	封面图资源链接；不是作品分享页或播放资源链接；不可用时为 null。

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedAug 26, 2026

changedOutput schema / properties / video / anyOf

Previous value: -[
-  {
-    "properties": {
-      "duration_ms": {
-        "anyOf": [
-          {
-            "type": "integer"
-          },
-          {
-            "type": "null"
-          }
-        ],
-        "description": "视频时长，毫秒；不可用时为 null。"
-      },
-      "play_url": {
-        "description": "返回 video 对象时为可播放 MP4 资源链接；不是作品分享页链接。复用或分享作品时使用 share_url。",
-        "type": "string"
-      }
-    },
-    "required": [
-      "play_url",
-      "duration_ms"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "properties": {
+      "duration_ms": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "视频时长，毫秒；不可用时为 null。"
+      },
+      "height": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "视频高度，像素；不可用时为 null。"
+      },
+      "play_url": {
+        "description": "返回 video 对象时为可播放 MP4 资源链接；不是作品分享页链接。复用或分享作品时使用 share_url。",
+        "type": "string"
+      },
+      "width": {
+        "anyOf": [
+          {
+            "type": "integer"
+          },
+          {
+            "type": "null"
+          }
+        ],
+        "description": "视频宽度，像素；不可用时为 null。"
+      }
+    },
+    "required": [
+      "play_url",
+      "duration_ms",
+      "width",
+      "height"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

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: -[
-  "photo_id",
-  "content_type",
-  "description",
-  "publish_time",
-  "cover_image_url",
-  "images",
-  "video",
-  "share_url",
-  "like_count",
-  "comment_count",
-  "view_count",
-  "collect_count",
-  "share_count",
-  "topic_tags",
-  "author"
-]New value: +[
+  "photo_id",
+  "content_type",
+  "description",
+  "publish_time",
+  "cover_image_url",
+  "images",
+  "video",
+  "share_url",
+  "like_count",
+  "comment_count",
+  "view_count",
+  "collect_count",
+  "share_count",
+  "topic_tags",
+  "author",
+  "points"
+]

Changed3 schema fields changedAug 4, 2026

changedOutput schema / properties / content_type / description

Previous value: -"作品内容类型；video 表示视频，image 表示图集。"New value: +"作品内容类型；video 表示视频，image 表示图片或图集。"

changedOutput schema / properties / images / description

Previous value: -"图集作品按顺序返回完整图片列表；视频作品为空数组。"New value: +"图片或图集作品按顺序返回图片列表；视频作品为空数组。"

changedOutput schema / properties / video / description

Previous value: -"播放资源；视频作品返回播放资源，图集作品为 null。"New value: +"播放资源；视频作品返回播放资源，非视频作品为 null。"

Changed2 schema fields changedJul 8, 2026

changedOutput schema / properties / author / properties / profile_url / description

Previous value: -"快手用户主页链接；不是作品分享页链接；可作为后续需要快手用户主页 URL 的工具输入；如果是 live 主页且 user_id 为空，不要用于用户作品列表；不可用时为 null。"New value: +"快手用户主页链接；不是作品分享页链接；可作为后续需要快手用户主页 URL 的工具输入；查询用户作品列表时需确认同一用户结果包含非空 user_id；不可用时为 null。"

changedOutput schema / properties / author / properties / user_id / description

Previous value: -"快手用户 user_id；非空时可作为后续需要快手用户 user_id 的工具输入；部分 live 主页资料返回时 user_id 为空字符串，为空时不要作为后续 user_id 输入。"New value: +"快手用户 user_id；非空时可作为后续需要快手用户 user_id 的工具输入；为空字符串时不要作为后续 user_id 输入。"

Changed2 schema fields changedJul 7, 2026

changedOutput schema / properties / author / properties / profile_url / description

Previous value: -"快手用户主页链接；不是作品分享页链接；可作为后续需要快手用户主页 URL 的工具输入；不可用时为 null。"New value: +"快手用户主页链接；不是作品分享页链接；可作为后续需要快手用户主页 URL 的工具输入；如果是 live 主页且 user_id 为空，不要用于用户作品列表；不可用时为 null。"

changedOutput schema / properties / author / properties / user_id / description

Previous value: -"快手用户 user_id；可作为后续需要快手用户 user_id 的工具输入。"New value: +"快手用户 user_id；非空时可作为后续需要快手用户 user_id 的工具输入；部分 live 主页资料返回时 user_id 为空字符串，为空时不要作为后续 user_id 输入。"

Changed2 schema fields changedJul 1, 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: -[
-  "photo_id",
-  "content_type",
-  "description",
-  "publish_time",
-  "cover_image_url",
-  "images",
-  "video",
-  "share_url",
-  "like_count",
-  "comment_count",
-  "view_count",
-  "collect_count",
-  "share_count",
-  "author"
-]New value: +[
+  "photo_id",
+  "content_type",
+  "description",
+  "publish_time",
+  "cover_image_url",
+  "images",
+  "video",
+  "share_url",
+  "like_count",
+  "comment_count",
+  "view_count",
+  "collect_count",
+  "share_count",
+  "topic_tags",
+  "author"
+]

Changed6 schema fields changedJun 18, 2026

removedOutput schema / properties / content_type / const
```
Removed value: -"video"
```

changedOutput schema / properties / content_type / description

Previous value: -"作品内容类型。"New value: +"作品内容类型；video 表示视频，image 表示图集。"

addedOutput schema / properties / content_type / enum
```
Added value: +[
+  "video",
+  "image"
+]
```

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

Previous value: -"播放资源；无可播放 play_url 时为 null。"New value: +"播放资源；视频作品返回播放资源，图集作品为 null。"

changedOutput schema / required

Previous value: -[
-  "photo_id",
-  "content_type",
-  "description",
-  "publish_time",
-  "cover_image_url",
-  "video",
-  "share_url",
-  "like_count",
-  "comment_count",
-  "view_count",
-  "collect_count",
-  "share_count",
-  "author"
-]New value: +[
+  "photo_id",
+  "content_type",
+  "description",
+  "publish_time",
+  "cover_image_url",
+  "images",
+  "video",
+  "share_url",
+  "like_count",
+  "comment_count",
+  "view_count",
+  "collect_count",
+  "share_count",
+  "author"
+]

Changed3 schema fields changedJun 4, 2026

addedOutput schema / properties / publish_time

Added value: +{
+  "anyOf": [
+    {
+      "type": "integer"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "description": "发布时间，秒级 Unix 时间戳；不可用时为 null。"
+}

removedOutput schema / properties / publish_time_ms

Removed value: -{
-  "anyOf": [
-    {
-      "type": "integer"
-    },
-    {
-      "type": "null"
-    }
-  ],
-  "description": "发布时间戳，毫秒；不可用时为 null。"
-}

changedOutput schema / required

Previous value: -[
-  "photo_id",
-  "content_type",
-  "description",
-  "publish_time_ms",
-  "cover_image_url",
-  "video",
-  "share_url",
-  "like_count",
-  "comment_count",
-  "view_count",
-  "collect_count",
-  "share_count",
-  "author"
-]New value: +[
+  "photo_id",
+  "content_type",
+  "description",
+  "publish_time",
+  "cover_image_url",
+  "video",
+  "share_url",
+  "like_count",
+  "comment_count",
+  "view_count",
+  "collect_count",
+  "share_count",
+  "author"
+]

First observedJun 3, 2026

TDQS

A4.2/5.0

Behavior3/5

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

Annotations already declare readOnlyHint=true, indicating this is a safe read operation. The description adds context about the input types (link, short link, share text) and the content types (video or image/album), but does not disclose any other behavioral traits such as error handling, pagination, or rate limits. Given the annotation coverage, the description provides adequate but not exceptional behavioral disclosure.

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 concise, comprising two sentences that front-load the primary action, then state the exclusion and the alternative. Every sentence carries essential information without redundancy, and the structure is clean and easy to parse.

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 there is an output schema (so return values are already defined), the description covers the key inputs and exclusions. It mentions the tool handles both videos and image/albums, and directs to the photo_id alternative, which is sufficient for a one-parameter read-only tool. Minor omissions like error behavior are not critical given the annotations and output schema.

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% — the 'url' parameter is fully described in the schema with the same text as the tool description. The description adds no additional meaning beyond what the schema already provides, so the baseline of 3 applies. It does not clarify format requirements or edge cases 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 clearly states that the tool retrieves video or image/album details from a Kuaishou work link, short link, or share text, and explicitly excludes user profile links. It also references the alternative photo_id-based entry point, which distinguishes it from the sibling kuaishou_get_video_detail_by_photo_id. This makes the purpose unambiguous and distinct.

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

Usage Guidelines5/5

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

The description gives explicit instructions: use this tool when you have a URL, and if you already have a photo_id, use the photo_id entry point instead. It also warns not to pass user profile links, which implies that user-related tools (e.g., get_user_info_by_profile_url) are for that purpose. These directives effectively route the agent to the correct tool among the many siblings.

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

All SocialDataX 快手 Kuaishou 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?