mcpField
X
xurl

xurl

github.com/openclaw营销与增长393.3k4.9k 次安装今天更新
代码仓库

关于 xurl

xurl 是用于操作 X API 的命令行技能。它为发帖、搜索、用户和媒体任务提供快捷命令，也支持直接访问 v2 端点。

主要功能

  1. 01发布、回复、引用、删除和读取帖子
  2. 02搜索帖子并查询用户
  3. 03上传媒体并查看处理状态
  4. 04管理身份验证和应用选择
  5. 05通过原始模式调用任意 v2 端点

适用场景

  1. 01通过命令行发布或管理帖子
  2. 02搜索 X 并获取用户信息
  3. 03上传媒体并将其附加到帖子
  4. 04调用快捷命令未覆盖的 API 端点

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/openclaw/openclaw --skill xurl

安装后在 Claude Code 中输入/xurl确认已加载。

详细介绍

xurl

使用 xurl 处理 X API 相关工作。快捷命令返回 JSON；原始模式适用于任何 v2 端点。

认证

  • ~/.xurl 保存令牌；请使用 xurl auth status 检查认证状态，而不是读取该文件。
  • 通过提示将机密信息传递给认证命令，不要内联传递，以免出现在 shell 历史记录中。
  • --verbose 会将认证标头打印到工具输出中。

常用快捷命令

xurl post "Hello world!"
xurl reply POST_ID "Nice."
xurl quote POST_ID "My take"
xurl delete POST_ID
xurl read POST_ID
xurl search "query" -n 20
xurl whoami
xurl user @handle
xurl timeline -n 20
xurl mentions -n 10
xurl like POST_ID
xurl unlike POST_ID
xurl repost POST_ID
xurl unrepost POST_ID
xurl bookmark POST_ID
xurl unbookmark POST_ID
xurl followers -n 20
xurl following -n 20
xurl follow @handle
xurl unfollow @handle
xurl block @handle
xurl unblock @handle
xurl mute @handle
xurl unmute @handle
xurl dm @handle "message"
xurl dms -n 10

POST_ID 可以是完整的 https://x.com/<user>/status/<id> URL。

媒体

xurl media upload image.jpg
xurl media upload clip.mp4
xurl media status MEDIA_ID
xurl post "caption" --media-id MEDIA_ID

视频可能需要处理；请轮询 media status。

认证/应用管理

xurl auth status
xurl auth apps list
xurl auth default
xurl auth default APP_NAME USERNAME
xurl auth apps remove APP_NAME

每个请求：

xurl --app APP_NAME /2/users/me
xurl --auth oauth2 /2/users/me

原始 API

xurl /2/users/me
xurl -X POST /2/tweets -d '{"text":"Hello world!"}'
xurl '/2/tweets/search/recent?query=openclaw&max_results=10'

快捷命令未涵盖端点时，请使用原始模式。对于复杂的 JSON，请将有效载荷保存在临时文件中。

输出和错误

  • 成功时向标准输出写入 JSON。
  • API、认证或网络错误会导致非零退出。
  • 401/403：认证、权限范围或应用不匹配；请检查 xurl auth status。
  • 429：受到速率限制；请退避。
  • 媒体上传失败：请检查文件类型/大小和媒体处理状态。

评论

支持 Markdown