SocialDataX YouTube MCP

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "channel_url"
  ],
  "properties": {
    "channel_url": {
      "type": "string",
      "description": "YouTube 频道主页链接；支持 https://www.youtube.com/@用户名、/channel/、/c/ 和 /user/ 链接形态。如果传入频道 tab 子页链接，会规范化到对应的 https://www.youtube.com/... 频道主页。从搜索、详情、评论或评论回复结果读取频道资料时，直接传 author.profile_url；不要传 channel_id、裸 @用户名、频道名称、视频链接、播放列表链接或搜索页链接。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "channel_url"
  ],
  "properties": {
    "page_token": {
      "type": "string",
      "default": "",
      "description": "YouTube 频道发布列表分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一频道、同一 video_type 的视频续页；更换频道或 video_type 时，请清空 page_token 后从第一页重新读取。"
    },
    "video_type": {
      "enum": [
        "video",
        "short"
      ],
      "type": "string",
      "default": "video",
      "description": "频道发布视频类型：video=频道“视频”tab，short=频道 Shorts tab。默认 video。当前不支持 live、course 或 playlist。更换 video_type 时，请清空 page_token 后从第一页重新读取。"
    },
    "channel_url": {
      "type": "string",
      "description": "YouTube 频道主页链接；支持 https://www.youtube.com/@用户名、/channel/、/c/ 和 /user/ 链接形态。如果传入频道 tab 子页链接，会规范化到对应的 https://www.youtube.com/... 频道主页。从搜索、详情、评论、评论回复或频道资料结果读取作者发布视频或 Shorts 时，直接传 author.profile_url 或 profile_url；不要传 channel_id、裸 @用户名、频道名称、视频链接、播放列表链接或搜索页链接。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "reply_token"
  ],
  "properties": {
    "page_token": {
      "type": "string",
      "default": "",
      "description": "YouTube 评论回复分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一 reply_token 对应的评论回复续页；更换 reply_token 时，请清空 page_token 后从第一页重新读取评论回复。继续翻页时，reply_token 仍传同一条一级评论的原始 reply_token，同时把上一页返回的完整 next_page_token 原样作为 page_token 传回。"
    },
    "reply_token": {
      "type": "string",
      "description": "读取某条 YouTube 视频一级评论回复所需的不透明令牌；用户已提供时直接原样使用；否则从 youtube_get_video_comments_by_url 返回的 items[*].reply_token 原样复制。只有有效且非空的 reply_token 才调用本工具；不要传 comment_id、video_url、video_id、频道链接、播放列表链接或搜索页链接。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "video_url"
  ],
  "properties": {
    "sort_type": {
      "enum": [
        "hot",
        "time_descending"
      ],
      "type": "string",
      "default": "hot",
      "description": "评论排序方式：hot=热门评论，time_descending=较新评论优先。YouTube 可能保留作者评论或置顶评论在当前页前部；如无明确排序需求，保持 hot。"
    },
    "video_url": {
      "type": "string",
      "description": "YouTube 视频页面链接；支持 watch、youtu.be 短链和 Shorts 链接。从搜索结果读取评论时，直接传搜索结果里的 share_url（items[*].share_url）；不要传频道链接、播放列表链接、搜索页链接或裸 video_id。"
    },
    "page_token": {
      "type": "string",
      "default": "",
      "description": "YouTube 视频评论分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一视频和同一 sort_type 的评论续页；更换视频或 sort_type 时，请清空 page_token 后从第一页重新读取评论。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "video_url"
  ],
  "properties": {
    "video_url": {
      "type": "string",
      "description": "YouTube 视频页面链接；支持 watch、youtu.be 短链和 Shorts 链接。从搜索结果读取详情时，直接传搜索结果里的 share_url（items[*].share_url）；不要传频道链接、播放列表链接、搜索页链接或裸 video_id。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "job_id"
  ],
  "properties": {
    "job_id": {
      "type": "string",
      "description": "口播转文字任务 ID；用户已提供时直接使用，否则使用 YouTube submit 工具返回的 job_id；不要传 video_id 或视频链接。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "keyword"
  ],
  "properties": {
    "keyword": {
      "type": "string",
      "minLength": 1,
      "description": "频道搜索词，例如 AI、露营或创作者名称；不要传视频链接、频道链接、频道 ID 或分页令牌。"
    },
    "page_token": {
      "type": "string",
      "default": "",
      "description": "首屏留空；续页原样传上次返回的 next_page_token，并保持 keyword 不变。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "keyword"
  ],
  "properties": {
    "keyword": {
      "type": "string",
      "minLength": 1,
      "description": "搜索关键词或短语，例如 camping、美食；不要传视频链接、频道链接、ID 或分页令牌。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "video_url"
  ],
  "properties": {
    "video_url": {
      "type": "string",
      "description": "YouTube 视频页面链接；支持 watch、youtu.be 短链和 Shorts 链接。从搜索结果提交口播转文字任务时，直接传搜索结果里的 share_url（items[*].share_url）；不要传频道链接、播放列表链接、搜索页链接或裸 video_id。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "video_id"
  ],
  "properties": {
    "video_id": {
      "type": "string",
      "description": "YouTube 视频 ID，必须是 11 位字符串；可直接使用搜索结果 items[*].video_id。不要传视频链接、频道链接、播放列表链接或搜索页链接。"
    }
  },
  "additionalProperties": false
}