twitter-reader
使用 opencli 阅读 Twitter/X 进行金融研究（只读）。当用户想要阅读其 Twitter 信息流、搜索金融推文、查看书签、查找用户资料或收集 Twitter/X 上的市场情绪时，请使用此技能。触发词包括：“查看我的信息流”、“在 Twitter 上搜索”、“显示我的书签”、“谁关注了谁”、“查找 @user”、“关于……的热门话题是什么”、“Twitter 上的市场情绪”、“人们在 Twitter 上如何讨论 AAPL”、“@elonmusk 的最新推文”、“显示 @user 的帖子”、“金融推特圈”（fintwit），以及任何涉及阅读金融新闻或进行市场研究的 Twitter/X 提及。此技能为只读功能——不支持发帖、点赞、转发或任何写入操作。
Twitter Reader —— 只读的 Twitter/X 金融研究技能
技能概述
Twitter Reader 是一个基于 opencli 的只读 Twitter/X 读取技能，复用你在 Chrome 中已登录的会话，无需 API Key 或 Cookie 提取，即可读取时间线、搜索推文、查看书签、跟踪热榜与分析师动态，帮助投资者和金融研究者高效收集市场情绪与财经资讯。
适用场景
- 市场情绪与舆情调研：想了解某只股票、某个板块或整个大盘当前在推特上的讨论热度与多空情绪时，可以直接搜索关键词并拿到推文正文与点赞、转发、浏览量等互动数据，用于判断共识与反向观点。
- 跟踪分析师与财经博主观点：通过读取指定用户的最近推文，或查看自己关注列表的时间线，快速掌握财报季、议息会议等关键节点上专业人士的实时表态，不必在信息流里手动翻找。
- 整理研究素材与选题：把书签、热榜话题、搜索结果以 JSON、YAML 或 CSV 格式导出，直接接入脚本或表格做二次处理，适合需要沉淀素材的量化研究、财经写作和内容选题工作。
核心功能
- 多维度内容读取：覆盖时间线（推荐/关注两种类型）、关键词搜索（相关度/最新两种排序）、热榜趋势、书签、指定用户推文、完整推文串、单篇长文以及通知，基本覆盖金融研究常用的阅读路径。每条推文都带作者、正文、发布时间和互动数据。
- 用户与关系链查询：可查看用户主页资料（简介、位置、粉丝数、关注数、认证状态、注册时间），并列出其关注者和正在关注的账号，用于快速判断信息源的影响力和立场背景。
- 零密钥的浏览器会话复用：依托 opencli 的 Browser Bridge 扩展复用 Chrome 中已登录的 x.com 会话，不需要申请开发者账号、不需要配置 API Key，也不需要手动导出 Cookie；同时提供多种输出格式（表格、JSON、YAML、Markdown、CSV）便于程序化使用。
常见问题
Twitter Reader 是什么？能做什么？
它是一个只读的 Twitter/X 阅读技能，基于 opencli 实现。你能用它查看首页时间线、搜索推文、浏览热榜、读取书签、查看某个用户的最近推文、展开完整推文串和长文、查看个人资料与关注关系、读取通知。它的定位是金融研究中的信息采集，不涉及任何账号操作。
使用它需要 API Key 吗？
不需要。opencli 通过复用你 Chrome 浏览器中已登录的 x.com 会话来工作，只要在 Chrome 里登录过 x.com 并安装了 Browser Bridge 扩展即可。运行 opencli doctor 可以检查守护进程、扩展连接和会话状态是否正常。
它支持发帖、点赞、转发或关注吗？
不支持，这是技能的明确边界。Twitter Reader 是纯只读工具，不会执行发帖、点赞、转发、回复、引用、关注或删除等任何写操作。如果需要发布内容，请使用官方客户端。
提示 "Extension not connected" 或 "No session" 怎么办？
前者说明 Chrome 里没有安装或未启用 Browser Bridge 扩展，需要从 opencli 的 GitHub Releases 下载对应版本的 zip，解压后在 chrome://extensions 开启开发者模式并选择"加载已解压的扩展程序"；后者说明当前没有 x.com 的登录会话，在 Chrome 中登录 x.com 后重试即可。若提示 CSRF token 缺失，刷新一下 x.com 页面重新生成 cookie 通常就能解决。其他情况可以先运行 opencli doctor 做一次完整体检。
怎么用它搜索某只股票的讨论？
用搜索命令加上关键词即可，例如查询财报相关讨论可以传入 "$AAPL earnings"，需要最新观点时把排序切到最新（--filter live），需要高相关度内容时保持默认的相关度排序（--filter top）。结果里的点赞、转发和浏览量可以作为判断话题热度的参考，推文链接方便你回到原帖查看完整上下文。
一次能读取多少条内容？
各命令都有数量参数，默认值不同：时间线、热榜、书签、通知、指定用户推文默认 20 条，搜索默认 15 条，推文串默认 50 条，关注者与关注列表默认 50 条。建议先从 10 到 20 条开始，确认结果符合预期后再调大，避免触发平台限流。
读取到的数据能导出成表格吗？
可以。用 -f csv 输出 CSV 格式即可直接用表格软件打开；用 -f json 或 -f yaml 则适合交给脚本或大模型继续处理。不同命令返回的列略有差异，例如推文类命令包含作者、正文、发布时间、点赞、转发、回复、浏览量、链接和媒体信息。
运行它需要什么环境？
需要 Node.js 20 或更高版本，以及安装了 Browser Bridge 扩展并已登录 x.com 的 Chrome 浏览器。全局安装 opencli 后，首次使用建议先跑一次 opencli doctor 确认连通性。另外请注意，短时间大量请求可能被平台限流，稍等几分钟再重试即可。