SuperAPI AI 工具集

xurl

通用与其它

查看项目

更新于 10-16 08:33

技能介绍

用途:xurl 是用于 X API 的命令行工具,既提供快捷命令(便于人或智能体一行完成常见操作),也支持以原始 curl 风格访问任意 v2 端点。所有命令均将 JSON 输出到 stdout。

主要能力:发帖、回复、引用、删除、读取帖子、搜索帖子;查询自身信息与用户;获取主页时间线与提及;点赞/取消、转推/取消、收藏/取消及列表;关注/取关、屏蔽/取消、静音/取消;发送与列出私信;媒体上传与处理状态查询(含 --wait);本地 webhook 服务(基于 ngrok)与流式端点。可用原始模式执行任意 X API v2 请求,支持 -X、-d、-H、-F、-s 等标志。

安装: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 apps add my-app --client-id YOUR_CLIENT_ID --client-secret YOUR_CLIENT_SECRET,再 xurl auth default my-app,然后 xurl auth oauth2。完成后用 xurl auth status 与 xurl whoami 确认。凭据安全为强制要求:不得读取、打印、解析、汇总、上传或发送 ~/.xurl 及其副本到 LLM 上下文;不得要求用户粘贴凭据;不得在智能体会话中内联传入敏感标志(--bearer-token、--consumer-key、--consumer-secret、--access-token、--token-secret、--client-id、--client-secret);不得在智能体会话使用 --verbose/-v。令牌保存在 ~/.xurl(YAML),每个应用凭据与令牌隔离。X API 有速率限制,遇 429 需等待重试;若特定操作返回 403,可能是令牌缺少所需 scope,可重跑 xurl auth oauth2。若 OAuth 成功但读取失败并报 client-forbidden / client-not-enrolled,需在 X 开发者控制台将应用移至 Production 环境的 Pay-per-use 套餐(属 X 平台登记问题)。若 /2/users/me 未可靠返回用户名,可用 xurl auth oauth2 YOUR_USERNAME 显式传入。命令失败时返回非零退出码,API 错误以 JSON 输出到 stdout。多个应用可用 xurl auth default 或 --app 切换,多账号可用 -u/--username 切换。

价格、配额与具体适用场景细节暂未提供。