SocialDataX 快手 Kuaishou MCP

kuaishou_get_video_detail_by_photo_id

Read-only

根据快手作品 photo_id 获取视频或图片/图集作品详情。

Input Schema

TableJSON Schema

Name	Required	Description	Default
`photo_id`	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"
+  }
+]

Changed1 schema field changedAug 24, 2026

changedInput schema / properties / photo_id / description

Previous value: -"快手作品 photo_id；可从包含 photo_id 的快手作品结果中复用。"New value: +"快手作品 photo_id；用户已提供时直接使用，否则可从包含 photo_id 的快手作品结果中复用。"

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.5/5.0

Behavior4/5

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

Annotations already declare readOnlyHint=true, so the safety profile is covered. The description adds useful behavioral context by stating the tool supports not only videos but also images and albums, which is not obvious from the tool name alone. There is no contradiction with the read-only annotation.

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, front-loaded sentence that conveys the tool's core function and content-type scope without any filler. Every phrase earns its place.

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

Completeness5/5

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

With only one required parameter, a fully descriptive schema, read-only/open-world annotations, and an output schema present, the description is complete for an agent to select and invoke this tool correctly. Nothing critical is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, providing the baseline of 3. The parameter description adds value by explaining when to use a directly provided photo_id versus reusing one from existing Kuaishou result data, which is more than a bare type definition.

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 states a specific verb ('获取'/'get') and resource ('快手作品 photo_id' details), and clarifies that it covers video, image, and album works. The 'by_photo_id' identifier in both name and description distinguishes it clearly from sibling tools like kuaishou_get_video_detail_by_url.

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

Usage Guidelines4/5

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

The description makes clear this tool is for retrieving details when a photo_id is available, and the parameter description adds practical guidance: use directly if the user provided it, otherwise reuse a photo_id from prior Kuaishou result data. It does not explicitly name alternative sibling tools or state when not to use it, but the context is clear.

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?