twitter-cli

twitter-cli 技能概览

twitter-cli 技能能做什么

twitter-cli 是一个以终端为先的 Twitter/X 技能，可用于读取时间线、书签、搜索结果、个人资料和推文详情；在完成认证后，也支持发帖及其他写操作。它最适合希望用 CLI 流程替代网页端的用户，尤其适用于社交媒体研究、账号监控和轻量发布。

适合谁使用

如果用户希望通过命令行查看 Twitter/X 数据、自动化常规读取，或生成适合下游处理的结构化输出，就应该使用 twitter-cli 技能。它尤其适合追求快速获取结果和终端输出，而不是完整社媒仪表盘的场景。

这项技能的不同之处

最大的采纳问题在于认证。twitter-cli 不需要 API key 也能工作，但写操作依赖有效的浏览器 cookie；如果只提供了部分环境变量，写操作就可能失败。因此，twitter-cli 的安装决策，核心其实是：用户能否顺利完成认证，以及是否需要只读还是读写权限。

如何使用 twitter-cli 技能

安装 twitter-cli

使用下面的命令安装 twitter-cli 技能：
npx skills add public-clis/twitter-cli --skill twitter-cli

安装完成后，实际要判断的是目标环境里是否有 Python 3.10+、uv 或 pipx。这个仓库的安装方式本身就是 Python CLI，不是浏览器扩展，也不是托管服务。

先从认证开始

在进行任何真正的 twitter-cli 使用之前，先检查状态。这个仓库的流程很明确：先确认凭据存在，再继续下一步。

典型的首次检查命令：
twitter status --yaml

如果 status 显示未认证，就先引导用户通过浏览器 cookie 提取或其他受支持的认证路径完成登录，再尝试发帖、回复或点赞。之所以要这样做，是因为 twitter-cli 的写操作最容易因为认证不稳而卡住采用。

把任务翻译成好的提示词

一条好的 twitter-cli guide 提示词应该明确说明：

• 目标动作：read、search、post、reply、quote、like、retweet、follow 或 lookup
• 目标对象：用户名、tweet ID、关键词、列表或时间线类型
• 输出格式：终端视图、--yaml 或 --json
• 任何约束：日期范围、搜索标签页、全文，或是否排除 retweet

示例请求结构：
“Use twitter-cli to search for open source LLM in Latest, return --yaml, and summarize the top 5 results with authors and URLs.”

先读这些文件

为了快速阅读仓库，优先看：

• SKILL.md：命令和认证规则
• README.md：功能范围和示例
• SCHEMA.md：结构化输出的形状
• AGENTS.md：开发和测试上下文
• twitter_cli/cli.py 和 twitter_cli/auth.py：命令入口和登录行为

twitter-cli 技能常见问题

twitter-cli 只适合读取 Twitter/X 吗？

不是。twitter-cli 技能同时支持读取和写入，但写操作对认证质量更敏感，而且可能需要浏览器 cookie，而不仅仅是环境变量。

需要 API key 吗？

通常基础的 twitter-cli 流程不需要 API key。这个仓库围绕浏览器 cookie 认证和 CLI 驱动访问来设计，很适合希望快速进行社交媒体操作、又不想搭建开发者应用的用户。

什么情况下不建议用 twitter-cli？

如果用户需要高频自动化、要求 API 稳定性有保证，或者不想在终端里完成工作流，就不适合用 twitter-cli。如果账号无法在受支持的浏览器中完成认证，或者任务依赖无人值守的写入访问，它也不是好选择。

适合新手吗？

适合，但前提是任务简单，而且用户能在受支持的浏览器里登录 X。新手最容易踩的坑，是在凭据确认前就默认命令可以正常运行；先验证认证，使用起来会轻松很多。

如何改进 twitter-cli 技能

给出尽可能小但完整的目标

twitter-cli 最好的输出来自精确输入：who、what 和 how many。比如，“Find recent posts about AI agents from @example” 就比“search Twitter”更好，因为它能让技能走对命令路径，并减少噪音。

先说明输出约束

如果你想获得更好的 twitter-cli usage，请提前说明你需要全文推文、结构化输出，还是简洁的终端摘要。例如，--yaml 更适合后续解析结果，而富表格输出更适合交互式查看。

说明认证和环境限制

告诉系统当前会话是否已登录、是否有可用的浏览器 cookie，以及用户能否打开受支持的浏览器。这些限制对 twitter-cli install 和执行路径的影响，通常比推文内容本身更大。

根据结果质量迭代，而不是重写命令形式

如果第一次运行没有命中你要的内容，就优先补充搜索词、作者筛选、时间窗口或输出格式，而不是把整条请求推倒重来。对于 twitter-cli skill 来说，最大的提升通常来自缩小范围和明确想要的数据形态。