SocialDataX Haokan MCP

npx add-mcp 'https://mcp.socialdatax.com/haokan/mcp'

好看视频 MCP | Haokan MCP

SocialDataX / 社媒数据助手 provides a hosted, read-only MCP service for public Haokan video and creator data. This repository contains connection metadata and client examples.

Connection

• Endpoint: https://mcp.socialdatax.com/haokan/mcp
• Transport: streamable-http
• API Key: set SOCIALDATAX_API_KEY and send Authorization: Bearer <SOCIALDATAX_API_KEY>.
• Website and API Key access: https://socialdatax.com/ai?from=github
• Registry name: com.socialdatax/haokan
• Local metadata: 0.1.0, 15 tools including the shared points balance tool.
• Hosted discovery: 0.1.0, 15 tools, verified on 2026-10-16.
• Official Registry: 0.1.0, verified active/latest on 2026-10-16.

Capabilities

Search public videos and creators; get keyword suggestions and hot searches; read video details, comments, comment replies, creator profiles and creator video lists. The service does not provide account login, posting, editing, liking, following or writing comments.

Search results may omit an author ID. Use a nonempty ID or profile URL returned by a creator or video detail tool rather than inferring an ID from a display name.

Tools

Tool	Purpose
haokan_get_comment_replies_by_video_id	按视频 ID和一级评论 ID 读取完整回复列表，支持分页；comment_id 取视频评论列表，另一入口使用 haokan_get_comment_replies_by_url。
haokan_get_comment_replies_by_url	按视频页面链接和一级评论 ID 读取完整回复列表，支持分页；comment_id 取视频评论列表，另一入口使用 haokan_get_comment_replies_by_video_id。
haokan_get_video_comments_by_video_id	按视频 ID读取好看视频一级评论，支持分页；附带的回复仅为预览。另一种输入使用 haokan_get_video_comments_by_url。
haokan_get_video_comments_by_url	按视频页面链接读取好看视频一级评论，支持分页；附带的回复仅为预览。另一种输入使用 haokan_get_video_comments_by_video_id。
haokan_search_videos	按关键词搜索好看视频，返回视频摘要并支持分页；用于查找视频，不用于读取指定视频链接的详情或查找用户。
haokan_search_users	按关键词搜索好看视频用户、账号或创作者，返回用户摘要并支持分页；不用于搜索视频。
haokan_search_suggestions	获取好看视频搜索联想词，用于补全或扩展关键词；不返回视频或用户结果，不支持分页。
haokan_get_hot_search_list	获取好看视频当前搜索热词及热度；不返回热门视频列表，不支持分页。
haokan_get_video_detail_by_video_id	按视频 ID 读取好看视频详情、播放地址和作者摘要；持有页面链接时使用 haokan_get_video_detail_by_url。播放地址可能过期。
haokan_get_video_detail_by_url	按页面链接读取好看视频详情、播放地址和作者摘要；只有视频 ID 时使用 haokan_get_video_detail_by_video_id。播放地址可能过期。
haokan_get_user_info_by_user_id	按用户 ID 获取好看视频用户资料；ID 可从用户搜索结果获取，持有主页链接时使用 haokan_get_user_info_by_url；不返回作品列表。
haokan_get_user_info_by_url	按用户主页链接获取好看视频用户资料；只有用户 ID 时使用 haokan_get_user_info_by_user_id；不返回作品列表。
haokan_get_user_posted_videos_by_user_id	按用户 ID 获取好看视频用户发布视频列表，支持分页；持有用户主页链接时使用 haokan_get_user_posted_videos_by_profile_url。
haokan_get_user_posted_videos_by_profile_url	按用户主页链接获取好看视频用户发布视频列表，支持分页；不要传视频链接，已有用户 ID 时使用 haokan_get_user_posted_videos_by_user_id。
socialdatax_get_points_balance	Query the current API Key account's SocialDataX points balance.

For supported search and list tools, leave page_token empty on the first call and pass the returned next_page_token unchanged on the next call, keeping the same keyword or object. An empty token marks the end. Use video IDs and comment IDs returned by the service; do not substitute a reply ID for its parent comment ID.

Client examples

• Streamable HTTP
• Codex
• Cursor
• Claude Desktop fallback

The command/stdio fallback in mcp.json uses mcp-remote. Direct HTTP clients should use the hosted endpoint.

Verification scope

2026-10-16 authenticated production checks covered video search, video details, empty and nonempty comments, two reply pages, a creator profile and two creator-video pages. All checked continuation pages returned nonempty results. Tool discovery does not guarantee a complete video or comment history.

Metadata

server-card.json contains the tool descriptions and input schemas. The implementation is privately hosted. License: MIT for the public documentation and connection examples.