Skip to main content
Glama

SocialDataX 微信 WeChat MCP

wechat_get_video_detail_by_encrypted_object_id

Read-only

根据微信视频号合法 encrypted_object_id 获取视频详情;用户已提供时直接使用,否则可从 wechat_search_videos 或作者作品列表返回项获取。

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "encrypted_object_id": "<encrypted_object_id>"
    },
    "name": "wechat_get_video_detail_by_encrypted_object_id"
  }
}

Input Schema

NameRequiredDescriptionDefault
encrypted_object_idYes微信视频号合法 encrypted_object_id;用户已提供时原样使用,否则可从 wechat_search_videos 或作者作品列表返回项获取。

Output Schema

NameRequiredDescriptionDefault
videoYes视频资源信息;当前不可用时为 null
authorYes作者信息
imagesYes图文作品按顺序返回图片资源;视频作品为空数组
pointsYes本次成功调用的积分消耗与账户积分余额。
object_idYes微信视频号详情对象 ID;不可用时为空字符串
like_countYes点赞数
topic_tagsYes作品文案中的话题标签;无话题时为空数组;每项只返回 name
descriptionYes作品描述;不可用时为空字符串
ip_locationYes作品发布时的 IP 属地;没有 IP 属地时为空字符串
share_countYes转发/分享数
content_typeYes内容类型;视频返回 video,图文返回 image
publish_timeYes发布时间,秒级 Unix 时间戳
collect_countYes收藏数
comment_countYes评论数
cover_image_urlYes封面图或图文首图缩略资源链接;当前不可用时为 null
object_nonce_idYes微信视频号对象 nonce ID;后续评论等能力需要复用时原样保留

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedOutput schema / properties / points / description
      Previous value: -"本次成功调用的积分消耗与调用完成时的账户积分余额。"New value: +"本次成功调用的积分消耗与账户积分余额。"
    • changedOutput schema / properties / points / properties / balance / description
      Previous value: -"本次接口完成时看到的当前积分余额,可为负数。"New value: +"优先返回调用完成时查询到的账户积分余额。查询失败时,回退到本次预扣后的余额快照。余额可为负数。"
  2. Changed2 schema fields changed
    • changedOutput schema / properties / points / properties / balance / description
      Previous value: -"本次接口完成时看到的当前积分余额。"New value: +"本次接口完成时看到的当前积分余额,可为负数。"
    • removedOutput schema / properties / points / properties / balance / minimum
      Removed value: -0
  3. Changed26 schema fields changed
    • addedOutput schema / properties / author / properties / avatar_url / title
      Added value: +"Avatar Url"
    • addedOutput schema / properties / author / properties / bio / title
      Added value: +"Bio"
    • addedOutput schema / properties / author / properties / name / title
      Added value: +"Name"
    • addedOutput schema / properties / author / properties / user_id / title
      Added value: +"User Id"
    • addedOutput schema / properties / author / title
      Added value: +"WechatVideoDetailAuthorData"
    • addedOutput schema / properties / collect_count / title
      Added value: +"Collect Count"
    • addedOutput schema / properties / comment_count / title
      Added value: +"Comment Count"
    • addedOutput schema / properties / content_type / title
      Added value: +"Content Type"
    • addedOutput schema / properties / cover_image_url / title
      Added value: +"Cover Image Url"
    • addedOutput schema / properties / description / title
      Added value: +"Description"
    • addedOutput schema / properties / images / items / properties / height / title
      Added value: +"Height"
    • addedOutput schema / properties / images / items / properties / url / title
      Added value: +"Url"
    • addedOutput schema / properties / images / items / properties / width / title
      Added value: +"Width"
    • addedOutput schema / properties / images / items / title
      Added value: +"WechatVideoDetailImageData"
    • addedOutput schema / properties / images / title
      Added value: +"Images"
    • addedOutput schema / properties / ip_location / title
      Added value: +"Ip Location"
    • addedOutput schema / properties / like_count / title
      Added value: +"Like Count"
    • addedOutput schema / properties / object_id / title
      Added value: +"Object Id"
    • addedOutput schema / properties / object_nonce_id / title
      Added value: +"Object Nonce Id"
    • addedOutput schema / properties / publish_time / title
      Added value: +"Publish Time"
    • addedOutput schema / properties / share_count / title
      Added value: +"Share Count"
    • addedOutput schema / properties / topic_tags / items / properties / name / title
      Added value: +"Name"
    • addedOutput schema / properties / topic_tags / items / title
      Added value: +"WechatTopicTagData"
    • addedOutput schema / properties / topic_tags / title
      Added value: +"Topic Tags"
    • changedOutput schema / properties / video / anyOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "duration_ms": {
      -        "anyOf": [
      -          {
      -            "type": "integer"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "视频时长,单位毫秒;当前不可用时为 null"
      -      },
      -      "height": {
      -        "anyOf": [
      -          {
      -            "type": "integer"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "视频高度,像素;当前不可用时为 null"
      -      },
      -      "video_url": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "微信视频号视频资源链接;用于后续下载或转附件处理,不保证可直接播放;不可用时为 null。"
      -      },
      -      "width": {
      -        "anyOf": [
      -          {
      -            "type": "integer"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "视频宽度,像素;当前不可用时为 null"
      -      }
      -    },
      -    "required": [
      -      "video_url",
      -      "duration_ms",
      -      "width",
      -      "height"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "duration_ms": {
      +        "anyOf": [
      +          {
      +            "type": "integer"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "视频时长,单位毫秒;当前不可用时为 null",
      +        "title": "Duration Ms"
      +      },
      +      "height": {
      +        "anyOf": [
      +          {
      +            "type": "integer"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "视频高度,像素;当前不可用时为 null",
      +        "title": "Height"
      +      },
      +      "video_url": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "微信视频号视频资源链接;用于后续下载或转附件处理,不保证可直接播放;不可用时为 null。",
      +        "title": "Video Url"
      +      },
      +      "width": {
      +        "anyOf": [
      +          {
      +            "type": "integer"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "视频宽度,像素;当前不可用时为 null",
      +        "title": "Width"
      +      }
      +    },
      +    "required": [
      +      "video_url",
      +      "duration_ms",
      +      "width",
      +      "height"
      +    ],
      +    "title": "WechatVideoDetailMediaData",
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
    • addedOutput schema / title
      Added value: +"WechatVideoDetailResult"
  4. Changed1 schema field changed
    • changedInput schema / properties / encrypted_object_id / description
      Previous value: -"微信视频号合法 encrypted_object_id;用户已提供时原样使用,否则可从 wechat_search_videos 返回项获取。"New value: +"微信视频号合法 encrypted_object_id;用户已提供时原样使用,否则可从 wechat_search_videos 或作者作品列表返回项获取。"
  5. Changed1 schema field changed
    • changedOutput schema / properties / video / anyOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "duration_ms": {
      -        "anyOf": [
      -          {
      -            "type": "integer"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "视频时长,单位毫秒;当前不可用时为 null"
      -      },
      -      "video_url": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "description": "微信视频号视频资源链接;用于后续下载或转附件处理,不保证可直接播放;不可用时为 null。"
      -      }
      -    },
      -    "required": [
      -      "video_url",
      -      "duration_ms"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "duration_ms": {
      +        "anyOf": [
      +          {
      +            "type": "integer"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "视频时长,单位毫秒;当前不可用时为 null"
      +      },
      +      "height": {
      +        "anyOf": [
      +          {
      +            "type": "integer"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "视频高度,像素;当前不可用时为 null"
      +      },
      +      "video_url": {
      +        "anyOf": [
      +          {
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "微信视频号视频资源链接;用于后续下载或转附件处理,不保证可直接播放;不可用时为 null。"
      +      },
      +      "width": {
      +        "anyOf": [
      +          {
      +            "type": "integer"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "description": "视频宽度,像素;当前不可用时为 null"
      +      }
      +    },
      +    "required": [
      +      "video_url",
      +      "duration_ms",
      +      "width",
      +      "height"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "type": "null"
      +  }
      +]
  6. Changed1 schema field changed
    • changedInput schema / properties / encrypted_object_id / description
      Previous value: -"微信视频号搜索结果返回的 encrypted_object_id;如果来自搜索结果,请原样传入。"New value: +"微信视频号合法 encrypted_object_id;用户已提供时原样使用,否则可从 wechat_search_videos 返回项获取。"
  7. Changed2 schema fields changed
    • changedOutput schema / properties / author / properties / user_id / description
      Previous value: -"作者微信视频号用户 ID;仅 v2_...@finder 可用于用户信息或用户发布视频列表工具;不可用时为空字符串"New value: +"作者微信视频号用户 ID;仅 v2_...@finder 可用于用户信息或用户发布作品列表工具;不可用时为空字符串"
    • changedOutput schema / properties / ip_location / description
      Previous value: -"视频发布时的 IP 属地;没有 IP 属地时为空字符串"New value: +"作品发布时的 IP 属地;没有 IP 属地时为空字符串"
  8. Changed2 schema fields changed
    • addedOutput schema / properties / points
      Added value: +{
      +  "additionalProperties": false,
      +  "description": "本次成功调用的积分消耗与调用完成时的账户积分余额。",
      +  "properties": {
      +    "balance": {
      +      "description": "本次接口完成时看到的当前积分余额。",
      +      "minimum": 0,
      +      "type": "integer"
      +    },
      +    "cost": {
      +      "description": "本次请求最终确认消耗的积分。",
      +      "minimum": 0,
      +      "type": "integer"
      +    }
      +  },
      +  "required": [
      +    "cost",
      +    "balance"
      +  ],
      +  "type": "object"
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "object_id",
      -  "object_nonce_id",
      -  "content_type",
      -  "description",
      -  "topic_tags",
      -  "cover_image_url",
      -  "video",
      -  "images",
      -  "like_count",
      -  "collect_count",
      -  "comment_count",
      -  "share_count",
      -  "publish_time",
      -  "ip_location",
      -  "author"
      -]New value: +[
      +  "object_id",
      +  "object_nonce_id",
      +  "content_type",
      +  "description",
      +  "topic_tags",
      +  "cover_image_url",
      +  "video",
      +  "images",
      +  "like_count",
      +  "collect_count",
      +  "comment_count",
      +  "share_count",
      +  "publish_time",
      +  "ip_location",
      +  "author",
      +  "points"
      +]
  9. Changed1 schema field changed
    • changedOutput schema / properties / author / properties / user_id / description
      Previous value: -"作者微信视频号用户 ID;不可用时为空字符串"New value: +"作者微信视频号用户 ID;仅 v2_...@finder 可用于用户信息或用户发布视频列表工具;不可用时为空字符串"
  10. Changed2 schema fields changed
    • addedOutput schema / properties / topic_tags
      Added value: +{
      +  "description": "作品文案中的话题标签;无话题时为空数组;每项只返回 name",
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "name": {
      +        "description": "话题标签名称",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "name"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "object_id",
      -  "object_nonce_id",
      -  "content_type",
      -  "description",
      -  "cover_image_url",
      -  "video",
      -  "images",
      -  "like_count",
      -  "collect_count",
      -  "comment_count",
      -  "share_count",
      -  "publish_time",
      -  "ip_location",
      -  "author"
      -]New value: +[
      +  "object_id",
      +  "object_nonce_id",
      +  "content_type",
      +  "description",
      +  "topic_tags",
      +  "cover_image_url",
      +  "video",
      +  "images",
      +  "like_count",
      +  "collect_count",
      +  "comment_count",
      +  "share_count",
      +  "publish_time",
      +  "ip_location",
      +  "author"
      +]
  11. First observed

TDQS

A3.8/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true and openWorldHint=true, and the output schema covers the return shape, so the safety and payload profile is known. The description adds only the implicit note that the id must be '合法' (invalid ids presumably fail) and nothing about error behavior, rate limits, or visibility scoping. No contradiction with the annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single compact sentence with the purpose front-loaded and the parameter sourcing trailing as a subordinate clause; there is no filler or repetition to cut.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a one-parameter read tool with an output schema and full schema coverage, the description covers purpose and how to obtain the required id, which is nearly everything an agent needs. The one real gap is that two sibling tools perform the same operation with different identifier types and the description offers no routing guidance between them.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% and the description's clause about the encrypted_object_id is nearly verbatim identical to the schema's own parameter description, so it adds essentially no new meaning. The sourcing hint (search_videos / author list) is the only added value, and it already appears in the schema text.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

Description states a concrete verb+resource (获取视频详情) together with the specific identifier type (合法 encrypted_object_id), which is enough for an agent to know what it returns. It never explains how this differs from the near-identically-named siblings wechat_get_video_detail_by_object_id or wechat_get_video_detail_by_url, so the differentiation is only implicit in the identifier name.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives clear operational guidance: if the user already supplied the id, use it as-is; otherwise obtain it from wechat_search_videos or an author's video list. That covers the 'when to use' and the prerequisite sourcing path, but no exclusion is stated for the by_url / by_object_id variants of the same operation.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources