SocialDataX 好看视频 Haokan MCP
Haokan video/user search, details, comments/replies, creators, creator videos and hot searches.
사용해야 할까요
품질 및 안전성
발견 사항 (15)
- HIGH
- MEDIUMsocialdatax_get_points_balance에서
- LOWhaokan_search_videos에서
- LOWhaokan_search_users에서
- LOWhaokan_search_suggestions에서
- LOWhaokan_get_hot_search_list에서
- LOWsocialdatax_get_points_balance에서
- LOWhaokan_get_comment_replies_by_video_id에서
- LOWhaokan_get_comment_replies_by_url에서
- LOWhaokan_get_video_comments_by_video_id에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`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"
}
}커뮤니티
증거