用途:xurl 是 X(Twitter)API 的命令行工具,既提供人类与智能体友好的快捷命令,也支持 curl 风格直接访问任意 v2 端点,所有命令结果以 JSON 输出到 stdout。
主要能力:发帖、回复、引用、删除、读取帖子、搜索帖子、查看自身信息、查询用户、主页时间线、提及、点赞/取消、转推/撤销、书签管理、关注/取关、拉黑/取消、静音/取消、发送与列出私信、媒体上传与状态查询。帖子 ID 处可直接粘贴完整帖子 URL,用户名前导 @ 可省略。
安装:brew install --cask xdevplatform/tap/xurl;npm install -g @xdevplatform/xurl;curl -fsSL https://raw.githubusercontent.com/xdevplatform/xurl/main/install.sh | bash(安装到 ~/.local/bin);go install github.com/xdevplatform/xurl@latest。
使用方式:使用前须完成认证,可用 xurl auth status 检查。注册应用凭据须由用户在智能体/LLM 会话之外手动完成,之后运行 xurl auth oauth2。多应用可用 xurl auth default prod-app 切换,或用 xurl --app dev-app /2/users/me 单次覆盖。原始访问示例:xurl /2/users/me、xurl -X POST /2/tweets -d '{"text":"Hello world!"}'。流式端点自动识别,也可用 -s 强制。
安全限制:严禁读取、打印、解析、上传或发送 ~/.xurl 到 LLM 上下文;不要让用户把凭据粘贴到聊天;不要在智能体会话中使用 --bearer-token、--consumer-key、--consumer-secret、--access-token、--token-secret、--client-id、--client-secret 等敏感参数;不要使用 --verbose/-v,以免泄露认证头或令牌。
其他限制:X API 按端点限流,遇到 429 需等待重试,写操作限制更严;403 可能因令牌缺少所需 scope,可重新运行 xurl auth oauth2;OAuth 2.0 令牌过期会自动刷新。令牌以 YAML 存于 ~/.xurl,各应用凭据与令牌相互隔离。