himself65/finance-skills / plugins/social-readers/skills/twitter-reader
twitter-reader
VerifiedRead Twitter/X for financial research through opencli: the user's home timeline, tweet search, trending topics, bookmarks, a user's recent tweets, threads, articles, profiles, followers and following, and notifications. Use this skill whenever the user wants to know what people are saying on Twitter/X or fintwit about a stock, topic, or market event, check their feed or bookmarks, see what's trending, or look up an @account and its posts. Read-only: it cannot post, like, retweet, reply, or follow.
| File | Kind | Size |
|---|---|---|
| README.md | markdown | 2.3 KB |
| SKILL.md | skill md | 7.6 KB |
| references/commands.md | markdown | 8.4 KB |
| references/schema.md | markdown | 4.2 KB |
references/commands.md
View on GitHub# opencli Twitter Command Reference (Read-Only)
Complete read-only reference for Twitter commands in [opencli](https://github.com/jackwener/opencli), scoped to financial research use cases.
Install: `npm install -g @jackwener/opencli`
**This skill is read-only.** Write operations (post, like, retweet, reply, quote, follow, delete) are NOT supported in this finance skill.
---
## Setup
opencli authenticates via your existing Chrome browser session — no API keys or credentials needed.
**Requirements:**
1. Node.js >= 20 (or Bun >= 1.0)
2. Chrome with the Browser Bridge extension installed
3. Logged into x.com in Chrome
**Install the Browser Bridge extension:**
1. Download `opencli-extension-v{version}.zip` from the [GitHub Releases page](https://github.com/jackwener/opencli/releases)
2. Unzip it, open `chrome://extensions`, enable **Developer mode**
3. Click **Load unpacked** and select the unzipped folder
**Verify setup:**
```bash
opencli doctor
```
This auto-starts the daemon, verifies extension connectivity, and checks browser session health.
---
## Read Operations
### Timeline (Home Feed)
```bash
opencli twitter timeline # "For You" feed (default, limit 20)
opencli twitter timeline --type following # "Following" tab (chronological)
opencli twitter timeline --type for-you # "For You" tab (algorithmic, explicit)
opencli twitter timeline --limit 50 # Limit count
opencli twitter timeline -f json # JSON output
opencli twitter timeline -f yaml # YAML output
```
**Flags:** `--type` (`for-you` | `following`, default `for-you`), `--limit` (default 20).
### Search
```bash
opencli twitter search "keyword" # Basic search (top results, limit 15)
opencli twitter search "AI agent" --filter live --limit 50 # Latest tweets
opencli twitter search "topic" -f json # JSON output
opencli twitter search "topic" -f csv # CSV output
# Financial research examples
opencli twitter search "$AAPL earnings" --filter live --limit 20 -f json
opencli twitter search "Fed rate decision" --limit 20 -f yaml
opencli twitter search "market crash" --filter live --limit 15 -f json
```
**Flags:** `--filter` (`top` | `live`, default `top`), `--limit` (default 15).
### Trending Topics
```bash
opencli twitter trending # Top 20 trending topics (default)
opencli twitter trending --limit 10 # Limit count
opencli twitter trending -f json # JSON output
```
### Bookmarks
```bash
opencli twitter bookmarks # View bookmarked tweets
opencli twitter bookmarks --limit 30 # Limit count
opencli twitter bookmarks -f json # JSON output
```
### Thread / Tweet Detail
```bash
opencli twitter thread TWEET_ID # View tweet thread (default limit 50)
opencli twitter thread TWEET_ID --limit 20 # Limit replies
opencli twitter thread TWEET_ID -f json # JSON output
```
### Twitter Articles
```bash
opencli twitter article TWEET_ID # View long-form article
opencli twitter article TWEET_ID -f json # JSON output
```
### User Data
```bash
opencli twitter profile # Defaults to logged-in user
opencli twitter profile elonmusk # Look up a specific user
opencli twitter profile elonmusk -f json # JSON output
opencli twitter followers elonmusk # List followers (default limit 50)
opencli twitter followers elonmusk --limit 100 # Custom limit
opencli twitter following elonmusk # List following (default limit 50)
```
### Recent Tweets from a User
Fetches a user's most recent posts (chronological, excludes pinned). Added in opencli 1.7.6.
```bash
opencli twitter tweets elonmusk # Most recent tweets (default limit 20)
opencli twitter tweets elonmusk --limit 50 # More tweets
opencli twitter tweets jimcramer -f json # JSON output
```
**Columns:** `author`, `created_at`, `is_retweet`, `text`, `likes`, `retweets`, `replies`, `views`, `url`, `has_media`, `media_urls`.
### Notifications
```bash
opencli twitter notifications # View notifications
opencli twitter notifications -f json # JSON output
```
---
## Output Formats
All commands support the `-f` / `--format` flag:
| Format | Flag | Description |
|---|---|---|
| Table | `-f table` (default) | Rich CLI table with bold headers, word wrapping, footer with count/elapsed time |
| JSON | `-f json` | Pretty-printed JSON (2-space indent) |
| YAML | `-f yaml` | Structured YAML |
| Markdown | `-f md` | Pipe-delimited markdown tables |
| CSV | `-f csv` | Comma-separated values with proper quoting/escaping |
### Output columns by command
| Command | Columns |
|---|---|
| `timeline`, `search`, `thread` | `id`, `author`, `text`, `likes`, `retweets`, `replies`, `views`, `created_at`, `url`, `has_media`, `media_urls` |
| `tweets` | `author`, `created_at`, `is_retweet`, `text`, `likes`, `retweets`, `replies`, `views`, `url`, `has_media`, `media_urls` |
| `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` |
**Note:** The `has_media` and `media_urls` columns were added in opencli 1.7.7.
---
## Financial Research Workflows
### Search for earnings sentiment
```bash
opencli twitter search "$AAPL earnings" --filter live --limit 20 -f json
opencli twitter search "$TSLA delivery numbers" --filter live --limit 15 -f json
```
### Monitor fintwit for a ticker
```bash
opencli twitter search "$NVDA" --filter live --limit 30 -f json
opencli twitter search "$SPY puts" --filter live --limit 20 -f json
```
### Track analyst commentary
```bash
# Check trending topics for market themes
opencli twitter trending --limit 20 -f json
# Search for specific analyst takes
opencli twitter search "price target AAPL" --filter live --limit 15 -f json
# Read recent tweets from a specific analyst or fintwit account
opencli twitter tweets jimcramer --limit 30 -f json
opencli twitter tweets elerianm --limit 20 -f json
```
### Macro / Fed watching
```bash
opencli twitter search "Fed rate decision" --filter live --limit 20 -f json
opencli twitter search "CPI report" --filter live --limit 15 -f json
opencli twitter search "inflation data" --filter live --limit 20 -f yaml
```
### Daily market reading workflow
```bash
# Check trending topics
opencli twitter trending --limit 10 -f json
# Read your feed
opencli twitter timeline --type following --limit 30 -f json
# Check bookmarks
opencli twitter bookmarks --limit 20 -f json
# Search for market outlook
opencli twitter search "market outlook" --filter live --limit 30 -f json
```
### Export for analysis
```bash
# CSV for spreadsheet analysis
opencli twitter search "AI stocks" --limit 50 -f csv > ai_stocks.csv
# JSON for programmatic processing
opencli twitter search "earnings beat" --limit 30 -f json > earnings.json
```
---
## Error Reference
| Error | Cause | Fix |
|-------|-------|-----|
| `Extension not connected` | Browser Bridge not installed | Install the Browser Bridge Chrome extension |
| `Daemon not running` | opencli daemon not started | Run `opencli doctor` to auto-start |
| `No session for twitter.com` | Not logged into x.com | Login to x.com in Chrome |
| `CSRF token missing` | Cookie expired | Refresh x.com in Chrome |
| Rate limited | Too many requests | Wait a few minutes, then retry |
---
## Limitations
- **Read-only in this skill** — write operations are not supported for finance use
- **No DMs** — direct messages are not exposed via read commands in this skill
- **Requires Chrome** — opencli uses Chrome's Browser Bridge; other browsers are not supported
- **Single browser profile** — uses the active Chrome profile's session
---
## Best Practices
- **Keep request volumes low** — use `--limit 20` instead of `--limit 500`
- **Use `opencli doctor`** before your first command in a session to verify connectivity
- **Use `-f json`** for programmatic processing and LLM context
- **Use `-f csv`** when the user wants to analyze data in a spreadsheet
- **Prefer `--filter live`** for time-sensitive financial searches (earnings, breaking news)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |