xurl —— 面向 X (Twitter) API 的命令行工具¶

Skill 简介¶

在当今社交媒体驱动的开发环境中，与 X（原 Twitter）平台的交互需求日益增长。无论是为了自动化发布推文、管理粉丝，还是进行数据分析，开发者都需要一种高效、可靠的方式来与 X API 进行通信。xurl 正是一个为此目的而设计的命令行工具（CLI），它为开发者提供了一种简洁而强大的方式来执行各种与 X API 相关的操作。

xurl 不仅仅是一个简单的 HTTP 客户端，它封装了与 X API 交互的复杂性，使得开发者能够通过简单的命令完成复杂的任务。无论是发布推文、回复评论、管理粉丝，还是上传媒体文件，xurl 都能轻松胜任。此外，它还支持 OAuth2 等多种认证方式，确保了与 X API 交互的安全性。

主要功能¶

xurl 提供了丰富的功能，涵盖了与 X API 交互的各个方面。以下是一些核心功能的详细介绍：

发布推文
通过 xurl post 命令，开发者可以轻松发布新的推文。例如：
bash xurl post "Hello, world!"
该命令将在用户的账户上发布一条内容为 "Hello, world!" 的推文。
回复、引用和删除推文
xurl 支持对现有推文进行回复、引用和删除操作。例如，要回复某条推文，可以使用：
bash xurl reply POST_ID "Nice post!"
其中 POST_ID 是目标推文的 ID。类似地，xurl quote 用于引用推文，xurl delete 用于删除推文。
搜索和读取推文
通过 xurl search 命令，开发者可以搜索包含特定关键词的推文。例如：
bash xurl search "OpenAI" -n 10
该命令将搜索包含 "OpenAI" 的推文，并返回前 10 条结果。xurl read 命令则用于读取特定推文的内容：
bash xurl read POST_ID
管理粉丝和关注者
xurl 提供了多种命令来管理用户的粉丝和关注者。例如，要关注某个用户，可以使用：
bash xurl follow @handle
同样，xurl unfollow 用于取消关注，xurl followers 用于列出用户的粉丝。
发送和接收私信（DM）
通过 xurl dm 命令，开发者可以发送私信给其他用户。例如：
bash xurl dm @handle "This is a direct message."
xurl 还支持列出收到的私信：
bash xurl list dms
上传和管理媒体
xurl 支持上传图片、视频等媒体文件，并将其附加到推文中。例如：
bash xurl upload media_path.jpg
上传后，开发者可以将媒体文件的 ID 附加到推文中。

使用场景¶

xurl 的强大功能使其适用于多种开发场景：

社交媒体管理工具开发
开发者可以使用 xurl 构建自定义的社交媒体管理工具，自动发布推文、回复评论、管理粉丝等。
数据分析
通过 xurl search 和 xurl read 命令，开发者可以获取大量的推文数据，用于后续的数据分析和处理。
自动化任务
例如，定期发布天气预报、新闻摘要等内容的自动化脚本，可以利用 xurl 来实现推文的自动发布。
用户互动自动化
对于需要与用户进行大量互动的应用，如客服机器人，xurl 可以简化与 X API 的交互过程。
内容聚合平台
开发者在构建内容聚合平台时，可以使用 xurl 来获取和展示来自 X 的最新内容。

如何使用¶

安装¶

xurl 支持多种安装方式，以下是几种常用的方法：

Homebrew（macOS）
bash brew install --cask xdevplatform/tap/xurl
npm
bash npm install -g @xdevplatform/xurl
Shell 脚本
bash curl -fsSL https://raw.githubusercontent.com/xdevplatform/xurl/main/install.sh | bash
该脚本会将 xurl 安装到 ~/.local/bin 目录下。如果该目录不在你的 PATH 中，脚本会提示你如何添加。
Go
bash go install github.com/xdevplatform/xurl@latest

配置¶

在使用任何命令之前，必须进行认证。运行以下命令检查认证状态：

xurl auth status

如果尚未认证，可以通过以下命令进行 OAuth2 认证：

xurl auth oauth2

对于多个预配置的应用程序，可以通过以下命令切换默认应用程序：

xurl auth default prod-app
xurl auth default prod-app alice

前置条件¶

安全性
切勿在 LLM 上下文中读取、打印、解析、总结、上传或发送 ~/.xurl 文件或其副本。
不要让用户将凭证/令牌粘贴到聊天中。
用户必须在他们自己的机器上手动填充 ~/.xurl 文件中的所需机密。
不要在代理/LLM 会话中推荐或执行带有内联机密的认证命令。
警告：在代理会话中使用 CLI 机密选项可能会泄露凭证（提示/上下文、日志、shell 历史记录）。
切勿在代理/LLM 会话中使用 --verbose / -v；它可能会在输出中暴露敏感的头部/令牌。

示例¶

发布推文¶

以下是一个发布推文的示例：

xurl post "Hello, OpenClaw users!"

执行该命令后，xurl 将向 X API 发送一个 POST 请求，并在用户的账户上发布一条内容为 "Hello, OpenClaw users!" 的推文。

回复推文¶

要回复一条特定的推文，可以使用 xurl reply 命令。例如：

xurl reply 1234567890 "Thanks for the great post!"

其中 1234567890 是目标推文的 ID。该命令将向 X API 发送一个 POST 请求，回复指定的推文。

总结¶

xurl 是一个功能强大的命令行工具，专为与 X API 进行交互而设计。它简化了与 X 平台的通信过程，使得开发者能够专注于核心功能的开发。无论是发布推文、管理粉丝，还是进行数据分析，xurl 都能提供高效可靠的解决方案。对于需要频繁与 X API 交互的开发者来说，xurl 是一个不可或缺的工具。

通过提供简洁的命令和强大的功能，xurl 极大地提升了开发效率，使得与 X 平台的交互变得更加容易和高效。无论你是初学者还是经验丰富的开发者，xurl 都能满足你的需求，帮助你快速实现各种与 X 相关的功能。

xurl