SocialDataX 红果 Hongguo Short Drama MCP

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

红果短剧 MCP | Hongguo Short Drama MCP

SocialDataX / 社媒数据助手 provides a hosted, read-only MCP service for Hongguo short drama search, series and episode details, reviews, video comments and episode download links. This repository contains public connection metadata and client examples.

接入 / Connection

• Endpoint: https://mcp.socialdatax.com/hongguo/mcp
• Transport: Streamable HTTP
• Authentication: Authorization: Bearer <SOCIALDATAX_API_KEY>; replace the placeholder with your own key.
• 官网与 API Key / Website: https://socialdatax.com/ai?from=github
• Hosted identity: com.socialdatax/hongguo, version 0.1.0
• Tool discovery: 12 tools (11 Hongguo tools and the shared points balance tool), verified on 2026-11-10.

Business calls consume SocialDataX credits. Check the returned points information; discovery alone does not run a business request. Never publish your API Key in a repository or share it with a directory reviewer.

能力 / Capabilities

• 综合搜索红果剧集、影片和图文帖子，支持内容类型筛选和分页。
• 按剧集 ID、分享链接或分享文案读取剧集详情和完整分集列表。
• 读取整剧评分剧评及楼中楼回复；读取单集视频与独立视频的评论和回复。
• 按单集 ID 获取各清晰度下载地址与解密密钥；单集分享链接入口目前支持 novelquickapp.com 漫剧链接。地址可能过期，下载后可按工具说明在本地使用 FFmpeg 解密。
• 查询自己的 SocialDataX 积分余额。

当前不提供官方周榜、历史榜单或排名趋势。搜索、剧集详情和下载链接为不同工具，请按输入对象选择。整剧剧评与单集评论使用独立入口。

工具 / Tools

Tool	Purpose
hongguo_get_video_comments_by_video_id	按video_id读取一页红果视频评论，支持剧集单集及独立视频，返回正文、作者、计数及next_page_token。剧集分集ID可来自剧集详情的分集列表；有单集分享链接或整段分享文案时使用hongguo_get_video_comments_by_video_url。整剧评分剧评使用hongguo_get_series_comments_by_series_id。回复使用返回的video_id和主评论comment_id调用hongguo_get_video_comment_replies_by_comment_id。
hongguo_get_video_comments_by_video_url	按红果单集分享链接或包含链接的整段文案读取分享时对应分集的评论。需链接明确包含单集信息；不默认第一集。返回items和next_page_token，条目含video_id，可用于续页或读取回复；整剧剧评使用hongguo_get_series_comments_by_url。
hongguo_get_video_comment_replies_by_comment_id	读取红果视频主评论下的一页回复，支持剧集单集及独立视频。video_id和comment_id来自视频评论条目；返回回复正文、作者、回复目标及next_page_token。不接收level；整剧剧评及楼中楼使用hongguo_get_series_comment_replies_by_comment_id。续页保持同一视频和主评论，原样传回page_token。
hongguo_search_general	按关键词综合搜索红果剧集、影片和图文帖子，支持内容类型筛选和分页；返回精简业务信息，聚合结果已展开。不提供独立剧集或视频页签搜索，也不解析播放地址。
hongguo_get_series_detail_by_series_id	按series_id获取红果剧集详情和完整分集列表；ID可来自红果搜索结果。持有分享链接或整段分享文案时使用 hongguo_get_series_detail_by_url。不提供播放或下载地址。
hongguo_get_series_detail_by_url	使用红果剧集分享链接或整段分享文案获取详情和完整分集列表；已有series_id时使用 hongguo_get_series_detail_by_series_id。不提供播放或下载地址。
hongguo_get_video_download_links_by_video_id	按单集video_id获取红果各清晰度的视频下载地址和解密密钥；ID可来自剧集详情的分集列表。已有单集ID时使用此工具。
hongguo_get_video_download_links_by_video_url	按红果单集分享链接或分享文案获取分享时对应分集的各清晰度下载地址和解密密钥；当前支持novelquickapp.com的漫剧分享链接。用户提供此类链接时使用。
hongguo_get_series_comments_by_series_id	读取红果整剧剧评列表，一次返回一页剧评业务字段、作者、评分及next_page_token，不读取单集视频评论。series_id可来自搜索或剧集详情；有分享链接或分享文案时使用hongguo_get_series_comments_by_url；读取评论下的回复时使用hongguo_get_series_comment_replies_by_comment_id。
hongguo_get_series_comments_by_url	按整剧分享链接或包含链接的整段分享文案读取一页红果整剧剧评，返回items与分页信息，条目包含整剧ID，不读取单集视频评论。续页保持同一剧集并将next_page_token原样作为page_token传回；已有series_id时使用hongguo_get_series_comments_by_series_id。剧评回复使用同一条目中的series_id和comment_id。
hongguo_get_series_comment_replies_by_comment_id	读取红果整剧剧评回复，一次返回一页回复正文、作者、根剧评及回复目标和分页信息，不读取单集视频评论。level=2读取主评论下的回复，level=3读取父回复下的楼中楼；保持剧集、评论或父回复及层级不变续页。
socialdatax_get_points_balance	查询当前 API Key 账户的 SocialDataX 积分余额、剩余积分或点数 / remaining points balance。需要充值时请访问 https://socialdatax.com/dashboard/billing。

首次分页不传或留空 page_token，续页原样传回 next_page_token 并保持同一查询对象及筛选条件。剧集 ID、单集 ID、评论 ID 和回复 ID 不可混用。

客户端配置 / Clients

• Streamable HTTP
• Codex
• Cursor
• Claude Desktop via mcp-remote

server-card.json includes the complete tool descriptions and input schemas. mcp.json contains the stdio fallback using mcp-remote. Direct HTTP clients connect to the endpoint above.

For Gemini CLI:

gemini extensions install https://github.com/DevinChen2014/hongguo-mcp

Enter your own SOCIALDATAX_API_KEY, then inspect gemini mcp list. The extension connects to the hosted service; private implementation code is not included.

验证范围 / Verification

2026-11-10: authenticated initialize and tools/list matched the public hosted server card, including all 12 names, descriptions, annotations and complete input schemas. This publication check did not invoke paid business tools or verify third-party client execution. API responses, availability and supported share-link formats govern actual content access.

Public documentation and connection examples: MIT. Hosted service implementation remains private.