twitter-reader

Twitter 技能（只读）

如果宿主尚未执行下面的 shell 探测（例如在 Codex 中），请先使用其 shell 工具运行 ! 包裹的命令，再选择设置路径。请使用实际输出；如果无法访问 shell，请说明这一限制。

使用 opencli 读取 Twitter/X，以进行金融研究。opencli 是一款通用 CLI 工具，可通过复用浏览器会话，将 Web 服务接入终端。

此技能为只读。 它专为金融研究设计：搜索市场讨论、阅读分析师推文、追踪情绪，以及监控 Twitter/X 上的财经新闻。它不支持发帖、点赞、转推、回复或任何写入操作。

重要提示：opencli 会复用你现有的 Chrome 登录会话，无需 API 密钥或提取 Cookie。只需在 Chrome 中登录 x.com，并安装 Browser Bridge 扩展程序。

---

步骤 1：确保已安装并准备好 opencli

当前环境状态：

!`(command -v opencli && opencli doctor 2>&1 | head -5 && echo "READY" || echo "SETUP_NEEDED") 2>/dev/null || echo "NOT_INSTALLED"`

如果上述状态显示为 READY，请跳至步骤 2。如果显示 NOT_INSTALLED，请先安装：

# Install opencli globally
npm install -g @jackwener/opencli

如果显示 SETUP_NEEDED，请引导用户完成设置：

设置

opencli 需要 Node.js >= 20，以及安装了 Browser Bridge 扩展程序的 Chrome 浏览器：

1. 安装 Browser Bridge 扩展程序：
   • 从 GitHub Releases 页面下载最新的 opencli-extension-v{version}.zip
   • 解压文件，在 Chrome 中打开 chrome://extensions，然后启用开发者模式
   • 点击加载已解压的扩展程序，并选择解压后的文件夹
2. 在 Chrome 中登录 x.com——opencli 会复用你现有的浏览器会话
3. 验证连接：

opencli doctor

此命令会自动启动守护进程，验证扩展程序是否已连接，并检查会话状态。

常见设置问题

症状	解决方法
Extension not connected	在 Chrome 中安装 Browser Bridge 扩展程序，并确保已启用
Daemon not running	运行 opencli doctor——它会自动启动守护进程
No session for twitter.com	在 Chrome 中登录 x.com，然后重试
CSRF token missing	在 Chrome 中刷新 x.com，以重新生成 ct0 Cookie

---

步骤 2：确定用户的需求

将用户的请求与下面的读取命令对应起来，然后使用 references/commands.md 中相应的命令。

用户请求	命令	关键标志
检查设置	opencli doctor	—
首页信息流／时间线	opencli twitter timeline	--type for-you|following、--limit N（默认值为 20）
搜索推文	opencli twitter search "QUERY"	--filter top|live、--limit N（默认值为 15）
热门话题	opencli twitter trending	--limit N（默认值为 20）
书签	opencli twitter bookmarks	--limit N（默认值为 20）
某用户的近期推文	opencli twitter tweets USERNAME	--limit N（默认值为 20）
查看特定串文	opencli twitter thread TWEET_ID	--limit N（默认值为 50）
Twitter 文章	opencli twitter article TWEET_ID	—
用户个人资料	opencli twitter profile USERNAME	—（默认显示已登录用户）
粉丝	opencli twitter followers USERNAME	--limit N（默认值为 50）
正在关注	opencli twitter following USERNAME	--limit N（默认值为 50）
通知	opencli twitter notifications	--limit N（默认值为 20）

---

步骤 3：执行命令

通用模式

# Use -f json or -f yaml for structured output
opencli twitter timeline -f json --limit 20
opencli twitter timeline --type following --limit 20

# Recent tweets from a specific user
opencli twitter tweets elonmusk --limit 20 -f json

# Searching for financial topics
opencli twitter search "$AAPL earnings" --filter live --limit 10 -f json
opencli twitter search "Fed rate decision" --limit 20 -f yaml

# Trending topics
opencli twitter trending --limit 20 -f json

关键规则

1. 先检查设置 — 如果不确定连接状态，请先运行 opencli doctor，再执行其他命令
2. 处理数据时使用 -f json 或 -f yaml，以获取结构化输出
3. 用户需要兼容电子表格的输出时，使用 -f csv
4. 使用 --limit N 控制结果数量 — 除非用户要求更多，否则从 10-20 条开始
5. 搜索时使用 --filter — top（默认值）用于按相关性排序，live 用于查看最新推文
6. 仅限只读操作 — 不要发布、点赞、转推、回复、引用、关注或删除，即使 opencli 提供了这些命令

输出格式标志（-f）

格式	标志	最适合
表格	-f table（默认值）	方便阅读的终端输出
JSON	-f json	程序化处理、LLM 上下文
YAML	-f yaml	结构化且易读的输出
Markdown	-f md	文档、报告
CSV	-f csv	导出到电子表格

输出列

推文列表命令（timeline、search、thread）包含：id、author、text、created_at、likes、retweets、replies、views、url、has_media、media_urls。

tweets（每位用户发布的推文）还包含 is_retweet。

bookmarks 列：author、text、likes、retweets、bookmarks、url。

trending 列：rank、topic、tweets、category。

个人资料（profile）列：screen_name、name、bio、location、url、followers、following、tweets、likes、verified、created_at。

followers / following 列：screen_name、name、bio、followers。

notifications 列：id、action、author、text、url。

---

步骤 4：呈现结果

优先呈现与用户研究问题最相关的内容，而非直接倾倒原始数据。注明每条推文的来源（@handle、正文、点赞和浏览量等互动数据；如果用户可能需要查看完整讨论串，也应提供 URL），按主题对搜索结果分组，并指出观点倾向看涨还是看跌，以及哪些观点属于共识或少数派。对于个人资料，提供粉丝数量、简介和近期值得关注的动态。请对浏览器会话详情保密。

---

步骤 5：诊断

如果遇到问题，请运行：

opencli doctor

此命令会检查守护进程状态、扩展连接情况和浏览器会话健康状态。

---

错误参考

错误	原因	修复方法
Extension not connected	未安装或未启用 Browser Bridge	安装扩展，并在 Chrome 中启用
No session	尚未登录 x.com	在 Chrome 中登录 x.com
CSRF token missing	Cookie 已过期，或页面需要刷新	在 Chrome 中刷新 x.com
Rate limited	请求过多	等待几分钟后重试

---

参考文件

• references/commands.md — 完整的只读命令参考，包含所有标志、研究工作流和用法示例
• references/schema.md — 输出格式文档和列定义

需要准确的命令语法、研究工作流模式或输出详情时，请阅读参考文件。