SocialDataX 知乎 Zhihu MCP

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

{
  "type": "object",
  "required": [
    "content_url",
    "comment_id"
  ],
  "properties": {
    "comment_id": {
      "type": "string",
      "description": "一级评论 ID；用户已提供时直接使用，否则请直接复制 zhihu_get_content_comments_by_url 返回的 items[*].comment_id；不要传评论回复项自身的 comment_id。"
    },
    "page_token": {
      "type": "string",
      "default": "",
      "description": "知乎评论回复分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一 content_url 和同一 comment_id 链路；更换链接或一级评论 comment_id 时，请清空 page_token 后从第一页重新读取回复。"
    },
    "content_url": {
      "type": "string",
      "description": "知乎内容页面链接；用户已提供时直接使用，否则请直接复用读取该一级评论时使用的回答页链接（包括带视频的回答）、专栏文章链接或独立视频链接；通常直接复用 zhihu_get_content_comments_by_url 使用的 content_url；不要只传 content_id 或数字 ID，不要传接口地址、短链接、移动端链接、包含链接的分享文案、问题页链接或作者主页链接；支持回答页链接 https://www.zhihu.com/question/{question_id}/answer/{answer_id}、专栏文章链接 https://zhuanlan.zhihu.com/p/{article_id}、独立视频链接 https://www.zhihu.com/zvideo/{zvideo_id}。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "content_url"
  ],
  "properties": {
    "sort_type": {
      "enum": [
        "default",
        "time_descending"
      ],
      "type": "string",
      "default": "default",
      "description": "评论排序方式：default=默认，time_descending=最新。如无明确排序需求，保持 default。"
    },
    "page_token": {
      "type": "string",
      "default": "",
      "description": "知乎评论分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一 content_url 和同一排序链路；更换链接或排序时，请清空 page_token 后从第一页重新读取评论。"
    },
    "content_url": {
      "type": "string",
      "description": "知乎内容页面链接；只传回答页链接（包括带视频的回答）、专栏文章链接或独立视频链接；从搜索结果中的 answer、article、video 或 videoanswer 读取评论时，直接传该结果里非空的 content_url；不要只传 content_id 或数字 ID，不要传接口地址、短链接、移动端链接、包含链接的分享文案、问题页链接或作者主页链接；支持回答页链接 https://www.zhihu.com/question/{question_id}/answer/{answer_id}、专栏文章链接 https://zhuanlan.zhihu.com/p/{article_id}、独立视频链接 https://www.zhihu.com/zvideo/{zvideo_id}。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "content_url"
  ],
  "properties": {
    "content_url": {
      "type": "string",
      "description": "知乎内容页面链接；只传下面四类已支持的知乎网页链接格式，不要传接口地址、短链接、移动端链接或包含链接的分享文案；从搜索结果读取详情时，直接传搜索结果里非空的 content_url；不要只传 content_id 或数字 ID，不要自行拼接链接；不要传问题页链接或作者主页链接；支持回答页链接（包括带视频的回答） https://www.zhihu.com/question/{question_id}/answer/{answer_id}、专栏文章链接 https://zhuanlan.zhihu.com/p/{article_id}、独立视频链接 https://www.zhihu.com/zvideo/{zvideo_id}、想法链接 https://www.zhihu.com/pin/{pin_id}。"
    }
  },
  "additionalProperties": false
}

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

{
  "type": "object",
  "required": [
    "profile_url"
  ],
  "properties": {
    "profile_url": {
      "type": "string",
      "description": "知乎用户主页链接；只传 https://www.zhihu.com/people/{url_token} 这种主页链接；不要传 user_id、昵称、回答链接、专栏文章链接、问题页链接、接口地址、短链接、移动端链接或包含链接的分享文案；从用户搜索结果继续时，直接复用所选用户的 items[].profile_url；从内容搜索、详情、评论或评论回复结果继续时，复用所选作者的 author.profile_url。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "profile_url"
  ],
  "properties": {
    "page_token": {
      "type": "string",
      "default": "",
      "description": "知乎用户发布文章列表分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一 profile_url 的文章列表链路；更换作者时，请清空 page_token 后从第一页重新读取。"
    },
    "profile_url": {
      "type": "string",
      "description": "知乎用户主页链接；只传 https://www.zhihu.com/people/{url_token} 这种主页链接；不要传 user_id、昵称、回答链接、专栏文章链接、问题页链接、接口地址、短链接、移动端链接或包含链接的分享文案；从用户搜索结果继续时，直接复用所选用户的 items[].profile_url；从内容搜索、详情、评论或评论回复结果继续时，复用所选作者的 author.profile_url；从博主信息结果继续时，复用返回的 profile_url。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "job_id"
  ],
  "properties": {
    "job_id": {
      "type": "string",
      "description": "口播转文字任务 ID；用户已提供时直接使用，否则使用 zhihu_submit_video_speech_text_by_video_url 或 zhihu_submit_video_speech_text_by_zvideo_id 返回的 job_id；任务未完成时继续原样传入同一个 job_id，不要重复提交。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "keyword"
  ],
  "properties": {
    "keyword": {
      "type": "string",
      "description": "知乎内容搜索词，可传关键词或短语，例如问题、话题、人物、机构或内容需求；不要传问题链接、回答链接、专栏文章链接、视频链接、用户主页链接或 page_token。"
    },
    "sort_type": {
      "enum": [
        "general",
        "upvote_count_descending",
        "time_descending"
      ],
      "type": "string",
      "default": "general",
      "description": "排序方式：general=综合排序，upvote_count_descending=最多赞同，time_descending=最新发布。如无明确排序需求，保持 general。"
    },
    "page_token": {
      "type": "string",
      "default": "",
      "description": "知乎搜索分页令牌。首次请求留空。继续翻页时必须将上一页返回的完整 next_page_token 原样作为 page_token 传回；page_token 是不透明分页令牌；不得修改、截断、缩写、脱敏、掩码、省略、规范化、重组或自行生成，不得用省略号替换中间内容。只能用于同一关键词、同一类型筛选、同一排序和同一发布时间筛选链路。更换关键词、类型、排序或发布时间筛选时，请清空 page_token 后从第一页重新搜索。"
    },
    "content_type": {
      "enum": [
        "all",
        "answer",
        "article",
        "video"
      ],
      "type": "string",
      "default": "all",
      "description": "内容类型筛选：all=不限类型，answer=只看回答，article=只看文章，video=只看视频内容（可能返回独立视频 video 或带视频的回答 videoanswer；videoanswer 不是独立视频，也不是筛选取值）。"
    },
    "publish_time_range": {
      "enum": [
        "all",
        "day",
        "week",
        "month",
        "three_months",
        "half_year",
        "year"
      ],
      "type": "string",
      "default": "all",
      "description": "发布时间筛选：all=不限时间，day=一天内，week=一周内，month=一月内，three_months=三月内，half_year=半年内，year=一年内。如无明确筛选需求，保持 all。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "keyword"
  ],
  "properties": {
    "keyword": {
      "type": "string",
      "description": "搜索关键词或短语；不要传链接、用户 ID 或 page_token。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "keyword"
  ],
  "properties": {
    "keyword": {
      "type": "string",
      "description": "用户搜索关键词或短语，例如账号名；不要传主页链接、用户 ID 或 page_token。"
    },
    "page_token": {
      "type": "string",
      "default": "",
      "description": "首页留空；后续原样传入同一关键词用户搜索返回的 next_page_token，不可跨能力使用。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "video_url"
  ],
  "properties": {
    "video_url": {
      "type": "string",
      "description": "知乎视频内容页面链接；支持独立视频 https://www.zhihu.com/zvideo/{zvideo_id}，以及带视频回答 https://www.zhihu.com/question/{question_id}/answer/{answer_id}；从搜索结果继续处理 videoanswer 时直接传其非空 content_url。普通无视频回答、专栏文章页、问题页、用户主页、接口地址、短链接和只包含数字的 ID 不可处理。"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "required": [
    "zvideo_id"
  ],
  "properties": {
    "zvideo_id": {
      "type": "string",
      "description": "知乎独立视频 zvideo_id；用户已提供时原样使用，否则可从独立视频详情结果的 content_id 复制；必须是数字字符串。不要传视频链接、回答 ID、文章 ID 或问题 ID。"
    }
  },
  "additionalProperties": false
}