SocialDataX 好看视频 Haokan MCP
Haokan video/user search, details, comments/replies, creators, creator videos and hot searches.
我该使用它吗
质量与安全性
B
发现（15）
- HIGHTool poisoning patterns detected
- MEDIUMTool description contains URL to non-standard domain在 socialdatax_get_points_balance 中
- LOWTool 'haokan_search_videos' description lacks action verb在 haokan_search_videos 中
- LOWTool 'haokan_search_users' description lacks action verb在 haokan_search_users 中
- LOWTool 'haokan_search_suggestions' description lacks action verb在 haokan_search_suggestions 中
- LOWTool 'haokan_get_hot_search_list' description lacks action verb在 haokan_get_hot_search_list 中
- LOWTool 'socialdatax_get_points_balance' description lacks action verb在 socialdatax_get_points_balance 中
- LOWTool 'haokan_get_comment_replies_by_video_id' name length outside 3-30 range在 haokan_get_comment_replies_by_video_id 中
- LOWTool 'haokan_get_comment_replies_by_url' name length outside 3-30 range在 haokan_get_comment_replies_by_url 中
- LOWTool 'haokan_get_video_comments_by_video_id' name length outside 3-30 range在 haokan_get_video_comments_by_video_id 中
基于对工具定义和协议合规性的自动分析。
上下文开销
~10,870token 数（工具定义）
~5.7 KB典型响应大小
对注意力有显著影响（占 128k 上下文窗口的 8.49%）
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中：
{
"mcpServers": {
"haokan": {
"url": "https://mcp.socialdatax.com/haokan/mcp"
}
}
}远程端点
https://mcp.socialdatax.com/haokan/mcpstreamable-http它能做什么
工具清单
工具（15）
🟢 只读🟡 写入🔴 删除⚪ 未知
🟢haokan_get_comment_replies_by_video_id(video_id, comment_id, page_token)
按视频 ID和一级评论 ID 读取完整回复列表，支持分页；comment_id 取视频评论列表，另一入口使用 haokan_get_comment_replies_by_url。
输入模式
{
"type": "object",
"properties": {
"video_id": {
"description": "好看视频数字 ID，以字符串传入，例如 6148991337208256393；可从视频搜索结果的 video_id 获取。",
"pattern": "^[0-9]+$",
"type": "string"
},
"comment_id": {
"description": "所属一级评论 ID，取视频评论列表中的 comment_id；不要传回复自身的 ID。",
"pattern": "^[1-9][0-9]*$",
"type": "string"
},
"page_token": {
"default": "",
"description": "分页令牌，首次留空；续页原样传回 next_page_token，保持同一视频和一级评论。",
"type": "string"
}
},
"required": [
"video_id",
"comment_id"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"items": {
"description": "当前页评论回复，保持平台返回顺序。",
"items": {
"additionalProperties": false,
"properties": {
"comment_id": {
"description": "回复自身的评论 ID。",
"minLength": 1,
"type": "string"
},
"content": {
"description": "评论正文，保留表情文字。",
"type": "string"
},
"image_urls": {
"description": "评论附带的图片或图片表情链接；没有时为空数组。",
"items": {
"type": "string"
},
"type": "array"
},
"create_time": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "发布时间，Unix 秒级时间戳；不可用时为 null。"
},
"like_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "点赞数；不可用时为 null。"
},
"author": {
"additionalProperties": false,
"properties": {
"user_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "好看视频用户标识，可用于用户资料查询；不可用时为 null。"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "评论作者的好看视频主页链接；不可用时为 null。"
},
"name": {
"description": "评论作者名称。",
"type": "string"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "评论作者头像；不可用时为 null。"
}
},
"required": [
"name",
"avatar_url"
],
"type": "object",
"description": "评论作者摘要。"
},
"video_id": {
"description": "所属视频 ID。",
"type": "string"
},
"parent_comment_id": {
"description": "所属一级评论 ID。",
"type": "string"
},
"reply_to_comment_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "被回复的评论 ID；平台未明确提供时为 null。"
}
},
"required": [
"comment_id",
"content",
"image_urls",
"create_time",
"like_count",
"author",
"video_id",
"parent_comment_id",
"reply_to_comment_id"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页分页令牌；为空表示没有下一页。",
"type": "string"
},
"reply_count": {
"description": "平台返回的该一级评论下的回复总数。",
"minimum": 0,
"type": "integer"
},
"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",
"reply_count",
"points"
],
"additionalProperties": false
}🟢haokan_get_comment_replies_by_url(url, comment_id, page_token)
按视频页面链接和一级评论 ID 读取完整回复列表，支持分页；comment_id 取视频评论列表，另一入口使用 haokan_get_comment_replies_by_video_id。
输入模式
{
"type": "object",
"properties": {
"url": {
"description": "好看视频页面链接，格式为 https://haokan.baidu.com/v?vid=数字ID，可取视频搜索结果的 share_url。",
"minLength": 1,
"type": "string"
},
"comment_id": {
"description": "所属一级评论 ID，取视频评论列表中的 comment_id；不要传回复自身的 ID。",
"pattern": "^[1-9][0-9]*$",
"type": "string"
},
"page_token": {
"default": "",
"description": "分页令牌，首次留空；续页原样传回 next_page_token，保持同一视频和一级评论。",
"type": "string"
}
},
"required": [
"url",
"comment_id"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"items": {
"description": "当前页评论回复，保持平台返回顺序。",
"items": {
"additionalProperties": false,
"properties": {
"comment_id": {
"description": "回复自身的评论 ID。",
"minLength": 1,
"type": "string"
},
"content": {
"description": "评论正文，保留表情文字。",
"type": "string"
},
"image_urls": {
"description": "评论附带的图片或图片表情链接；没有时为空数组。",
"items": {
"type": "string"
},
"type": "array"
},
"create_time": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "发布时间，Unix 秒级时间戳；不可用时为 null。"
},
"like_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "点赞数；不可用时为 null。"
},
"author": {
"additionalProperties": false,
"properties": {
"user_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "好看视频用户标识，可用于用户资料查询；不可用时为 null。"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "评论作者的好看视频主页链接；不可用时为 null。"
},
"name": {
"description": "评论作者名称。",
"type": "string"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "评论作者头像；不可用时为 null。"
}
},
"required": [
"name",
"avatar_url"
],
"type": "object",
"description": "评论作者摘要。"
},
"video_id": {
"description": "所属视频 ID。",
"type": "string"
},
"parent_comment_id": {
"description": "所属一级评论 ID。",
"type": "string"
},
"reply_to_comment_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "被回复的评论 ID；平台未明确提供时为 null。"
}
},
"required": [
"comment_id",
"content",
"image_urls",
"create_time",
"like_count",
"author",
"video_id",
"parent_comment_id",
"reply_to_comment_id"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页分页令牌；为空表示没有下一页。",
"type": "string"
},
"reply_count": {
"description": "平台返回的该一级评论下的回复总数。",
"minimum": 0,
"type": "integer"
},
"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",
"reply_count",
"points"
],
"additionalProperties": false
}🟢haokan_get_video_comments_by_video_id(video_id, page_token)
按视频 ID读取好看视频一级评论，支持分页；附带的回复仅为预览。另一种输入使用 haokan_get_video_comments_by_url。
输入模式
{
"type": "object",
"properties": {
"video_id": {
"description": "好看视频数字 ID，以字符串传入，例如 6148991337208256393；可从视频搜索结果的 video_id 获取。",
"pattern": "^[0-9]+$",
"type": "string"
},
"page_token": {
"default": "",
"description": "分页令牌，首次留空；续页原样传回 next_page_token，保持同一视频。",
"type": "string"
}
},
"required": [
"video_id"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"items": {
"description": "当前页一级评论，保持平台顺序。",
"items": {
"additionalProperties": false,
"properties": {
"comment_id": {
"description": "回复自身的评论 ID。",
"minLength": 1,
"type": "string"
},
"content": {
"description": "评论正文，保留表情文字。",
"type": "string"
},
"image_urls": {
"description": "评论附带的图片或图片表情链接；没有时为空数组。",
"items": {
"type": "string"
},
"type": "array"
},
"create_time": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "发布时间，Unix 秒级时间戳；不可用时为 null。"
},
"like_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "点赞数；不可用时为 null。"
},
"author": {
"additionalProperties": false,
"properties": {
"user_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "好看视频用户标识，可用于用户资料查询；不可用时为 null。"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "评论作者的好看视频主页链接；不可用时为 null。"
},
"name": {
"description": "评论作者名称。",
"type": "string"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "评论作者头像；不可用时为 null。"
}
},
"required": [
"name",
"avatar_url"
],
"type": "object",
"description": "评论作者摘要。"
},
"video_id": {
"description": "所属视频 ID。",
"type": "string"
},
"reply_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "平台展示的回复数量；不可用时为 null。"
},
"replies": {
"description": "随一级评论返回的回复预览，不代表全部回复。",
"items": {
"additionalProperties": false,
"properties": {
"comment_id": {
"description": "回复自身的评论 ID。",
"minLength": 1,
"type": "string"
},
"content": {
"description": "评论正文，保留表情文字。",
"type": "string"
},
"image_urls": {
"description": "评论附带的图片或图片表情链接；没有时为空数组。",
"items": {
"type": "string"
},
"type": "array"
},
"create_time": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "发布时间，Unix 秒级时间戳；不可用时为 null。"
},
"like_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "点赞数；不可用时为 null。"
},
"author": {
"additionalProperties": false,
"properties": {
"user_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "好看视频用户标识，可用于用户资料查询；不可用时为 null。"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "评论作者的好看视频主页链接；不可用时为 null。"
},
"name": {
"description": "评论作者名称。",
"type": "string"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "评论作者头像；不可用时为 null。"
}
},
"required": [
"name",
"avatar_url"
],
"type": "object",
"description": "评论作者摘要。"
}
},
"required": [
"comment_id",
"content",
"image_urls",
"create_time",
"like_count",
"author"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"comment_id",
"content",
"image_urls",
"create_time",
"like_count",
"author",
"video_id",
"reply_count",
"replies"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页分页令牌；为空表示没有下一页。",
"type": "string"
},
"comment_count": {
"description": "平台展示的评论总数，不等于当前页一级评论数量。",
"minimum": 0,
"type": "integer"
},
"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"
],
"additionalProperties": false
}🟢haokan_get_video_comments_by_url(url, page_token)
按视频页面链接读取好看视频一级评论，支持分页；附带的回复仅为预览。另一种输入使用 haokan_get_video_comments_by_video_id。
输入模式
{
"type": "object",
"properties": {
"url": {
"description": "好看视频页面链接，格式为 https://haokan.baidu.com/v?vid=数字ID，可取视频搜索结果的 share_url。",
"minLength": 1,
"type": "string"
},
"page_token": {
"default": "",
"description": "分页令牌，首次留空；续页原样传回 next_page_token，保持同一视频。",
"type": "string"
}
},
"required": [
"url"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"items": {
"description": "当前页一级评论，保持平台顺序。",
"items": {
"additionalProperties": false,
"properties": {
"comment_id": {
"description": "回复自身的评论 ID。",
"minLength": 1,
"type": "string"
},
"content": {
"description": "评论正文，保留表情文字。",
"type": "string"
},
"image_urls": {
"description": "评论附带的图片或图片表情链接；没有时为空数组。",
"items": {
"type": "string"
},
"type": "array"
},
"create_time": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "发布时间，Unix 秒级时间戳；不可用时为 null。"
},
"like_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "点赞数；不可用时为 null。"
},
"author": {
"additionalProperties": false,
"properties": {
"user_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "好看视频用户标识，可用于用户资料查询；不可用时为 null。"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "评论作者的好看视频主页链接；不可用时为 null。"
},
"name": {
"description": "评论作者名称。",
"type": "string"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "评论作者头像；不可用时为 null。"
}
},
"required": [
"name",
"avatar_url"
],
"type": "object",
"description": "评论作者摘要。"
},
"video_id": {
"description": "所属视频 ID。",
"type": "string"
},
"reply_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "平台展示的回复数量；不可用时为 null。"
},
"replies": {
"description": "随一级评论返回的回复预览，不代表全部回复。",
"items": {
"additionalProperties": false,
"properties": {
"comment_id": {
"description": "回复自身的评论 ID。",
"minLength": 1,
"type": "string"
},
"content": {
"description": "评论正文，保留表情文字。",
"type": "string"
},
"image_urls": {
"description": "评论附带的图片或图片表情链接；没有时为空数组。",
"items": {
"type": "string"
},
"type": "array"
},
"create_time": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "发布时间，Unix 秒级时间戳；不可用时为 null。"
},
"like_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "点赞数；不可用时为 null。"
},
"author": {
"additionalProperties": false,
"properties": {
"user_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "好看视频用户标识，可用于用户资料查询；不可用时为 null。"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "评论作者的好看视频主页链接；不可用时为 null。"
},
"name": {
"description": "评论作者名称。",
"type": "string"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "评论作者头像；不可用时为 null。"
}
},
"required": [
"name",
"avatar_url"
],
"type": "object",
"description": "评论作者摘要。"
}
},
"required": [
"comment_id",
"content",
"image_urls",
"create_time",
"like_count",
"author"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"comment_id",
"content",
"image_urls",
"create_time",
"like_count",
"author",
"video_id",
"reply_count",
"replies"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页分页令牌；为空表示没有下一页。",
"type": "string"
},
"comment_count": {
"description": "平台展示的评论总数，不等于当前页一级评论数量。",
"minimum": 0,
"type": "integer"
},
"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"
],
"additionalProperties": false
}🟢haokan_search_videos(keyword, page_token)
按关键词搜索好看视频，返回视频摘要并支持分页；用于查找视频，不用于读取指定视频链接的详情或查找用户。
输入模式
{
"type": "object",
"properties": {
"keyword": {
"description": "视频搜索词，例如科技、美食或品牌名；不要传视频链接、用户主页链接或分页令牌。",
"minLength": 1,
"type": "string"
},
"page_token": {
"default": "",
"description": "分页令牌，首次请求留空；继续翻页时将上一页完整 next_page_token 原样传回，不得修改、截断或自行生成；只能用于相同工具和相同关键词。",
"type": "string"
}
},
"required": [
"keyword"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"items": {
"description": "当前页视频搜索结果，按搜索结果顺序返回。",
"items": {
"additionalProperties": false,
"properties": {
"video_id": {
"description": "好看视频 ID，以字符串表示。",
"minLength": 1,
"type": "string"
},
"title": {
"description": "视频标题；不可用时为空字符串。",
"type": "string"
},
"share_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "视频页面链接；不是播放资源链接；不可用时为 null。"
},
"cover_image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "视频封面图片链接；不可用时为 null。"
},
"duration_seconds": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频时长，单位秒；无法确认时为 null。"
},
"publish_time_text": {
"description": "发布时间展示文本，例如“7年前”；不可用时为空字符串。",
"type": "string"
},
"view_count_text": {
"description": "播放量展示文本，可能为缩略值；不可用时为空字符串。",
"type": "string"
},
"view_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "播放次数；缩略展示值换算为近似数值，例如11万返回110000；无法解析时为 null。"
},
"author": {
"additionalProperties": false,
"properties": {
"user_id": {
"description": "作者用户 ID；缺失或无法确认时为空字符串，不能用于用户查询。",
"type": "string"
},
"name": {
"description": "作者名称；不可用时为空字符串。",
"type": "string"
}
},
"required": [
"user_id",
"name"
],
"type": "object",
"description": "视频作者摘要。"
}
},
"required": [
"video_id",
"title",
"share_url",
"cover_image_url",
"duration_seconds",
"publish_time_text",
"view_count_text",
"view_count",
"author"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页不透明分页令牌；为空表示没有下一页。继续翻页时原样作为 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"
],
"additionalProperties": false
}🟢haokan_search_users(keyword, page_token)
按关键词搜索好看视频用户、账号或创作者，返回用户摘要并支持分页；不用于搜索视频。
输入模式
{
"type": "object",
"properties": {
"keyword": {
"description": "用户搜索词，例如账号名、创作者名称或品牌名；不要传视频链接、用户主页链接或分页令牌。",
"minLength": 1,
"type": "string"
},
"page_token": {
"default": "",
"description": "分页令牌，首次请求留空；继续翻页时将上一页完整 next_page_token 原样传回，不得修改、截断或自行生成；只能用于相同工具和相同关键词。",
"type": "string"
}
},
"required": [
"keyword"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"items": {
"description": "当前页用户搜索结果。",
"items": {
"additionalProperties": false,
"properties": {
"user_id": {
"description": "好看视频用户标识，可能包含非数字字符。",
"minLength": 1,
"type": "string"
},
"name": {
"description": "用户名称；不可用时为空字符串。",
"type": "string"
},
"profile_url": {
"description": "用户的好看视频主页链接。",
"type": "string"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户头像链接；不可用时为 null。"
},
"bio": {
"description": "用户简介；不可用时为空字符串。",
"type": "string"
},
"follower_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "粉丝数量；不可用时为 null。"
},
"posted_video_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "已发布视频数量；不可用时为 null。"
}
},
"required": [
"user_id",
"name",
"profile_url",
"avatar_url",
"bio",
"follower_count",
"posted_video_count"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页不透明分页令牌；为空表示没有下一页。继续翻页时原样作为 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"
],
"additionalProperties": false
}🟢haokan_search_suggestions(keyword)
获取好看视频搜索联想词，用于补全或扩展关键词；不返回视频或用户结果，不支持分页。
输入模式
{
"type": "object",
"properties": {
"keyword": {
"description": "需要补全或扩展的搜索词；不要传链接或分页令牌。",
"minLength": 1,
"type": "string"
}
},
"required": [
"keyword"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"items": {
"description": "按建议顺序排列的搜索联想词。",
"items": {
"additionalProperties": false,
"properties": {
"text": {
"description": "搜索联想词。",
"minLength": 1,
"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
}🟢haokan_get_hot_search_list
获取好看视频当前搜索热词及热度；不返回热门视频列表，不支持分页。
输入模式
{
"type": "object",
"properties": {},
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"items": {
"description": "当前搜索热词，保持平台返回顺序。",
"items": {
"additionalProperties": false,
"properties": {
"keyword": {
"description": "搜索热词。",
"minLength": 1,
"type": "string"
},
"hot_value": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "平台提供的热词热度值，不代表搜索次数或播放量；不可用时为 null。"
}
},
"required": [
"keyword",
"hot_value"
],
"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
}🟢haokan_get_video_detail_by_video_id(video_id)
按视频 ID 读取好看视频详情、播放地址和作者摘要；持有页面链接时使用 haokan_get_video_detail_by_url。播放地址可能过期。
输入模式
{
"type": "object",
"properties": {
"video_id": {
"description": "好看视频数字 ID，以字符串传入，例如 6148991337208256393；可从视频搜索结果的 video_id 获取。",
"pattern": "^[0-9]+$",
"type": "string"
}
},
"required": [
"video_id"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"video_id": {
"description": "好看视频 ID。",
"minLength": 1,
"type": "string"
},
"title": {
"description": "视频标题。",
"type": "string"
},
"share_url": {
"description": "视频页面链接。",
"type": "string"
},
"cover_image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "视频封面链接；不可用时为 null。"
},
"duration_seconds": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "时长，单位秒；不可用时为 null。"
},
"publish_time": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "发布时间，Unix 秒级时间戳；不可用时为 null。"
},
"view_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "平台返回的播放次数；缺失时为 null。"
},
"like_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "平台返回的点赞数量；缺失时为 null。"
},
"comment_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "平台返回的评论数量；缺失时为 null。"
},
"play_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "优先选取平台清晰度等级最高的非空播放地址，无候选时使用默认地址；均缺失时为 null，地址可能过期。"
},
"playback_variants": {
"description": "按平台清晰度等级从高到低排列的非空播放地址，包含 quality、label、url；无候选时为空数组，非空时 play_url 等于第一项 url。",
"items": {
"additionalProperties": false,
"properties": {
"quality": {
"description": "平台清晰度标识，例如 sd、hd、sc、1080p。",
"type": "string"
},
"label": {
"description": "清晰度展示名称，例如超清 720P。",
"type": "string"
},
"url": {
"description": "该清晰度的播放地址，可能过期。",
"minLength": 1,
"type": "string"
}
},
"required": [
"quality",
"label",
"url"
],
"type": "object"
},
"type": "array"
},
"author": {
"additionalProperties": false,
"properties": {
"user_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "好看视频用户标识，可用于用户资料查询；不可用时为 null。"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "作者的好看视频主页链接；不可用时为 null。"
},
"name": {
"description": "作者名称。",
"type": "string"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者头像链接；不可用时为 null。"
},
"follower_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "作者粉丝数量；不可用时为 null。"
}
},
"required": [
"name",
"avatar_url",
"follower_count"
],
"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": [
"video_id",
"title",
"share_url",
"cover_image_url",
"duration_seconds",
"publish_time",
"view_count",
"like_count",
"comment_count",
"play_url",
"playback_variants",
"author",
"points"
],
"additionalProperties": false
}🟢haokan_get_video_detail_by_url(url)
按页面链接读取好看视频详情、播放地址和作者摘要；只有视频 ID 时使用 haokan_get_video_detail_by_video_id。播放地址可能过期。
输入模式
{
"type": "object",
"properties": {
"url": {
"description": "好看视频页面链接，格式为 https://haokan.baidu.com/v?vid=数字ID，可取视频搜索结果的 share_url。",
"minLength": 1,
"type": "string"
}
},
"required": [
"url"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"video_id": {
"description": "好看视频 ID。",
"minLength": 1,
"type": "string"
},
"title": {
"description": "视频标题。",
"type": "string"
},
"share_url": {
"description": "视频页面链接。",
"type": "string"
},
"cover_image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "视频封面链接；不可用时为 null。"
},
"duration_seconds": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "时长，单位秒；不可用时为 null。"
},
"publish_time": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "发布时间，Unix 秒级时间戳；不可用时为 null。"
},
"view_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "平台返回的播放次数；缺失时为 null。"
},
"like_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "平台返回的点赞数量；缺失时为 null。"
},
"comment_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "平台返回的评论数量；缺失时为 null。"
},
"play_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "优先选取平台清晰度等级最高的非空播放地址，无候选时使用默认地址；均缺失时为 null，地址可能过期。"
},
"playback_variants": {
"description": "按平台清晰度等级从高到低排列的非空播放地址，包含 quality、label、url；无候选时为空数组，非空时 play_url 等于第一项 url。",
"items": {
"additionalProperties": false,
"properties": {
"quality": {
"description": "平台清晰度标识，例如 sd、hd、sc、1080p。",
"type": "string"
},
"label": {
"description": "清晰度展示名称，例如超清 720P。",
"type": "string"
},
"url": {
"description": "该清晰度的播放地址，可能过期。",
"minLength": 1,
"type": "string"
}
},
"required": [
"quality",
"label",
"url"
],
"type": "object"
},
"type": "array"
},
"author": {
"additionalProperties": false,
"properties": {
"user_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "好看视频用户标识，可用于用户资料查询；不可用时为 null。"
},
"profile_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "作者的好看视频主页链接；不可用时为 null。"
},
"name": {
"description": "作者名称。",
"type": "string"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "作者头像链接；不可用时为 null。"
},
"follower_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "作者粉丝数量；不可用时为 null。"
}
},
"required": [
"name",
"avatar_url",
"follower_count"
],
"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": [
"video_id",
"title",
"share_url",
"cover_image_url",
"duration_seconds",
"publish_time",
"view_count",
"like_count",
"comment_count",
"play_url",
"playback_variants",
"author",
"points"
],
"additionalProperties": false
}🟢haokan_get_user_info_by_user_id(user_id)
按用户 ID 获取好看视频用户资料；ID 可从用户搜索结果获取，持有主页链接时使用 haokan_get_user_info_by_url；不返回作品列表。
输入模式
{
"type": "object",
"properties": {
"user_id": {
"description": "好看视频用户 ID，可取用户搜索结果的 user_id，或视频详情、评论作者的 author.user_id；支持数字和字母数字标识，不要传空值。",
"pattern": "^[A-Za-z0-9_-]+$",
"type": "string"
}
},
"required": [
"user_id"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"user_id": {
"description": "好看视频用户标识，可能包含非数字字符。",
"minLength": 1,
"type": "string"
},
"name": {
"description": "用户名称；不可用时为空字符串。",
"type": "string"
},
"profile_url": {
"description": "用户的好看视频主页链接。",
"type": "string"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户头像链接；不可用时为 null。"
},
"bio": {
"description": "用户简介；不可用时为空字符串。",
"type": "string"
},
"follower_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "粉丝数量；不可用时为 null。"
},
"posted_video_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "已发布视频数量；不可用时为 null。"
},
"is_verified": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "是否已认证；不可用时为 null。"
},
"verification_label": {
"anyOf": [
{
"type": "string"
},
{
"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",
"profile_url",
"avatar_url",
"bio",
"follower_count",
"posted_video_count",
"is_verified",
"verification_label",
"points"
],
"additionalProperties": false,
"description": "Profile fields shared with user search, read from the author's page."
}🟢haokan_get_user_info_by_url(url)
按用户主页链接获取好看视频用户资料；只有用户 ID 时使用 haokan_get_user_info_by_user_id；不返回作品列表。
输入模式
{
"type": "object",
"properties": {
"url": {
"description": "好看视频用户主页链接，格式为 https://haokan.baidu.com/author/用户ID，可取用户搜索结果的 profile_url，或视频详情、评论作者的 author.profile_url。",
"minLength": 1,
"type": "string"
}
},
"required": [
"url"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"user_id": {
"description": "好看视频用户标识，可能包含非数字字符。",
"minLength": 1,
"type": "string"
},
"name": {
"description": "用户名称；不可用时为空字符串。",
"type": "string"
},
"profile_url": {
"description": "用户的好看视频主页链接。",
"type": "string"
},
"avatar_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "用户头像链接；不可用时为 null。"
},
"bio": {
"description": "用户简介；不可用时为空字符串。",
"type": "string"
},
"follower_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "粉丝数量；不可用时为 null。"
},
"posted_video_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "已发布视频数量；不可用时为 null。"
},
"is_verified": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "是否已认证；不可用时为 null。"
},
"verification_label": {
"anyOf": [
{
"type": "string"
},
{
"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",
"profile_url",
"avatar_url",
"bio",
"follower_count",
"posted_video_count",
"is_verified",
"verification_label",
"points"
],
"additionalProperties": false,
"description": "Profile fields shared with user search, read from the author's page."
}🟢haokan_get_user_posted_videos_by_user_id(user_id, page_token)
按用户 ID 获取好看视频用户发布视频列表，支持分页；持有用户主页链接时使用 haokan_get_user_posted_videos_by_profile_url。
输入模式
{
"type": "object",
"properties": {
"user_id": {
"description": "好看视频用户 ID，可取用户搜索结果的 user_id，或视频详情、评论作者的 author.user_id；支持数字和字母数字标识，不要传空值。",
"pattern": "^[A-Za-z0-9_-]+$",
"type": "string"
},
"page_token": {
"default": "",
"description": "分页令牌，首次留空；续页原样传回上一页 next_page_token，且保持同一用户。",
"type": "string"
}
},
"required": [
"user_id"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"items": {
"description": "当前页用户发布视频，保持平台返回顺序。",
"items": {
"additionalProperties": false,
"properties": {
"video_id": {
"description": "好看视频 ID，以字符串表示。",
"minLength": 1,
"type": "string"
},
"title": {
"description": "视频标题；不可用时为空字符串。",
"type": "string"
},
"share_url": {
"description": "视频页面链接。",
"type": "string"
},
"cover_image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "视频封面链接；不可用时为 null。"
},
"duration_seconds": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频时长，单位秒；不可用时为 null。"
},
"publish_time_text": {
"description": "发布时间展示文本；不可用时为空字符串。",
"type": "string"
},
"view_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "平台返回的播放次数；不可用时为 null。"
},
"view_count_text": {
"description": "播放量展示文本，可能为缩略值；不可用时为空字符串。",
"type": "string"
}
},
"required": [
"video_id",
"title",
"share_url",
"cover_image_url",
"duration_seconds",
"publish_time_text",
"view_count",
"view_count_text"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页分页令牌；为空表示没有下一页，续页需保持同一用户。",
"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"
],
"additionalProperties": false
}🟢haokan_get_user_posted_videos_by_profile_url(profile_url, page_token)
按用户主页链接获取好看视频用户发布视频列表，支持分页；不要传视频链接，已有用户 ID 时使用 haokan_get_user_posted_videos_by_user_id。
输入模式
{
"type": "object",
"properties": {
"profile_url": {
"description": "好看视频用户主页链接，格式为 https://haokan.baidu.com/author/用户ID，可取用户搜索结果的 profile_url，或视频详情、评论作者的 author.profile_url。",
"minLength": 1,
"type": "string"
},
"page_token": {
"default": "",
"description": "分页令牌，首次留空；续页原样传回上一页 next_page_token，且保持同一用户。",
"type": "string"
}
},
"required": [
"profile_url"
],
"additionalProperties": false
}输出模式
{
"type": "object",
"properties": {
"items": {
"description": "当前页用户发布视频，保持平台返回顺序。",
"items": {
"additionalProperties": false,
"properties": {
"video_id": {
"description": "好看视频 ID，以字符串表示。",
"minLength": 1,
"type": "string"
},
"title": {
"description": "视频标题；不可用时为空字符串。",
"type": "string"
},
"share_url": {
"description": "视频页面链接。",
"type": "string"
},
"cover_image_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "视频封面链接；不可用时为 null。"
},
"duration_seconds": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "视频时长，单位秒；不可用时为 null。"
},
"publish_time_text": {
"description": "发布时间展示文本；不可用时为空字符串。",
"type": "string"
},
"view_count": {
"anyOf": [
{
"minimum": 0,
"type": "integer"
},
{
"type": "null"
}
],
"description": "平台返回的播放次数；不可用时为 null。"
},
"view_count_text": {
"description": "播放量展示文本，可能为缩略值；不可用时为空字符串。",
"type": "string"
}
},
"required": [
"video_id",
"title",
"share_url",
"cover_image_url",
"duration_seconds",
"publish_time_text",
"view_count",
"view_count_text"
],
"type": "object"
},
"type": "array"
},
"next_page_token": {
"description": "下一页分页令牌；为空表示没有下一页，续页需保持同一用户。",
"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"
],
"additionalProperties": false
}🟢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"
}
}社区
证据
最近观测
已验证未记录版本15 个工具