SocialDataX 快手 Kuaishou MCP
Kuaishou hot, suggestions, video/user search, details, comments/replies, profiles/posts, transcript.
我該用這個嗎
品質與安全性
B
發現項目（30）
- HIGHTool poisoning patterns detected
- MEDIUMTool description contains URL to non-standard domain在 socialdatax_get_points_balance 中
- LOWTool 'kuaishou_get_hot_search_list' description lacks action verb在 kuaishou_get_hot_search_list 中
- LOWTool 'kuaishou_search_suggestions' description lacks action verb在 kuaishou_search_suggestions 中
- LOWTool 'kuaishou_get_video_detail_by_url' description lacks action verb在 kuaishou_get_video_detail_by_url 中
- LOWTool 'kuaishou_get_video_detail_by_photo_id' description lacks action verb在 kuaishou_get_video_detail_by_photo_id 中
- LOWTool 'kuaishou_submit_video_speech_text_by_video_url' description lacks action verb在 kuaishou_submit_video_speech_text_by_video_url 中
- LOWTool 'kuaishou_submit_video_speech_text_by_photo_id' description lacks action verb在 kuaishou_submit_video_speech_text_by_photo_id 中
- LOWTool 'kuaishou_get_video_comments_by_photo_id' description lacks action verb在 kuaishou_get_video_comments_by_photo_id 中
- LOWTool 'kuaishou_get_video_comments_by_url' description lacks action verb在 kuaishou_get_video_comments_by_url 中
根據工具定義與協定合規性的自動化分析。
上下文成本
~16,889Token（工具定義）
~7.3 KB典型回應大小
顯著的注意力影響（128k 上下文的 13.19%）
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"kuaishou-insights": {
"url": "https://mcp.52choujiang.com/kuaishou/mcp"
}
}
}遠端端點
https://mcp.52choujiang.com/kuaishou/mcpstreamable-httphttps://mcp.socialdatax.com/kuaishou/mcpstreamable-http它能做什麼
工具清單
工具（17）
🟢 唯讀🟡 寫入🔴 刪除⚪ 未知
🟢kuaishou_get_hot_search_list
获取快手短视频热榜；当前不支持翻页。
輸入結構描述
{
"type": "object",
"properties": {},
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"items": {
"description": "快手短视频热榜条目。",
"items": {
"properties": {
"rank": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "快手短视频热榜排名；当前不可用时为 null。"
},
"keyword": {
"description": "热点标题或热榜词。",
"type": "string"
},
"hot_value": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "热度值；当前不可用时为 null。"
},
"cover_image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "热点封面图；当前不可用时为 null。"
}
},
"required": [
"rank",
"keyword",
"hot_value",
"cover_image_url"
],
"type": "object"
},
"type": "array"
},
"points": {
"type": "object",
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"cost": {
"type": "integer",
"description": "本次请求最终确认消耗的积分。",
"minimum": 0
},
"balance": {
"type": "integer",
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0
}
},
"required": [
"cost",
"balance"
],
"additionalProperties": false
}
},
"required": [
"items",
"points"
]
}🟢kuaishou_search_suggestions(keyword)
根据关键词获取快手普通搜索输入框中的搜索建议；不用于搜索作品或用户。
輸入結構描述
{
"type": "object",
"properties": {
"keyword": {
"description": "获取快手普通搜索输入框中的联想词，可传关键词或短语；不要传作品链接、用户主页链接、photo_id、user_id 或 page_token。",
"type": "string"
}
},
"required": [
"keyword"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"items": {
"description": "快手普通搜索输入框中的联想词列表。",
"items": {
"additionalProperties": false,
"properties": {
"text": {
"description": "普通搜索输入框中的联想词。",
"type": "string"
}
},
"required": [
"text"
],
"type": "object"
},
"type": "array"
},
"points": {
"type": "object",
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"cost": {
"type": "integer",
"description": "本次请求最终确认消耗的积分。",
"minimum": 0
},
"balance": {
"type": "integer",
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0
}
},
"required": [
"cost",
"balance"
],
"additionalProperties": false
}
},
"required": [
"items",
"points"
],
"additionalProperties": false
}🟢kuaishou_get_video_detail_by_url(url)
根据快手作品链接、短链接或分享文案获取视频或图片/图集作品详情；不要传用户主页链接。如果上一步结果已返回 photo_id，可直接使用 photo_id 入口。
輸入結構描述
{
"type": "object",
"properties": {
"url": {
"description": "快手作品页链接、短链接或分享文案；不要传用户主页链接。如果上一步结果已返回 photo_id，可直接使用 photo_id 入口。",
"type": "string"
}
},
"required": [
"url"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"photo_id": {
"description": "快手作品 photo_id；可作为后续需要快手作品 photo_id 的工具输入。",
"type": "string"
},
"content_type": {
"description": "作品内容类型；video 表示视频，image 表示图片或图集。",
"enum": [
"video",
"image"
],
"type": "string"
},
"description": {
"description": "作者发布文本/作品文案，可能包含话题标签；不可用时为空字符串。",
"type": "string"
},
"publish_time": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "发布时间，秒级 Unix 时间戳；不可用时为 null。"
},
"cover_image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "封面图资源链接；不是作品分享页或播放资源链接；不可用时为 null。"
},
"images": {
"description": "图片或图集作品按顺序返回图片列表；视频作品为空数组。",
"items": {
"properties": {
"url": {
"description": "图片展示资源链接；用于查看或分析图片内容。",
"type": "string"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片宽度，像素；不可用时为 null。"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片高度，像素；不可用时为 null。"
}
},
"required": [
"url",
"width",
"height"
],
"type": "object"
},
"type": "array"
},
"video": {
"anyOf": [
{
"properties": {
"play_url": {
"description": "返回 video 对象时为可播放 MP4 资源链接；不是作品分享页链接。复用或分享作品时使用 share_url。",
"type": "string"
},
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频时长，毫秒；不可用时为 null。"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频宽度，像素；不可用时为 null。"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频高度，像素；不可用时为 null。"
}
},
"required": [
"play_url",
"duration_ms",
"width",
"height"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "播放资源；视频作品返回播放资源，非视频作品为 null。"
},
"share_url": {
"description": "作品分享页链接；不是播放资源或封面资源链接；可作为后续需要快手作品 URL 的工具输入。",
"type": "string"
},
"like_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "点赞数；不可用时为 null。"
},
"comment_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "评论数；不可用时为 null。"
},
"view_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "播放数；不可用时为 null。"
},
"collect_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "收藏数；不可用时为 null。"
},
"share_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "分享数；不可用时为 null。"
},
"topic_tags": {
"description": "作品话题标签列表；无标签时为空数组。",
"items": {
"additionalProperties": false,
"properties": {
"name": {
"description": "话题标签名称。",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"type": "array"
},
"author": {
"properties": {
"user_id": {
"description": "快手用户 user_id；非空时可作为后续需要快手用户 user_id 的工具输入；为空字符串时不要作为后续 user_id 输入。",
"type": "string"
},
"name": {
"description": "用户名称。",
"type": "string"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户头像链接；不可用时为 null。"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "快手用户主页链接；不是作品分享页链接；可作为后续需要快手用户主页 URL 的工具输入；查询用户作品列表时需确认同一用户结果包含非空 user_id；不可用时为 null。"
}
},
"required": [
"user_id",
"name",
"avatar_url",
"profile_url"
],
"type": "object",
"description": "作品作者信息。"
},
"points": {
"type": "object",
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"cost": {
"type": "integer",
"description": "本次请求最终确认消耗的积分。",
"minimum": 0
},
"balance": {
"type": "integer",
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0
}
},
"required": [
"cost",
"balance"
],
"additionalProperties": false
}
},
"required": [
"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"
]
}🟢kuaishou_get_video_detail_by_photo_id(photo_id)
根据快手作品 photo_id 获取视频或图片/图集作品详情。
輸入結構描述
{
"type": "object",
"properties": {
"photo_id": {
"description": "快手作品 photo_id；用户已提供时直接使用，否则可从包含 photo_id 的快手作品结果中复用。",
"type": "string"
}
},
"required": [
"photo_id"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"photo_id": {
"description": "快手作品 photo_id；可作为后续需要快手作品 photo_id 的工具输入。",
"type": "string"
},
"content_type": {
"description": "作品内容类型；video 表示视频，image 表示图片或图集。",
"enum": [
"video",
"image"
],
"type": "string"
},
"description": {
"description": "作者发布文本/作品文案，可能包含话题标签；不可用时为空字符串。",
"type": "string"
},
"publish_time": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "发布时间，秒级 Unix 时间戳；不可用时为 null。"
},
"cover_image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "封面图资源链接；不是作品分享页或播放资源链接；不可用时为 null。"
},
"images": {
"description": "图片或图集作品按顺序返回图片列表；视频作品为空数组。",
"items": {
"properties": {
"url": {
"description": "图片展示资源链接；用于查看或分析图片内容。",
"type": "string"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片宽度，像素；不可用时为 null。"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片高度，像素；不可用时为 null。"
}
},
"required": [
"url",
"width",
"height"
],
"type": "object"
},
"type": "array"
},
"video": {
"anyOf": [
{
"properties": {
"play_url": {
"description": "返回 video 对象时为可播放 MP4 资源链接；不是作品分享页链接。复用或分享作品时使用 share_url。",
"type": "string"
},
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频时长，毫秒；不可用时为 null。"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频宽度，像素；不可用时为 null。"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频高度，像素；不可用时为 null。"
}
},
"required": [
"play_url",
"duration_ms",
"width",
"height"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "播放资源；视频作品返回播放资源，非视频作品为 null。"
},
"share_url": {
"description": "作品分享页链接；不是播放资源或封面资源链接；可作为后续需要快手作品 URL 的工具输入。",
"type": "string"
},
"like_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "点赞数；不可用时为 null。"
},
"comment_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "评论数；不可用时为 null。"
},
"view_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "播放数；不可用时为 null。"
},
"collect_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "收藏数；不可用时为 null。"
},
"share_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "分享数；不可用时为 null。"
},
"topic_tags": {
"description": "作品话题标签列表；无标签时为空数组。",
"items": {
"additionalProperties": false,
"properties": {
"name": {
"description": "话题标签名称。",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"type": "array"
},
"author": {
"properties": {
"user_id": {
"description": "快手用户 user_id；非空时可作为后续需要快手用户 user_id 的工具输入；为空字符串时不要作为后续 user_id 输入。",
"type": "string"
},
"name": {
"description": "用户名称。",
"type": "string"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户头像链接；不可用时为 null。"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "快手用户主页链接；不是作品分享页链接；可作为后续需要快手用户主页 URL 的工具输入；查询用户作品列表时需确认同一用户结果包含非空 user_id；不可用时为 null。"
}
},
"required": [
"user_id",
"name",
"avatar_url",
"profile_url"
],
"type": "object",
"description": "作品作者信息。"
},
"points": {
"type": "object",
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"cost": {
"type": "integer",
"description": "本次请求最终确认消耗的积分。",
"minimum": 0
},
"balance": {
"type": "integer",
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0
}
},
"required": [
"cost",
"balance"
],
"additionalProperties": false
}
},
"required": [
"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"
]
}🟡kuaishou_submit_video_speech_text_by_video_url(video_url)
提交快手作品视频口播转文字任务；提交后最多等待 240 秒，未完成时返回 job_id 和下一步查询动作。
輸入結構描述
{
"type": "object",
"properties": {
"video_url": {
"description": "快手作品页链接、短链接或分享文案；不要传用户主页链接。如果上一步结果已返回 photo_id，可直接使用 photo_id 入口。",
"type": "string"
}
},
"required": [
"video_url"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"job_id": {
"description": "任务 ID。",
"type": "string"
},
"status": {
"description": "任务状态。",
"enum": [
"queued",
"running",
"succeeded",
"failed",
"expired"
],
"type": "string"
},
"is_terminal": {
"description": "是否已终态。",
"type": "boolean"
},
"platform": {
"description": "任务所属平台。",
"type": "string"
},
"content_id": {
"description": "平台内容 ID。",
"type": "string"
},
"source_id": {
"description": "任务来源 ID。",
"type": "string"
},
"content_type": {
"description": "内容类型。",
"type": "string"
},
"content_meta": {
"additionalProperties": false,
"properties": {
"content_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作品链接。"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作品标题；平台无标题时为 null。"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "平台作品原始描述、正文或配文。"
},
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "音视频时长，单位毫秒。"
},
"author": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"user_id": {
"description": "作者用户 ID。",
"type": "string"
},
"name": {
"description": "作者昵称。",
"type": "string"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者主页链接。"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者头像链接。"
}
},
"required": [
"user_id",
"name",
"profile_url",
"avatar_url"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "作者信息。"
}
},
"required": [
"content_url",
"title",
"description",
"duration_ms",
"author"
],
"type": "object",
"description": "作品上下文信息，便于结合转写内容做口播分析。"
},
"transcript": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"text": {
"description": "完整口播转文字结果。",
"type": "string"
},
"segments": {
"description": "按时间顺序排列的分段结果。",
"items": {
"additionalProperties": false,
"properties": {
"start_ms": {
"description": "分段开始时间，单位毫秒。",
"minimum": 0,
"type": "integer"
},
"end_ms": {
"description": "分段结束时间，单位毫秒。",
"minimum": 0,
"type": "integer"
},
"text": {
"description": "分段文本。",
"type": "string"
}
},
"required": [
"start_ms",
"end_ms",
"text"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"text",
"segments"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "成功时的口播转文字结果；非终态或失败时为 null。"
},
"error": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"code": {
"description": "稳定错误码。",
"type": "string"
},
"message": {
"description": "面向用户的错误说明。",
"type": "string"
},
"retryable": {
"default": false,
"description": "是否可重试。",
"type": "boolean"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "失败或过期时的稳定错误结构；非终态或成功时为 null。"
},
"next_poll_after_seconds": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "建议下次查询前等待的秒数；非终态时可用。"
},
"next_action": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"tool_name": {
"description": "下一步建议调用的查询工具。",
"type": "string"
},
"job_id": {
"description": "需要继续查询的 job_id。",
"type": "string"
},
"arguments": {
"additionalProperties": true,
"description": "下一步查询工具可直接使用的参数。",
"type": "object"
},
"instruction": {
"description": "给 AI/客户端的查询指令，说明如何继续轮询到终态。",
"type": "string"
}
},
"required": [
"tool_name",
"job_id",
"arguments",
"instruction"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "非终态时建议的下一步查询动作。"
},
"message": {
"description": "面向用户/AI 的状态说明。",
"type": "string"
}
},
"required": [
"job_id",
"status",
"is_terminal",
"platform",
"content_id",
"source_id",
"content_type",
"content_meta",
"transcript",
"error",
"next_poll_after_seconds",
"next_action",
"message"
],
"additionalProperties": false
}🟡kuaishou_submit_video_speech_text_by_photo_id(photo_id)
根据快手 photo_id 提交视频口播转文字任务；提交后最多等待 240 秒，未完成时返回 job_id 和下一步查询动作。
輸入結構描述
{
"type": "object",
"properties": {
"photo_id": {
"description": "快手作品 photo_id；用户已提供时直接使用，否则可从包含 photo_id 的快手作品结果中复用。",
"type": "string"
}
},
"required": [
"photo_id"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"job_id": {
"description": "任务 ID。",
"type": "string"
},
"status": {
"description": "任务状态。",
"enum": [
"queued",
"running",
"succeeded",
"failed",
"expired"
],
"type": "string"
},
"is_terminal": {
"description": "是否已终态。",
"type": "boolean"
},
"platform": {
"description": "任务所属平台。",
"type": "string"
},
"content_id": {
"description": "平台内容 ID。",
"type": "string"
},
"source_id": {
"description": "任务来源 ID。",
"type": "string"
},
"content_type": {
"description": "内容类型。",
"type": "string"
},
"content_meta": {
"additionalProperties": false,
"properties": {
"content_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作品链接。"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作品标题；平台无标题时为 null。"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "平台作品原始描述、正文或配文。"
},
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "音视频时长，单位毫秒。"
},
"author": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"user_id": {
"description": "作者用户 ID。",
"type": "string"
},
"name": {
"description": "作者昵称。",
"type": "string"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者主页链接。"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者头像链接。"
}
},
"required": [
"user_id",
"name",
"profile_url",
"avatar_url"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "作者信息。"
}
},
"required": [
"content_url",
"title",
"description",
"duration_ms",
"author"
],
"type": "object",
"description": "作品上下文信息，便于结合转写内容做口播分析。"
},
"transcript": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"text": {
"description": "完整口播转文字结果。",
"type": "string"
},
"segments": {
"description": "按时间顺序排列的分段结果。",
"items": {
"additionalProperties": false,
"properties": {
"start_ms": {
"description": "分段开始时间，单位毫秒。",
"minimum": 0,
"type": "integer"
},
"end_ms": {
"description": "分段结束时间，单位毫秒。",
"minimum": 0,
"type": "integer"
},
"text": {
"description": "分段文本。",
"type": "string"
}
},
"required": [
"start_ms",
"end_ms",
"text"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"text",
"segments"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "成功时的口播转文字结果；非终态或失败时为 null。"
},
"error": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"code": {
"description": "稳定错误码。",
"type": "string"
},
"message": {
"description": "面向用户的错误说明。",
"type": "string"
},
"retryable": {
"default": false,
"description": "是否可重试。",
"type": "boolean"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "失败或过期时的稳定错误结构；非终态或成功时为 null。"
},
"next_poll_after_seconds": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "建议下次查询前等待的秒数；非终态时可用。"
},
"next_action": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"tool_name": {
"description": "下一步建议调用的查询工具。",
"type": "string"
},
"job_id": {
"description": "需要继续查询的 job_id。",
"type": "string"
},
"arguments": {
"additionalProperties": true,
"description": "下一步查询工具可直接使用的参数。",
"type": "object"
},
"instruction": {
"description": "给 AI/客户端的查询指令，说明如何继续轮询到终态。",
"type": "string"
}
},
"required": [
"tool_name",
"job_id",
"arguments",
"instruction"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "非终态时建议的下一步查询动作。"
},
"message": {
"description": "面向用户/AI 的状态说明。",
"type": "string"
}
},
"required": [
"job_id",
"status",
"is_terminal",
"platform",
"content_id",
"source_id",
"content_type",
"content_meta",
"transcript",
"error",
"next_poll_after_seconds",
"next_action",
"message"
],
"additionalProperties": false
}🟢kuaishou_get_video_speech_text_job(job_id)
查询快手视频口播转文字任务状态；用户已提供有效 job_id 时直接使用，否则使用 submit 工具返回值；不重复提交，每次最多等待 240 秒。
輸入結構描述
{
"type": "object",
"properties": {
"job_id": {
"description": "口播转文字任务的 job_id；用户已提供时直接使用，否则使用提交工具返回的 job_id；不要传 photo_id 或作品链接。",
"type": "string"
}
},
"required": [
"job_id"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"job_id": {
"description": "任务 ID。",
"type": "string"
},
"status": {
"description": "任务状态。",
"enum": [
"queued",
"running",
"succeeded",
"failed",
"expired"
],
"type": "string"
},
"is_terminal": {
"description": "是否已终态。",
"type": "boolean"
},
"platform": {
"description": "任务所属平台。",
"type": "string"
},
"content_id": {
"description": "平台内容 ID。",
"type": "string"
},
"source_id": {
"description": "任务来源 ID。",
"type": "string"
},
"content_type": {
"description": "内容类型。",
"type": "string"
},
"content_meta": {
"additionalProperties": false,
"properties": {
"content_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作品链接。"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作品标题；平台无标题时为 null。"
},
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "平台作品原始描述、正文或配文。"
},
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "音视频时长，单位毫秒。"
},
"author": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"user_id": {
"description": "作者用户 ID。",
"type": "string"
},
"name": {
"description": "作者昵称。",
"type": "string"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者主页链接。"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者头像链接。"
}
},
"required": [
"user_id",
"name",
"profile_url",
"avatar_url"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "作者信息。"
}
},
"required": [
"content_url",
"title",
"description",
"duration_ms",
"author"
],
"type": "object",
"description": "作品上下文信息，便于结合转写内容做口播分析。"
},
"transcript": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"text": {
"description": "完整口播转文字结果。",
"type": "string"
},
"segments": {
"description": "按时间顺序排列的分段结果。",
"items": {
"additionalProperties": false,
"properties": {
"start_ms": {
"description": "分段开始时间，单位毫秒。",
"minimum": 0,
"type": "integer"
},
"end_ms": {
"description": "分段结束时间，单位毫秒。",
"minimum": 0,
"type": "integer"
},
"text": {
"description": "分段文本。",
"type": "string"
}
},
"required": [
"start_ms",
"end_ms",
"text"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"text",
"segments"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "成功时的口播转文字结果；非终态或失败时为 null。"
},
"error": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"code": {
"description": "稳定错误码。",
"type": "string"
},
"message": {
"description": "面向用户的错误说明。",
"type": "string"
},
"retryable": {
"default": false,
"description": "是否可重试。",
"type": "boolean"
}
},
"required": [
"code",
"message"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "失败或过期时的稳定错误结构；非终态或成功时为 null。"
},
"next_poll_after_seconds": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "建议下次查询前等待的秒数；非终态时可用。"
},
"next_action": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"tool_name": {
"description": "下一步建议调用的查询工具。",
"type": "string"
},
"job_id": {
"description": "需要继续查询的 job_id。",
"type": "string"
},
"arguments": {
"additionalProperties": true,
"description": "下一步查询工具可直接使用的参数。",
"type": "object"
},
"instruction": {
"description": "给 AI/客户端的查询指令，说明如何继续轮询到终态。",
"type": "string"
}
},
"required": [
"tool_name",
"job_id",
"arguments",
"instruction"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "非终态时建议的下一步查询动作。"
},
"message": {
"description": "面向用户/AI 的状态说明。",
"type": "string"
}
},
"required": [
"job_id",
"status",
"is_terminal",
"platform",
"content_id",
"source_id",
"content_type",
"content_meta",
"transcript",
"error",
"next_poll_after_seconds",
"next_action",
"message"
],
"additionalProperties": false
}🟢kuaishou_get_video_comments_by_photo_id(photo_id, page_token)
根据快手作品 photo_id 获取一级评论列表。
輸入結構描述
{
"type": "object",
"properties": {
"photo_id": {
"description": "快手作品 photo_id；用户已提供时直接使用，否则可从包含 photo_id 的快手作品结果中复用。",
"type": "string"
},
"page_token": {
"default": "",
"description": "分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一作品评论分页链路，不能跨能力或作品复用。",
"type": "string"
}
},
"required": [
"photo_id"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"items": {
"description": "当前页一级评论列表。",
"items": {
"properties": {
"comment_id": {
"description": "评论 ID；一级评论列表项的 comment_id 可作为后续获取该评论下回复的输入。",
"type": "string"
},
"photo_id": {
"description": "快手作品 photo_id；可作为后续需要快手作品 photo_id 的工具输入。",
"type": "string"
},
"content": {
"description": "评论内容。",
"type": "string"
},
"create_time": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "评论发布时间，秒级 Unix 时间戳；不可用时为 null。"
},
"like_count": {
"description": "评论点赞数。",
"type": "integer"
},
"has_replies": {
"description": "是否有评论回复；has_replies 为 true 时，可使用该评论的 comment_id 获取该一级评论下的回复。",
"type": "boolean"
},
"author": {
"properties": {
"user_id": {
"description": "快手用户 user_id；非空时可作为后续需要快手用户 user_id 的工具输入；为空字符串时不要作为后续 user_id 输入。",
"type": "string"
},
"name": {
"description": "评论作者名称。",
"type": "string"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "评论作者头像链接；不可用时为 null。"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "快手用户主页链接；不是作品分享页链接；可作为后续需要快手用户主页 URL 的工具输入；查询用户作品列表时需确认同一用户结果包含非空 user_id；不可用时为 null。"
}
},
"required": [
"user_id",
"name",
"avatar_url",
"profile_url"
],
"type": "object",
"description": "评论作者信息。"
}
},
"required": [
"comment_id",
"photo_id",
"content",
"create_time",
"like_count",
"has_replies",
"author"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论或搜索链路复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
},
"comment_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "评论总数；不可用时为 null。"
},
"points": {
"type": "object",
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"cost": {
"type": "integer",
"description": "本次请求最终确认消耗的积分。",
"minimum": 0
},
"balance": {
"type": "integer",
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0
}
},
"required": [
"cost",
"balance"
],
"additionalProperties": false
}
},
"required": [
"items",
"next_page_token",
"comment_count",
"points"
]
}🟢kuaishou_get_video_comments_by_url(url, page_token)
根据快手作品链接、短链接或分享文案获取一级评论列表；不要传用户主页链接；查评论时保留原始 URL/文案使用 URL 入口。
輸入結構描述
{
"type": "object",
"properties": {
"url": {
"description": "快手作品页链接、短链接或分享文案；不要传用户主页链接。查评论时如果手里有原始作品链接、短链接或分享文案，保留原始 URL/文案并直接使用 URL 入口。",
"type": "string"
},
"page_token": {
"default": "",
"description": "分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一作品评论分页链路，不能跨能力或作品复用。",
"type": "string"
}
},
"required": [
"url"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"items": {
"description": "当前页一级评论列表。",
"items": {
"properties": {
"comment_id": {
"description": "评论 ID；一级评论列表项的 comment_id 可作为后续获取该评论下回复的输入。",
"type": "string"
},
"photo_id": {
"description": "快手作品 photo_id；可作为后续需要快手作品 photo_id 的工具输入。",
"type": "string"
},
"content": {
"description": "评论内容。",
"type": "string"
},
"create_time": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "评论发布时间，秒级 Unix 时间戳；不可用时为 null。"
},
"like_count": {
"description": "评论点赞数。",
"type": "integer"
},
"has_replies": {
"description": "是否有评论回复；has_replies 为 true 时，可使用该评论的 comment_id 获取该一级评论下的回复。",
"type": "boolean"
},
"author": {
"properties": {
"user_id": {
"description": "快手用户 user_id；非空时可作为后续需要快手用户 user_id 的工具输入；为空字符串时不要作为后续 user_id 输入。",
"type": "string"
},
"name": {
"description": "评论作者名称。",
"type": "string"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "评论作者头像链接；不可用时为 null。"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "快手用户主页链接；不是作品分享页链接；可作为后续需要快手用户主页 URL 的工具输入；查询用户作品列表时需确认同一用户结果包含非空 user_id；不可用时为 null。"
}
},
"required": [
"user_id",
"name",
"avatar_url",
"profile_url"
],
"type": "object",
"description": "评论作者信息。"
}
},
"required": [
"comment_id",
"photo_id",
"content",
"create_time",
"like_count",
"has_replies",
"author"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论或搜索链路复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
},
"comment_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "评论总数；不可用时为 null。"
},
"points": {
"type": "object",
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"cost": {
"type": "integer",
"description": "本次请求最终确认消耗的积分。",
"minimum": 0
},
"balance": {
"type": "integer",
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0
}
},
"required": [
"cost",
"balance"
],
"additionalProperties": false
}
},
"required": [
"items",
"next_page_token",
"comment_count",
"points"
]
}🟢kuaishou_get_video_comment_replies_by_comment_id(photo_id, comment_id, page_token)
根据 photo_id 和一级评论 comment_id 获取评论回复；用户已提供完整合法的 ID 组合时直接使用；已有 photo_id、作品链接或分享文案但缺少必需 ID 时，调用对应一级评论工具补全；缺少作品定位信息时向用户索取；不要传回复项的 comment_id。
輸入結構描述
{
"type": "object",
"properties": {
"photo_id": {
"description": "快手作品 photo_id；用户已提供时直接使用，否则可从包含 photo_id 的快手作品结果中复用。",
"type": "string"
},
"comment_id": {
"description": "一级评论 ID；用户已提供时直接使用，否则可从一级评论结果 items[].comment_id 复制；用于获取该评论下的回复；不要传回复项的 comment_id。",
"type": "string"
},
"page_token": {
"default": "",
"description": "回复分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一作品下同一一级评论的回复分页链路，不能跨能力、作品或评论复用。",
"type": "string"
}
},
"required": [
"photo_id",
"comment_id"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"items": {
"description": "当前页评论回复列表。",
"items": {
"properties": {
"comment_id": {
"description": "评论回复 ID；这是回复项自身的 comment_id，不要作为评论回复入口输入。",
"type": "string"
},
"photo_id": {
"description": "快手作品 photo_id；可作为后续需要快手作品 photo_id 的工具输入。",
"type": "string"
},
"content": {
"description": "评论回复内容。",
"type": "string"
},
"create_time": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "评论回复发布时间，秒级 Unix 时间戳；不可用时为 null。"
},
"like_count": {
"description": "评论回复点赞数。",
"type": "integer"
},
"reply_to_user_name": {
"description": "被回复用户名称；不可用时为空字符串。",
"type": "string"
},
"reply_to_user_id": {
"description": "被回复用户 user_id；非空时可作为后续需要快手用户 user_id 的工具输入；不可用时为空字符串，为空时不要作为后续 user_id 输入。",
"type": "string"
},
"author": {
"properties": {
"user_id": {
"description": "快手用户 user_id；非空时可作为后续需要快手用户 user_id 的工具输入；为空字符串时不要作为后续 user_id 输入。",
"type": "string"
},
"name": {
"description": "评论作者名称。",
"type": "string"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "评论作者头像链接；不可用时为 null。"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "快手用户主页链接；不是作品分享页链接；可作为后续需要快手用户主页 URL 的工具输入；查询用户作品列表时需确认同一用户结果包含非空 user_id；不可用时为 null。"
}
},
"required": [
"user_id",
"name",
"avatar_url",
"profile_url"
],
"type": "object",
"description": "评论回复作者信息。"
}
},
"required": [
"comment_id",
"photo_id",
"content",
"create_time",
"like_count",
"reply_to_user_name",
"reply_to_user_id",
"author"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论或搜索链路复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
},
"points": {
"type": "object",
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"cost": {
"type": "integer",
"description": "本次请求最终确认消耗的积分。",
"minimum": 0
},
"balance": {
"type": "integer",
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0
}
},
"required": [
"cost",
"balance"
],
"additionalProperties": false
}
},
"required": [
"items",
"next_page_token",
"points"
]
}🟢kuaishou_get_user_info_by_user_id(user_id)
根据快手用户非空 user_id 获取用户资料。
輸入結構描述
{
"type": "object",
"properties": {
"user_id": {
"description": "快手用户非空 user_id；可从包含非空 user_id 的快手用户或作者结果中复用；如果上一步结果里的 user_id 为空字符串，不要使用 user_id 入口。",
"type": "string"
}
},
"required": [
"user_id"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"user_id": {
"description": "快手用户非空 user_id；可作为后续需要快手用户 user_id 的工具输入。",
"type": "string"
},
"name": {
"description": "用户名称。",
"type": "string"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户头像链接；不可用时为 null。"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "快手用户主页链接；不是作品分享页链接；可作为后续需要快手用户主页 URL 的工具输入；查询用户作品列表时需确认同一用户结果包含非空 user_id；不可用时为 null。"
},
"kuaishou_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "快手号；不可用时为 null。"
},
"bio": {
"description": "用户简介；不可用时为空字符串。",
"type": "string"
},
"gender": {
"description": "用户性别。",
"enum": [
"male",
"female",
"unknown"
],
"type": "string"
},
"follower_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "粉丝数；不可用时为 null。"
},
"following_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "关注数；不可用时为 null。"
},
"received_like_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "获赞数；表示用户内容累计收到的点赞数；不可用时为 null。"
},
"posted_content_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "公开作品数；不可用时为 null。"
},
"points": {
"type": "object",
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"cost": {
"type": "integer",
"description": "本次请求最终确认消耗的积分。",
"minimum": 0
},
"balance": {
"type": "integer",
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0
}
},
"required": [
"cost",
"balance"
],
"additionalProperties": false
}
},
"required": [
"user_id",
"name",
"avatar_url",
"profile_url",
"kuaishou_id",
"bio",
"gender",
"follower_count",
"following_count",
"received_like_count",
"posted_content_count",
"points"
]
}🟢kuaishou_get_user_info_by_profile_url(profile_url)
根据快手用户主页链接、短链接或分享文案获取用户资料；支持 live 主页和 fw/user 用户主页分享链接，成功时会返回可复用的非空 user_id；不要传作品链接。如果上一步结果已返回非空 user_id，可直接使用 user_id 入口。
輸入結構描述
{
"type": "object",
"properties": {
"profile_url": {
"description": "快手用户主页链接、短链接或分享文案；不要传作品链接。支持 live 主页或 fw/user 形式的用户主页分享链接；成功时会返回可复用的非空 user_id。如果上一步结果已返回非空 user_id，可直接使用 user_id 入口。",
"type": "string"
}
},
"required": [
"profile_url"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"user_id": {
"description": "快手用户非空 user_id；可作为后续需要快手用户 user_id 的工具输入。",
"type": "string"
},
"name": {
"description": "用户名称。",
"type": "string"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户头像链接；不可用时为 null。"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "快手用户主页链接；不是作品分享页链接；可作为后续需要快手用户主页 URL 的工具输入；查询用户作品列表时需确认同一用户结果包含非空 user_id；不可用时为 null。"
},
"kuaishou_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "快手号；不可用时为 null。"
},
"bio": {
"description": "用户简介；不可用时为空字符串。",
"type": "string"
},
"gender": {
"description": "用户性别。",
"enum": [
"male",
"female",
"unknown"
],
"type": "string"
},
"follower_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "粉丝数；不可用时为 null。"
},
"following_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "关注数；不可用时为 null。"
},
"received_like_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "获赞数；表示用户内容累计收到的点赞数；不可用时为 null。"
},
"posted_content_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "公开作品数；不可用时为 null。"
},
"points": {
"type": "object",
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"cost": {
"type": "integer",
"description": "本次请求最终确认消耗的积分。",
"minimum": 0
},
"balance": {
"type": "integer",
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0
}
},
"required": [
"cost",
"balance"
],
"additionalProperties": false
}
},
"required": [
"user_id",
"name",
"avatar_url",
"profile_url",
"kuaishou_id",
"bio",
"gender",
"follower_count",
"following_count",
"received_like_count",
"posted_content_count",
"points"
]
}🟢kuaishou_get_user_posted_videos_by_user_id(user_id, page_token)
根据快手用户非空 user_id 获取公开作品列表。
輸入結構描述
{
"type": "object",
"properties": {
"user_id": {
"description": "快手用户非空 user_id；可从包含非空 user_id 的快手用户或作者结果中复用；如果上一步结果里的 user_id 为空字符串，不要使用 user_id 入口。",
"type": "string"
},
"page_token": {
"default": "",
"description": "用户作品分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一用户作品分页链路，不能跨能力或用户复用。",
"type": "string"
}
},
"required": [
"user_id"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"items": {
"description": "当前页该用户发布的作品列表。",
"items": {
"properties": {
"photo_id": {
"description": "快手作品 photo_id；可作为后续需要快手作品 photo_id 的工具输入。",
"type": "string"
},
"content_type": {
"const": "video",
"description": "作品内容类型；当前用户作品列表固定返回 video。",
"type": "string"
},
"description": {
"description": "作者发布文本/作品文案，可能包含话题标签；不可用时为空字符串。",
"type": "string"
},
"publish_time": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "发布时间，秒级 Unix 时间戳；不可用时为 null。"
},
"cover_image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "封面图资源链接；不是作品分享页或播放资源链接；不可用时为 null。"
},
"video": {
"anyOf": [
{
"properties": {
"play_url": {
"description": "返回 video 对象时为可播放 MP4 资源链接；不是作品分享页链接。复用或分享作品时使用 share_url。",
"type": "string"
},
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频时长，毫秒；不可用时为 null。"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频宽度，像素；不可用时为 null。"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频高度，像素；不可用时为 null。"
}
},
"required": [
"play_url",
"duration_ms",
"width",
"height"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "播放资源；无可播放 play_url 时为 null。"
},
"share_url": {
"description": "作品分享页链接；不是播放资源或封面资源链接；可作为后续需要快手作品 URL 的工具输入。",
"type": "string"
},
"like_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "点赞数；不可用时为 null。"
},
"view_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "播放数；不可用时为 null。"
},
"collect_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "收藏数；不可用时为 null。"
},
"topic_tags": {
"description": "作品话题标签列表；无标签时为空数组。",
"items": {
"additionalProperties": false,
"properties": {
"name": {
"description": "话题标签名称。",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"type": "array"
},
"author": {
"properties": {
"user_id": {
"description": "快手用户 user_id；非空时可作为后续需要快手用户 user_id 的工具输入；为空字符串时不要作为后续 user_id 输入。",
"type": "string"
},
"name": {
"description": "用户名称。",
"type": "string"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户头像链接；不可用时为 null。"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "快手用户主页链接；不是作品分享页链接；可作为后续需要快手用户主页 URL 的工具输入；查询用户作品列表时需确认同一用户结果包含非空 user_id；不可用时为 null。"
}
},
"required": [
"user_id",
"name",
"avatar_url",
"profile_url"
],
"type": "object",
"description": "作品作者信息。"
}
},
"required": [
"photo_id",
"content_type",
"description",
"publish_time",
"cover_image_url",
"video",
"share_url",
"like_count",
"view_count",
"collect_count",
"topic_tags",
"author"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论或搜索链路复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
},
"points": {
"type": "object",
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"cost": {
"type": "integer",
"description": "本次请求最终确认消耗的积分。",
"minimum": 0
},
"balance": {
"type": "integer",
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0
}
},
"required": [
"cost",
"balance"
],
"additionalProperties": false
}
},
"required": [
"items",
"next_page_token",
"points"
]
}🟢kuaishou_get_user_posted_videos_by_profile_url(profile_url, page_token)
根据可直接解析出非空 user_id 的快手用户主页链接、短链接或分享文案获取公开作品列表；不要传作品链接；只有 live/fw-user 主页链接时，先调用用户资料入口，成功后使用返回的非空 user_id 查询作品列表。如果上一步结果已返回非空 user_id，可直接使用 user_id 入口。
輸入結構描述
{
"type": "object",
"properties": {
"profile_url": {
"description": "快手用户主页链接、短链接或分享文案；不要传作品链接。该入口需要能直接解析出可复用 user_id 的主页链接；只有 live/fw-user 主页链接时，先调用用户资料入口，成功后使用返回的非空 user_id 查询作品列表。如果上一步结果已返回非空 user_id，可直接使用 user_id 入口。",
"type": "string"
},
"page_token": {
"default": "",
"description": "用户作品分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一用户作品分页链路，不能跨能力或用户复用。",
"type": "string"
}
},
"required": [
"profile_url"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"items": {
"description": "当前页该用户发布的作品列表。",
"items": {
"properties": {
"photo_id": {
"description": "快手作品 photo_id；可作为后续需要快手作品 photo_id 的工具输入。",
"type": "string"
},
"content_type": {
"const": "video",
"description": "作品内容类型；当前用户作品列表固定返回 video。",
"type": "string"
},
"description": {
"description": "作者发布文本/作品文案，可能包含话题标签；不可用时为空字符串。",
"type": "string"
},
"publish_time": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "发布时间，秒级 Unix 时间戳；不可用时为 null。"
},
"cover_image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "封面图资源链接；不是作品分享页或播放资源链接；不可用时为 null。"
},
"video": {
"anyOf": [
{
"properties": {
"play_url": {
"description": "返回 video 对象时为可播放 MP4 资源链接；不是作品分享页链接。复用或分享作品时使用 share_url。",
"type": "string"
},
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频时长，毫秒；不可用时为 null。"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频宽度，像素；不可用时为 null。"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频高度，像素；不可用时为 null。"
}
},
"required": [
"play_url",
"duration_ms",
"width",
"height"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "播放资源；无可播放 play_url 时为 null。"
},
"share_url": {
"description": "作品分享页链接；不是播放资源或封面资源链接；可作为后续需要快手作品 URL 的工具输入。",
"type": "string"
},
"like_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "点赞数；不可用时为 null。"
},
"view_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "播放数；不可用时为 null。"
},
"collect_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "收藏数；不可用时为 null。"
},
"topic_tags": {
"description": "作品话题标签列表；无标签时为空数组。",
"items": {
"additionalProperties": false,
"properties": {
"name": {
"description": "话题标签名称。",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"type": "array"
},
"author": {
"properties": {
"user_id": {
"description": "快手用户 user_id；非空时可作为后续需要快手用户 user_id 的工具输入；为空字符串时不要作为后续 user_id 输入。",
"type": "string"
},
"name": {
"description": "用户名称。",
"type": "string"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户头像链接；不可用时为 null。"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "快手用户主页链接；不是作品分享页链接；可作为后续需要快手用户主页 URL 的工具输入；查询用户作品列表时需确认同一用户结果包含非空 user_id；不可用时为 null。"
}
},
"required": [
"user_id",
"name",
"avatar_url",
"profile_url"
],
"type": "object",
"description": "作品作者信息。"
}
},
"required": [
"photo_id",
"content_type",
"description",
"publish_time",
"cover_image_url",
"video",
"share_url",
"like_count",
"view_count",
"collect_count",
"topic_tags",
"author"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论或搜索链路复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
},
"points": {
"type": "object",
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"cost": {
"type": "integer",
"description": "本次请求最终确认消耗的积分。",
"minimum": 0
},
"balance": {
"type": "integer",
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0
}
},
"required": [
"cost",
"balance"
],
"additionalProperties": false
}
},
"required": [
"items",
"next_page_token",
"points"
]
}🟢kuaishou_search_videos(keyword, page_token)
搜索快手作品。用户需要按搜索词查找作品时使用；keyword 只传搜索词，不要传作品链接，也不要传用户主页链接、photo_id 或 user_id；已有 photo_id、作品链接或 share_url 时直接使用对应详情或评论工具，无需先调用搜索；支持 page_token 翻页。
輸入結構描述
{
"type": "object",
"properties": {
"keyword": {
"description": "搜索快手作品的搜索词，可传关键词或短语，例如品牌名、话题、人物名或产品名；不要传作品链接，也不要传用户主页链接、photo_id、user_id 或 page_token。已有作品链接或 photo_id 时改用需要快手作品 URL/photo_id 的入口；已有用户主页链接或非空 user_id 时改用需要快手用户主页 URL/user_id 的入口。",
"type": "string"
},
"page_token": {
"default": "",
"description": "搜索分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一搜索分页链路和同一关键词，不能跨能力、关键词或搜索链路复用。",
"type": "string"
}
},
"required": [
"keyword"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"items": {
"description": "当前页作品结果列表。",
"items": {
"properties": {
"photo_id": {
"description": "快手作品 photo_id；可作为后续需要快手作品 photo_id 的工具输入。",
"type": "string"
},
"content_type": {
"description": "作品内容类型：video 为视频，image 为图片作品。",
"enum": [
"video",
"image"
],
"type": "string"
},
"description": {
"description": "作者发布文本/作品文案，可能包含话题标签；不可用时为空字符串。",
"type": "string"
},
"publish_time": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "发布时间，秒级 Unix 时间戳；不可用时为 null。"
},
"cover_image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "封面图资源链接；不是作品分享页或播放资源链接；不可用时为 null。"
},
"video": {
"anyOf": [
{
"properties": {
"play_url": {
"description": "返回 video 对象时为可播放 MP4 资源链接；不是作品分享页链接。复用或分享作品时使用 share_url。",
"type": "string"
},
"duration_ms": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频时长，毫秒；不可用时为 null。"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频宽度，像素；不可用时为 null。"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频高度，像素；不可用时为 null。"
}
},
"required": [
"play_url",
"duration_ms",
"width",
"height"
],
"type": "object"
},
{
"type": "null"
}
],
"description": "播放资源；无可播放 play_url 时为 null。"
},
"share_url": {
"description": "作品分享页链接；不是播放资源或封面资源链接；可作为后续需要快手作品 URL 的工具输入。",
"type": "string"
},
"like_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "点赞数；不可用时为 null。"
},
"view_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "播放数；不可用时为 null。"
},
"collect_count": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "收藏数；不可用时为 null。"
},
"topic_tags": {
"description": "作品话题标签列表；无标签时为空数组。",
"items": {
"additionalProperties": false,
"properties": {
"name": {
"description": "话题标签名称。",
"type": "string"
}
},
"required": [
"name"
],
"type": "object"
},
"type": "array"
},
"author": {
"properties": {
"user_id": {
"description": "快手用户 user_id；非空时可作为后续需要快手用户 user_id 的工具输入；为空字符串时不要作为后续 user_id 输入。",
"type": "string"
},
"name": {
"description": "用户名称。",
"type": "string"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户头像链接；不可用时为 null。"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "快手用户主页链接；不是作品分享页链接；可作为后续需要快手用户主页 URL 的工具输入；查询用户作品列表时需确认同一用户结果包含非空 user_id；不可用时为 null。"
}
},
"required": [
"user_id",
"name",
"avatar_url",
"profile_url"
],
"type": "object",
"description": "作品作者信息。"
},
"images": {
"description": "图片作品的图集，按原始顺序返回；无图集时为空数组。",
"items": {
"properties": {
"url": {
"description": "图片展示资源链接；用于查看或分析图片内容。",
"type": "string"
},
"width": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片宽度，像素；不可用时为 null。"
},
"height": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"description": "图片高度，像素；不可用时为 null。"
}
},
"required": [
"url",
"width",
"height"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"photo_id",
"content_type",
"description",
"publish_time",
"cover_image_url",
"video",
"share_url",
"like_count",
"view_count",
"collect_count",
"topic_tags",
"author"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论或搜索链路复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
},
"points": {
"type": "object",
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"cost": {
"type": "integer",
"description": "本次请求最终确认消耗的积分。",
"minimum": 0
},
"balance": {
"type": "integer",
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0
}
},
"required": [
"cost",
"balance"
],
"additionalProperties": false
}
},
"required": [
"items",
"next_page_token",
"points"
]
}🟢kuaishou_search_users(keyword, page_token)
搜索快手用户。用户需要按搜索词查找用户时使用；keyword 只传搜索词，不要传作品链接，也不要传用户主页链接、photo_id 或 user_id；已有用户主页链接或 user_id 时使用对应用户资料或用户作品列表工具；支持 page_token 翻页。
輸入結構描述
{
"type": "object",
"properties": {
"keyword": {
"description": "搜索快手用户的搜索词，可传关键词或短语，例如人物名、账号名、品牌名或机构名；不要传作品链接，也不要传用户主页链接、photo_id、user_id 或 page_token。已有用户主页链接或非空 user_id 时改用需要快手用户主页 URL/user_id 的入口。",
"type": "string"
},
"page_token": {
"default": "",
"description": "用户搜索分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一用户搜索分页链路和同一关键词，不能跨能力、关键词或搜索链路复用。",
"type": "string"
}
},
"required": [
"keyword"
],
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"properties": {
"items": {
"description": "当前页用户结果列表。",
"items": {
"properties": {
"user_id": {
"description": "快手用户 user_id；非空时可作为后续需要快手用户 user_id 的工具输入；为空字符串时不要作为后续 user_id 输入。",
"type": "string"
},
"name": {
"description": "用户名称。",
"type": "string"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户头像链接；不可用时为 null。"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "快手用户主页链接；不是作品分享页链接；可作为后续需要快手用户主页 URL 的工具输入；查询用户作品列表时需确认同一用户结果包含非空 user_id；不可用时为 null。"
},
"bio": {
"description": "用户简介；不可用时为空字符串。",
"type": "string"
},
"verified": {
"description": "是否为认证账号。",
"type": "boolean"
}
},
"required": [
"user_id",
"name",
"avatar_url",
"profile_url",
"bio",
"verified"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页不透明分页令牌；为空表示没有更多结果。继续翻页时必须将返回的完整 next_page_token 原样作为 page_token 传回。next_page_token 只能用于同一能力和同一分页链路，不能跨能力、作品、用户、评论或搜索链路复用；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。",
"type": "string"
},
"points": {
"type": "object",
"description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
"properties": {
"cost": {
"type": "integer",
"description": "本次请求最终确认消耗的积分。",
"minimum": 0
},
"balance": {
"type": "integer",
"description": "本次接口完成时看到的当前积分余额。",
"minimum": 0
}
},
"required": [
"cost",
"balance"
],
"additionalProperties": false
}
},
"required": [
"items",
"next_page_token",
"points"
]
}🟢socialdatax_get_points_balance
查询当前 API Key 账户的 SocialDataX 积分余额、剩余积分或点数 / remaining points balance。需要充值时请访问 https://socialdatax.com/dashboard/billing。
輸入結構描述
{
"type": "object",
"properties": {},
"additionalProperties": false
}輸出結構描述
{
"type": "object",
"additionalProperties": {
"type": "integer"
}
}建議的提示詞
search_research
Search for information about [topic] using SocialDataX 快手 Kuaishou MCP
預期的工具：
kuaishou_get_hot_search_listfetch_info
Fetch [information type] using SocialDataX 快手 Kuaishou MCP
預期的工具：
kuaishou_get_hot_search_listlist_items
List all [items] available in SocialDataX 快手 Kuaishou MCP
預期的工具：
kuaishou_get_hot_search_listfind_specific
Find [specific item] using SocialDataX 快手 Kuaishou MCP
預期的工具：
kuaishou_get_hot_search_listretrieve_data
Get details about [item] from SocialDataX 快手 Kuaishou MCP
預期的工具：
kuaishou_get_hot_search_list社群
證據
近期觀測
已驗證未記錄版本17 個工具
已驗證未記錄版本17 個工具
已驗證未記錄版本16 個工具
已驗證未記錄版本16 個工具