用途
该技能为 X（Twitter）平台提供 API 访问能力，用于查询推文和用户资料。当用户提及 "X"、"Twitter"、"x.com"、"twitter.com"，分享推文链接，或要求查看 X 上的社交内容时触发使用。
主要能力
通过 xurl 命令行工具，可执行以下操作：
- 获取已认证用户资料：
xurl whoami - 按用户名查询用户：
xurl user elonmusk（前导 @ 可选） - 按用户 ID 查询用户：
xurl /2/users/12345?user.fields=id,name,username,description,public_metrics,created_at - 批量查询用户（最多 100 个）：
xurl '/2/users?ids=12345,67890&user.fields=id,name,username,description,public_metrics' - 按 ID 读取单条推文：
xurl read 1234567890（也支持完整 URL 形式） - 批量读取推文（最多 100 条）：
xurl '/2/tweets?ids=1234567890,0987654321&tweet.fields=created_at,public_metrics,author_id,text&expansions=author_id&user.fields=name,username' - 获取已认证用户的时间线：
xurl timeline -n 10 - 获取其他用户的时间线（原始 API）：
xurl '/2/users/USER_ID/tweets?max_results=10&tweet.fields=created_at,public_metrics,text&exclude=retweets,replies' - 获取用户提及：
xurl mentions -n 10 - 搜索近 7 天推文：
xurl search "openai lang:en -is:retweet" -n 10 - 获取用户关注者：
xurl followers --of elonmusk -n 20 - 获取用户正在关注：
xurl following --of elonmusk -n 20
使用方式
时间线查询参数（原始 API）
- max_results：5 到 100（默认 10）
- start_time / end_time：ISO 8601 日期时间过滤
- since_id / until_id：推文 ID 边界
- pagination_token：用于分页
- exclude：逗号分隔，可选 retweets、replies
搜索运算符
- from:username：来自特定用户的推文
- to:username：回复某用户的推文
- @username：提及某用户的推文
- #hashtag：包含某话题标签的推文
- has:links / has:images / has:videos：媒体过滤
- -is:retweet：排除转推
- -is:reply：排除回复
- lang:en：按语言过滤
- conversation_id:123：某对话线程中的推文
分页
大多数列表端点支持分页。快捷命令使用 -n 控制结果数量。原始 API 端点需检查响应中的 meta.next_token 字段：
xurl '/2/tweets/search/recent?query=example&max_results=10' | jq .meta
将返回的 next_token 值作为下一次请求的 pagination_token 以获取更多结果。
常用 user.fields
- id：唯一用户 ID
- name：显示名称
- username：用户名（不含 @）
- description：个人简介
- created_at：账号创建日期
- public_metrics：关注者、正在关注、推文和列表计数
- profile_image_url：头像 URL
- verified：认证状态
- location：用户自定义位置
- url：用户自定义 URL
常用 tweet.fields
- id：唯一推文 ID
- text：推文内容
- created_at：发布时间戳
- author_id：作者用户 ID
- public_metrics：转推、回复、点赞、引用、书签、展示次数
- conversation_id：线程根推文 ID
- lang：检测到的语言
- referenced_tweets：转推/引用/回复引用
- entities：URL、话题标签、提及、股票标签
适用场景
- 查询特定用户资料或批量用户信息
- 读取单条或多条推文详情
- 查看已认证用户或其他用户的时间线
- 查看用户提及
- 搜索近 7 天内的推文
- 获取用户的关注者或正在关注列表
限制
- 只读访问：该连接器仅授予读取权限，无法发帖、点赞或转推
- 速率限制：X API 有严格的速率限制，应避免快速连续调用
- 优先使用快捷命令：尽可能使用 xurl search、xurl user、xurl read 等，而非原始 API 路径
- 原始 API 回退：批量查询或高级查询时，使用 xurl '/2/...' 配合查询参数
- 字段需显式指定（仅原始 API）：原始端点默认只返回 id 和 text，需指定 tweet.fields 和 user.fields 获取更丰富数据；快捷命令会自动包含常用字段
- 7 天搜索窗口：近期搜索端点仅覆盖过去 7 天
- 分页：快捷命令使用 -n，原始 API 使用 max_results 和 pagination_token