Skip to main content
Glama

SocialDataX X / Twitter MCP

x_get_user_info_by_user_id

Read-only

根据 X 用户 ID 获取公开用户信息;已有完整 user_id 时直接使用。

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
user_idYesX 用户稳定数字 ID;用户已提供时原样使用,否则可从搜索、详情、评论或评论回复结果的非空 author.user_id、用户帖子列表结果的非空 author.user_id,或用户信息结果的非空 user_id 原样复制;必须是数字字符串;不要传用户名、用户主页链接、帖子链接或分享文案。

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
bioYes用户个人简介;没有或不可用时为空字符串。
nameYes用户展示名;不是 username;不可用时为空字符串。
pointsYes本次成功调用的积分消耗与调用完成时的账户积分余额。
user_idYesX 用户稳定数字 ID;不可用时为空字符串。
locationYes用户主页资料里填写的所在地;不是 IP 属地;不可用时为空字符串。
usernameYesX 用户名,不带 @;不可用时为空字符串。
avatar_urlYes头像链接;不可用时为 null。
is_privateYes是否私密/受保护账号;不可用时为 null。
post_countYes累计发帖数;不可用时为 null。
is_verifiedYes是否显示 X 认证标识;不可用时为 null。
profile_urlYes用户主页链接;不可用时为 null。
external_urlYes用户主页填写的网站或外部链接;不是用户主页链接;标准用户主页请使用 profile_url;不可用时为 null。
verified_typeYes认证类型补充文本;不用于判断是否认证,应以 is_verified 为准;没有或不可用时为 null。
follower_countYes粉丝数;不可用时为 null。
following_countYes关注数;不可用时为 null。
pinned_post_idsYes置顶帖子 ID 列表;可用于 x_get_post_detail_by_post_id;没有或不可用时为空数组。
header_image_urlYes用户主页头图链接;不可用时为 null。
media_post_countYes累计媒体帖数;不可用时为 null。
account_created_timeYes账号创建时间,秒级 Unix 时间戳;不可用时为 null。
affiliated_account_countYes该账号关联的账号数量;不可用时为 null。

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A4/5.0
Behavior3/5

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

注解声明了readOnlyHint和openWorldHint,描述未添加额外行为信息。虽无矛盾,但描述未补充诸如数据来源或限制等上下文,仅依赖注解。

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?

描述仅一句话,无冗余,直接传达核心用途和条件。

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?

工具简单,单参数,有输出schema,注解覆盖安全属性。描述提供了使用条件,但未提及错误场景或特殊要求,整体足够但仍可更完整。

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描述覆盖了参数user_id的完整说明(数字字符串、来源等),描述未增加额外信息,符合基线3。

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

Purpose5/5

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

描述明确说明根据X用户ID获取公开用户信息,动词'获取'和资源'用户信息'清晰。与兄弟工具(通过用户名或URL获取)区分明确。

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?

描述了使用条件(已有完整user_id时直接使用),但未明确提及何时不使用或替代工具。尽管兄弟工具名称暗示了替代方案,但描述未显式说明,缺乏明确的when-not。

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