用途：xurl 是 X 开发者平台官方命令行工具，用于在终端或智能体会话中调用 X API，完成发帖、互动、社交关系、私信与媒体上传等操作，也可对任意 X API v2 端点做原始 curl 风格访问。相较旧的 xitter 技能，它由官方维护，支持 OAuth 2.0 PKCE 自动刷新，覆盖 API 面更广。
主要能力：发布、回复、引用和删除帖子；读取指定帖子；以认证账号身份搜索原始帖子（返回带 ID、作者、全文的帖子对象，可直接用于互动）；查看首页时间线、提及、whoami 和用户资料；点赞/取消、转推/撤销、书签/移除、列出书签和点赞；关注/取关、查看关注与粉丝、屏蔽/取消屏蔽、静音/取消静音；发送和列出私信；上传图片与视频并查询媒体处理状态；支持多应用、多账号与原始 API 请求；支持流式端点。所有命令输出 JSON 到 stdout，错误也以 JSON 返回，出错时退出码非零。
使用方式：先安装（任选其一）：curl -fsSL https://raw.githubusercontent.com/xdevplatform/xurl/main/install.sh | bash；brew install --cask xdevplatform/tap/xurl；npm install -g @xdevplatform/xurl；go install github.com/xdevplatform/xurl@latest。用 xurl --help 与 xurl auth status 验证。账号授权须由用户本人在智能体会话之外完成：在 X 开发者门户创建应用、把重定向 URI 设为 http://localhost:8080/callback，然后执行 xurl auth apps add my-app --client-id YOUR_CLIENT_ID --client-secret YOUR_CLIENT_SECRET、xurl auth oauth2 --app my-app（必要时追加用户名）、xurl auth default my-app。常用命令如 xurl post "Hello world!"、xurl reply POST_ID "Nice post!"、xurl search "QUERY" -n 10、xurl timeline -n 20、xurl dm @handle "message"、xurl media upload path/to/file.mp4。原始访问示例：xurl /2/users/me、xurl -X POST /2/tweets -d '{"text":"Hello world!"}'。POST_ID 可使用完整 URL，用户名带不带 @ 均可。
适用场景：需要真实帖子对象并直接互动的搜索与运营；批量或自动化发帖、回复、互动；时间线与提及监控；私信处理；图片视频发布；多应用多账号切换；以及对官方快捷命令未覆盖端点的原始调用。
限制与安全：安全规则为强制项。绝不可读取、打印、解析、摘要、上传或把 ~/.xurl 发送到模型上下文；不要让用户在聊天中粘贴凭据或令牌；凭据注册与轮换、OAuth 授权须由用户在会话外手动完成；会话中禁止使用 --verbose / -v，禁止使用可内联密钥的参数（--bearer-token、--consumer-key、--consumer-secret、--access-token、--token-secret、--client-id、--client-secret）；只可用 xurl auth status 检查凭据是否存在。X 有按端点的速率限制，429 需等待重试，写操作限制更严；403 通常表示令牌缺少作用域，需用户重跑授权。Docker 官方布局中 Hermes 工具子进程的 HOME 为 /opt/data/home，令牌位于 /opt/data/home/.xurl。X API 的有效使用通常为付费，失败多与套餐或权限有关。具体价格、配额与平台细节暂未提供。