Skip to main content
Glama

SocialDataX 快手 Kuaishou MCP

by com.52choujiang
OverviewDiscussionsAdmin

kuaishou_search_videos

Read-only

搜索快手作品。用户需要按搜索词查找作品时使用；keyword 只传搜索词，不要传作品链接，也不要传用户主页链接、photo_id 或 user_id；已有 photo_id、作品链接或 share_url 时直接使用对应详情或评论工具，无需先调用搜索；支持 page_token 翻页。

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
keywordYes搜索快手作品的搜索词，可传关键词或短语，例如品牌名、话题、人物名或产品名；不要传作品链接，也不要传用户主页链接、photo_id、user_id 或 page_token。已有作品链接或 photo_id 时改用需要快手作品 URL/photo_id 的入口；已有用户主页链接或非空 user_id 时改用需要快手用户主页 URL/user_id 的入口。
page_tokenNo搜索分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一搜索分页链路和同一关键词，不能跨能力、关键词或搜索链路复用。

Output Schema

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

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed4 schema fields changed
    • removedOutput schema / properties / items / items / properties / content_type / const
      Removed value: -"video"
    • changedOutput schema / properties / items / items / properties / content_type / description
      Previous value: -"作品内容类型；当前搜索和用户作品列表固定返回 video。"New value: +"作品内容类型：video 为视频，image 为图片作品。"
    • addedOutput schema / properties / items / items / properties / content_type / enum
      Added value: +[
+  "video",
+  "image"
+]
    • addedOutput schema / properties / items / items / 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"
+}
  2. Changed4 schema fields changed
    • addedOutput schema / properties / items / items / properties / content_type / const
      Added value: +"video"
    • changedOutput schema / properties / items / items / properties / content_type / description
      Previous value: -"作品内容类型；video 表示视频，image 表示图片或图集。"New value: +"作品内容类型；当前搜索和用户作品列表固定返回 video。"
    • removedOutput schema / properties / items / items / properties / content_type / enum
      Removed value: -[
-  "video",
-  "image"
-]
    • removedOutput schema / properties / items / items / properties / images
      Removed 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"
-}
  3. Changed4 schema fields changed
    • removedOutput schema / properties / items / items / properties / content_type / const
      Removed value: -"video"
    • changedOutput schema / properties / items / items / properties / content_type / description
      Previous value: -"作品内容类型；当前搜索和用户作品列表固定返回 video。"New value: +"作品内容类型；video 表示视频，image 表示图片或图集。"
    • addedOutput schema / properties / items / items / properties / content_type / enum
      Added value: +[
+  "video",
+  "image"
+]
    • addedOutput schema / properties / items / items / 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"
+}
  4. Changed1 schema field changed
    • changedOutput schema / properties / items / items / properties / content_type / description
      Previous value: -"作品内容类型；当前搜索和用户作品列表来自 PC 列表面，固定返回 video。"New value: +"作品内容类型；当前搜索和用户作品列表固定返回 video。"
  5. Changed1 schema field changed
    • 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"
+  }
+]
  6. Changed1 schema field changed
    • changedInput schema / properties / keyword / description
      Previous value: -"快手搜索关键词；作品搜索自然语言关键词或短语，例如品牌名、话题、人物名、内容需求；不要传作品链接、用户主页链接、photo_id、user_id 或 page_token 作为 keyword。已有作品链接或 photo_id 时改用需要快手作品 URL/photo_id 的入口；已有用户主页链接或非空 user_id 时改用需要快手用户主页 URL/user_id 的入口。"New value: +"搜索快手作品的搜索词，可传关键词或短语，例如品牌名、话题、人物名或产品名；不要传作品链接，也不要传用户主页链接、photo_id、user_id 或 page_token。已有作品链接或 photo_id 时改用需要快手作品 URL/photo_id 的入口；已有用户主页链接或非空 user_id 时改用需要快手用户主页 URL/user_id 的入口。"
  7. 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: -[
-  "items",
-  "next_page_token"
-]New value: +[
+  "items",
+  "next_page_token",
+  "points"
+]
  8. Changed1 schema field changed
    • changedInput schema / properties / keyword / description
      Previous value: -"快手搜索关键词。传自然语言关键词或短语，例如品牌名、话题、人物名、内容需求；不要传作品链接、用户主页链接、photo_id 或 user_id。已有作品链接或 photo_id 时改用需要快手作品 URL/photo_id 的入口；已有用户主页链接或非空 user_id 时改用需要快手用户主页 URL/user_id 的入口。"New value: +"快手搜索关键词；作品搜索自然语言关键词或短语，例如品牌名、话题、人物名、内容需求；不要传作品链接、用户主页链接、photo_id、user_id 或 page_token 作为 keyword。已有作品链接或 photo_id 时改用需要快手作品 URL/photo_id 的入口；已有用户主页链接或非空 user_id 时改用需要快手用户主页 URL/user_id 的入口。"
  9. Changed2 schema fields changed
    • 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 输入。"
  10. Changed3 schema fields changed
    • changedInput schema / properties / keyword / description
      Previous value: -"快手搜索关键词。传自然语言关键词或短语，例如品牌名、话题、人物名、内容需求；不要传作品链接、用户主页链接、photo_id 或 user_id。已有作品链接或 photo_id 时改用需要快手作品 URL/photo_id 的入口；已有用户主页链接或 user_id 时改用需要快手用户主页 URL/user_id 的入口。"New value: +"快手搜索关键词。传自然语言关键词或短语，例如品牌名、话题、人物名、内容需求；不要传作品链接、用户主页链接、photo_id 或 user_id。已有作品链接或 photo_id 时改用需要快手作品 URL/photo_id 的入口；已有用户主页链接或非空 user_id 时改用需要快手用户主页 URL/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 输入。"
  11. Changed2 schema fields changed
    • 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"
+]
  12. Changed1 schema field changed
    • changedOutput schema / properties / items / items / properties / content_type / description
      Previous value: -"作品内容类型；当前固定返回 video。"New value: +"作品内容类型；当前搜索和用户作品列表来自 PC 列表面，固定返回 video。"
  13. Changed2 schema fields changed
    • 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 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论或搜索链路复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。"
  14. Changed3 schema fields changed
    • 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"
+]
  15. First observed

TDQS

A4.5/5.0
Behavior4/5

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

Annotations declare readOnlyHint=true and openWorldHint=true. The description adds value by explaining pagination behavior (opaque token, must pass back intact) and emphasizing the read-only nature implicitly through search semantics. It doesn't contradict annotations and provides useful operational context beyond the schema, though it could mention that results are read-only (implied) or any rate limits, but the annotation already covers the read-only aspect.

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 two sentences, front-loaded with the core purpose, then the most critical constraints. Every sentence earns its place: the first states when to use, the second states what not to pass and alternatives. No filler, extremely efficient.

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?

For a search tool with an output schema, the description covers all essential aspects: when to use, what to pass (keyword only), what not to pass (links, IDs), how to paginate, and when to use alternatives. Combined with the schema's detailed parameter descriptions and the readOnlyHint annotation, an agent has everything needed to invoke this tool correctly without ambiguity.

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% – both parameters have thorough descriptions in the schema. The description repeats and reinforces the key constraints (don't pass links, page_token must be opaque and intact) but adds minimal new information beyond what the schema already provides. The baseline for high schema coverage is 3, and the description doesn't significantly elevate it.

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's purpose: searching Kuaishou works by keyword. It explicitly distinguishes from siblings like kuaishou_search_users (search users) and the various detail/comment tools by stating when to use this tool versus when to use alternatives (when you already have photo_id, URL, etc.). The verb 'search' and resource 'works' are specific and unambiguous.

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 provides explicit guidance on when to use this tool: when the user needs to find works by search term. It also gives clear exclusions: do not pass links, photo_id, or user_id, and if you already have those identifiers, use the corresponding detail or comment tools instead. Pagination usage is also explained (page_token for subsequent pages). This is exemplary 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 快手 Kuaishou 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