SocialDataX 快手 Kuaishou MCP

kuaishou_get_user_posted_videos_by_user_id

Read-only

根据快手用户非空 user_id 获取公开作品列表。

Input Schema

TableJSON Schema

Name	Required	Description	Default
`user_id`	Yes	快手用户非空 user_id；可从包含非空 user_id 的快手用户或作者结果中复用；如果上一步结果里的 user_id 为空字符串，不要使用 user_id 入口。
`page_token`	No	用户作品分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一用户作品分页链路，不能跨能力或用户复用。

Output Schema

TableJSON Schema

Name	Required	Description
`items`	Yes	当前页该用户发布的作品列表。
`points`	Yes	本次成功调用的积分消耗与调用完成时的账户积分余额。
`next_page_token`	Yes	下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论或搜索链路复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedSep 9, 2026

changedOutput schema / properties / items / items / properties / content_type / description

Previous value: -"作品内容类型；当前搜索和用户作品列表固定返回 video。"New value: +"作品内容类型；当前用户作品列表固定返回 video。"

Changed1 schema field changedSep 8, 2026

changedOutput schema / properties / items / items / properties / content_type / description

Previous value: -"作品内容类型；当前用户作品列表固定返回 video。"New value: +"作品内容类型；当前搜索和用户作品列表固定返回 video。"

Changed1 schema field changedSep 8, 2026

changedOutput schema / properties / items / items / properties / content_type / description

Previous value: -"作品内容类型；当前搜索和用户作品列表固定返回 video。"New value: +"作品内容类型；当前用户作品列表固定返回 video。"

Changed1 schema field changedSep 4, 2026

changedOutput schema / properties / items / items / properties / content_type / description

Previous value: -"作品内容类型；当前搜索和用户作品列表来自 PC 列表面，固定返回 video。"New value: +"作品内容类型；当前搜索和用户作品列表固定返回 video。"

Changed1 schema field changedAug 26, 2026

changedOutput schema / properties / items / items / 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: -[
-  "items",
-  "next_page_token"
-]New value: +[
+  "items",
+  "next_page_token",
+  "points"
+]

Changed2 schema fields changedJul 8, 2026

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

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

changedOutput schema / properties / items / items / 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 输入。"

Changed3 schema fields changedJul 7, 2026

changedInput schema / properties / user_id / description

Previous value: -"快手用户 user_id；可从包含 user_id 的快手用户或作者结果中复用。"New value: +"快手用户非空 user_id；可从包含非空 user_id 的快手用户或作者结果中复用；如果上一步结果里的 user_id 为空字符串，不要使用 user_id 入口。"

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

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

changedOutput schema / properties / items / items / 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 / items / items / properties / topic_tags

Added value: +{
+  "description": "作品话题标签列表；无标签时为空数组。",
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "name": {
+        "description": "话题标签名称。",
+        "type": "string"
+      }
+    },
+    "required": [
+      "name"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

changedOutput schema / properties / items / items / required

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

Changed1 schema field changedJun 18, 2026

changedOutput schema / properties / items / items / properties / content_type / description

Previous value: -"作品内容类型；当前固定返回 video。"New value: +"作品内容类型；当前搜索和用户作品列表来自 PC 列表面，固定返回 video。"

Changed2 schema fields changedJun 4, 2026

changedInput schema / properties / page_token / description

Previous value: -"用户作品分页令牌。首次请求留空；继续翻页时传入上一页返回的 next_page_token。"New value: +"用户作品分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一用户作品分页链路，不能跨能力或用户复用。"

changedOutput schema / properties / next_page_token / description

Previous value: -"下一页分页令牌；为空表示没有更多结果。"New value: +"下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论或搜索链路复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"

Changed3 schema fields changedJun 4, 2026

addedOutput schema / properties / items / items / properties / publish_time

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

removedOutput schema / properties / items / items / properties / publish_time_ms

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

changedOutput schema / properties / items / items / required

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

First observedJun 3, 2026

TDQS

A3.5/5.0

Behavior3/5

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

readOnlyHint and openWorldHint already cover the read-only nature, and the description adds the 'public works' scope. However, it does not mention pagination behavior, rate limits, errors, or authorization expectations.

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 clear sentence with no filler. The key constraint and purpose are front-loaded and immediately usable.

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?

The description covers the core purpose and the schema covers pagination via page_token, but it does not explain when to prefer this tool over the profile_url sibling, and it omits behavioral details such as errors, rate limits, or expected output shape.

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 complete for both parameterskele. The description restates the non-empty user_id condition but adds little beyond the schema's own parameter documentation.

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 clearly states the operation: get a user's public video list using a non-empty user_id. It names the verb, resource, and input condition, though it relies on the tool name for the by-user_id distinction.

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 gives the key selection condition (user_id, not profile_url) and the non-empty constraint, but it does not explicitly guide the agent to sibling tools like the profile-url-based variant.

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?