xurl

• 您需要一个 AI 代理或自动化脚本来在 X 上发布推文、回复或引用帖子。
• 您希望以编程方式搜索近期帖子、读取时间线或监控提及。
• 您需要通过脚本管理社交关系操作（关注、取消关注、屏蔽、静音）或发送私信。
• 您希望上传媒体文件（图片、视频）并将其附加到帖子中，而无需编写自定义 API 客户端代码。

• 您需要与旧版 X API v1.1 端点交互——xurl 仅支持 v2。
• 您处于沙盒或共享环境中，将凭据持久化到 ~/.xurl 不安全或不可行。
• 您需要一个图形化或无代码界面来管理您的 X 账户。

现成的单行命令涵盖发帖、回复、引用、删除、搜索、点赞、转发、收藏、关注、屏蔽、静音、发送私信以及上传媒体等功能。无需为日常任务手动构建原始 API 请求负载。

除了快捷方式之外，xurl 还可作为通用 X API 客户端使用。使用 xurl /2/some/endpoint 配合 -X、-d 和 -H 参数，即可访问任意 v2 端点，就像 curl 一样，但身份验证会自动处理。

注册多个 X 应用，并为每个应用验证多个 OAuth 2.0 账户。使用 xurl auth default 在它们之间切换，或通过 --app 和 --username 标志在每次请求时进行覆盖。

使用 xurl media upload 上传图片或视频，然后将返回的 media_id 直接附加到帖子或回复中。可通过 xurl media status --wait 轮询视频处理状态。

已知的流式端点（例如 /2/tweets/search/stream、/2/tweets/sample/stream）会被自动检测并正确处理。任何端点都可以通过 -s 标志强制进入流式模式。

凭证存储在本地的 ~/.xurl 中，无需以内联方式传递。该工具执行严格的禁止内联密钥策略，使其在 AI 代理或 LLM 工作流中使用更加安全，有效规避提示词或上下文泄露的风险。

智能体可以使用 xurl search 搜索某一主题的帖子，通过 xurl read 读取相关内容，然后回复或点赞最相关的结果——所有操作均在单一链式工作流中完成，每个步骤均采用结构化 JSON 格式。

使用 xurl media upload 上传准备好的图片，从 JSON 响应中获取 media_id，并立即将其附加到新帖子中——从而实现全自动的富媒体发布流程。

使用 xurl mentions、xurl timeline、xurl followers 和 xurl dms 定期检查提及、主页时间线、新关注者和私信，以驱动监控仪表板或通知机器人。

注册独立的开发环境和生产环境应用，分别对每个应用进行身份验证，并通过 xurl auth default 或每次请求时使用 --app 参数进行切换——无需担心凭据混用。