mcpField
X
xurl

xurl

github.com/steipete其他7.4k106 次安装1 周前更新
代码仓库

关于 xurl

xurl 是 X API 的官方命令行工具，供用户和 Agent 发起经过身份验证的 X 请求。它既提供常用发帖和读取操作的快捷命令，也支持原始端点请求及多种身份验证方式。

主要功能

  1. 01发布、回复、引用、删除和读取帖子
  2. 02搜索帖子并查看当前账号
  3. 03向原始 API 端点发送请求
  4. 04选择 OAuth 1.0a、OAuth 2.0 或应用身份验证
  5. 05在已注册应用和账号间选择
  6. 06访问流式端点

适用场景

  1. 01通过命令行发布或回复帖子
  2. 02按查询条件搜索 X 帖子
  3. 03使用选定的身份验证方式调用 X API 端点
  4. 04读取 X API 流式数据

安装

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

$npx skills add https://github.com/steipete/agent-scripts --skill xurl

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

详细介绍

xurl

X API 的官方命令行工具。

上游项目：https://github.com/xdevplatform/xurl

安装

Homebrew：

brew install --cask xdevplatform/tap/xurl

npm：

npm install -g @xdevplatform/xurl

Shell 脚本：

curl -fsSL https://raw.githubusercontent.com/xdevplatform/xurl/main/install.sh | bash

Go：

go install github.com/xdevplatform/xurl@latest

安全

  • 切勿读取、打印、总结、上传或将 ~/.xurl 粘贴到大模型上下文中。
  • 切勿要求用户在聊天中粘贴客户端密钥、Bearer 令牌或 OAuth 令牌。
  • 在 Agent 运行期间切勿使用 --verbose；它可能会暴露身份验证标头。
  • 在 Agent 会话中不要使用内联密钥标志运行身份验证命令。
  • 用户必须在 Agent 会话之外，手动在自己的机器上注册应用凭据。

身份验证

检查当前状态：

xurl auth status

如果已注册应用，请完成 OAuth 2.0：

xurl auth oauth2

多应用：

xurl auth apps list
xurl auth default my-app
xurl auth default my-app alice
xurl --app dev-app /2/users/me

注意：

  • xurl 会将应用配置和令牌存储在 ~/.xurl 中。
  • X 开发者门户中的 OAuth 2.0 重定向 URI 应为 http://localhost:8080/callback。
  • 此处有意省略了包含内联密钥的应用注册示例。请在 Agent 会话之外完成此操作。

常用快捷方式

xurl post "Hello world!"
xurl reply 1234567890 "Nice post"
xurl quote 1234567890 "My take"
xurl delete 1234567890

xurl read 1234567890
xurl search "from:elonmusk" -n 10
xurl whoami
xurl user @XDevelopers
xurl timeline -n 20
xurl mentions -n 10

xurl like 1234567890
xurl unlike 1234567890
xurl repost 1234567890
xurl unrepost 1234567890

xurl bookmark 1234567890
xurl unbookmark 1234567890
xurl bookmarks -n 10
xurl likes -n 10

xurl follow @handle
xurl unfollow @handle
xurl following -n 20
xurl followers -n 20

xurl dm @handle "message"
xurl dms -n 10

xurl media upload path/to/file.mp4
xurl media status MEDIA_ID

POST_ID 也可以是完整的 X 状态 URL。

原始端点模式

GET：

xurl /2/users/me

POST JSON：

xurl -X POST /2/tweets -d '{"text":"Hello world!"}'

标头：

xurl -H "Content-Type: application/json" /2/tweets

选择身份验证类型：

xurl --auth oauth2 /2/users/me
xurl --auth oauth1 /2/tweets
xurl --auth app /2/users/me

选择 OAuth2 账户：

xurl --username alice /2/users/me

流式传输：

xurl /2/tweets/search/stream
xurl -s /2/users/me

快速检查

安装：

xurl version

身份验证：

xurl auth status

身份验证后的实时请求：

xurl whoami

评论

支持 Markdown