twitter-reader
使用 opencli(只读)从 Twitter/X 获取金融研究。只要用户想要读取自己的 Twitter 动态、搜索金融推文、查看收藏夹、查询用户资料、或从 Twitter/X 汇总市场情绪,就使用此技能。触发条件包括:“查看我的动态”“在 Twitter 上搜索”“显示我的收藏夹”“谁在关注他/她”“查找 @user”“关于什么在热议/趋势”“Twitter 上的市场情绪”“Twitter 上大家怎么看 AAPL”“fintwit”,以及在语境中提到 Twitter/X 用于阅读金融新闻或进行市场研究。此技能为只读(READ-ONLY)——不支持发布、点赞、转推或任何写入操作。
分类
金融分析安装
下载并解压到你的 skills 目录
复制命令,发送给 OpenClaw 自动安装:
Twitter Skill (Read-Only)
Reads Twitter/X for financial research using opencli, a universal CLI tool that bridges web services to the terminal via browser session reuse.
This skill is read-only. It is designed for financial research: searching market discussions, reading analyst tweets, tracking sentiment, and monitoring financial news on Twitter/X. It does NOT support posting, liking, retweeting, replying, or any write operations.
Important: opencli reuses your existing Chrome login session — no API keys or cookie extraction needed. Just be logged into x.com in Chrome and have the Browser Bridge extension installed.
Step 1: Ensure opencli Is Installed and Ready
Current environment status:
!`(command -v opencli && opencli doctor 2>&1 | head -5 && echo "READY" || echo "SETUP_NEEDED") 2>/dev/null || echo "NOT_INSTALLED"`If the status above shows READY, skip to Step 2. If NOT_INSTALLED, install first:
# Install opencli globally
npm install -g @jackwener/opencliIf SETUP_NEEDED, guide the user through setup:
Setup
opencli requires a Chrome browser with the Browser Bridge extension:
opencli doctor outputopencli doctorThis auto-starts the daemon, verifies the extension is connected, and checks session health.
Common setup issues
| Symptom | Fix |
|---|---|
Extension not connected | Install Browser Bridge extension in Chrome and ensure it's enabled |
Daemon not running | Run opencli doctor — it auto-starts the daemon |
No session for twitter.com | Login to x.com in Chrome, then retry |
CSRF token missing | Refresh x.com in Chrome to regenerate the ct0 cookie |
Step 2: Identify What the User Needs
Match the user's request to one of the read commands below, then use the corresponding command from references/commands.md.
| User Request | Command | Key Flags |
|---|---|---|
| Setup check | opencli doctor | — |
| Home feed / timeline | opencli twitter timeline | --type following, --limit N |
| Search tweets | opencli twitter search "QUERY" | --filter top\|live, --limit N |
| Trending topics | opencli twitter trending | --limit N |
| Bookmarks | opencli twitter bookmarks | --limit N |
| View a specific thread | opencli twitter thread TWEET_ID | — |
| Twitter article | opencli twitter article TWEET_ID | — |
| User profile | opencli twitter profile USERNAME | — |
| Followers | opencli twitter followers USERNAME | --limit N |
| Following | opencli twitter following USERNAME | --limit N |
| Notifications | opencli twitter notifications | --limit N |
Step 3: Execute the Command
General pattern
# Use -f json or -f yaml for structured output
opencli twitter timeline -f json --limit 20
opencli twitter timeline --type following --limit 20
# 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 jsonKey rules
opencli doctor before any other command if unsure about connectivity-f json or -f yaml for structured output when processing data programmatically-f csv when the user wants spreadsheet-compatible output--limit N to control result count — start with 10-20 unless the user asks for more--filter — top (default) for relevance, live for latest tweetsOutput format flag (-f)
| Format | Flag | Best for |
|---|---|---|
| Table | -f table (default) | Human-readable terminal output |
| JSON | -f json | Programmatic processing, LLM context |
| YAML | -f yaml | Structured output, readable |
| Markdown | -f md | Documentation, reports |
| CSV | -f csv | Spreadsheet export |
Output columns
Commands that return tweets typically include: id, author, text, created_at, likes, views, url.
Profile commands include: username, name, bio, followers_count, following_count.
Step 4: Present the Results
After fetching data, present it clearly for financial research:
Step 5: Diagnostics
If something isn't working, run:
opencli doctorThis checks daemon status, extension connectivity, and browser session health.
Error Reference
| Error | Cause | Fix |
|---|---|---|
Extension not connected | Browser Bridge not installed/enabled | Install extension and enable it in Chrome |
No session | Not logged into x.com | Login to x.com in Chrome |
CSRF token missing | Cookie expired or page needs refresh | Refresh x.com in Chrome |
| Rate limited | Too many requests | Wait a few minutes, then retry |
Reference Files
references/commands.md — Complete read command reference with all flags, research workflows, and usage examplesreferences/schema.md — Output format documentation and column definitionsRead the reference files when you need exact command syntax, research workflow patterns, or output details.