x-cli

x-cli 是一个通过命令行工具 x 与 X API 交互的技能/工具，主要用于以脚本或终端方式操作 X（原 Twitter）平台上的内容与账号数据。

一、用途 该工具适用于处理帖子、时间线、媒体上传和用户数据等任务，也可在用户提及 X、社交媒体、帖子或 x 时使用。

二、前置条件与认证 使用前需确认命令行工具可用：

• x --version 需要配置来自 X Developer Portal 的 API 凭据，通过以下环境变量提供：
• X_API_KEY
• X_API_SECRET
• X_ACCESS_TOKEN
• X_ACCESS_SECRET 也可使用 OAuth 流程登录：
• x auth login 并可通过以下命令检查认证状态：
• x auth status

三、主要能力

1. 推文创建与管理

• x tweet "Hello from the CLI!"
• x tweet "Check this out" --media ./image.png
• x tweet "Thread part 1" --thread
• x tweet "Thread part 2" --reply-to TWEET_ID
• x delete TWEET_ID --confirm

1. 读取时间线

• x timeline --limit 50
• x timeline --user USERNAME --limit 20
• x mentions --limit 20
• x likes --user USERNAME

1. 搜索

• x search --query "#javascript" --limit 100
• x search --query "from:elonmusk" --recent
• x search --query "AI filter:images" --limit 50

1. 媒体

• x upload ./image.jpg --alt "Description"
• x upload ./video.mp4 --media-type video
• x tweet "Video content" --media MEDIA_ID

1. 用户

• x user get USERNAME
• x user followers USERNAME --limit 100
• x user following USERNAME --limit 100
• x follow USERNAME
• x unfollow USERNAME --confirm

1. 列表与书签

• x lists list
• x lists get LIST_ID --tweets
• x lists create "Tech News" --description "Technology updates"
• x bookmarks --limit 50

1. 数据分析

• x analytics tweets --days 30
• x analytics followers --growth
• x export tweets --start 2024-01-01 --format csv

四、面向智能体的最佳实践

• 速率限制：遵守 X API 的速率限制，可检查 x limits。
• 推文长度：最多 280 个字符（X Premium 为 4,000 个字符）。
• 媒体格式：支持 JPG、PNG、GIF、MP4。
• 线程安全：多推线程使用 --thread 标志。

五、适用场景与限制 适用场景包括在终端中创建和管理推文、读取时间线与提及、执行搜索、上传媒体、查询用户信息、管理列表与书签以及导出推文分析数据。限制方面，需依赖 X API 凭据和相应权限，且须遵守速率限制与推文长度、媒体格式等平台约束。资料未提供收费、价格或平台可用性的进一步信息。