Twitter Reader

Alex YangCommunityCreated by Alex Yang

Skill
Tool integration
Automation and integrations
MIT
Low risk

From the author

Read 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.

— the description by Alex Yang

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

The twitter-reader skill enables AI agents to perform read-only financial research on Twitter/X by leveraging the opencli tool. It bridges the gap between the web interface and the terminal by reusing your active Chrome browser session, eliminating the need for complex API keys or manual cookie extraction. Designed specifically for market analysis, it allows agents to search for stock discussions, monitor trending topics, view user profiles, and track sentiment across the platform.

What it does

Fetches home timelines and specific user feeds
Searches for financial keywords, tickers, and market events
Retrieves trending topics and user bookmarks
Extracts detailed profile information and follower lists
Supports structured output formats like JSON, YAML, and CSV for data analysis
Provides read-only access to threads and notifications

When to use it

When you need to gauge market sentiment on a specific stock or asset
When researching analyst opinions or breaking financial news on X
When you want to programmatically analyze trending topics or user activity
When you need to pull data from your own bookmarks or notifications for a report

Advantages

No API keys or complex authentication required
Uses existing browser session for seamless connectivity
Supports multiple output formats for easy integration with other tools
Read-only design ensures safety by preventing accidental posts or interactions

Usage examples

“What is the current sentiment on $AAPL on Twitter?”: The agent uses opencli to search for '$AAPL' with a live filter, summarizes the top discussions, and identifies the prevailing bullish or bearish sentiment.
“Get the latest tweets from @financialanalyst and summarize their recent market outlook.”: The agent fetches the user's recent tweets, extracts the text, and provides a concise summary of the analyst's recent posts.

Install

Download the skill as a ZIP:
https://mp-staging.autogineer.com/agent-skills/himself65/twitter-reader/download

Unzip it into the cross-client skills folder of your project:

mkdir -p .agents/skills && unzip twitter-reader.zip -d .agents/skills

Documentation by Alex Yang

Twitter Skill (Read-Only)

If your host has not already executed the shell probes below (for example, in Codex), run the commands inside the ! wrappers with its shell tool before choosing a setup path. Use the actual output; if shell access is unavailable, report that limitation.

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/opencli

If SETUP_NEEDED, guide the user through setup:

Setup

opencli requires Node.js >= 20 and a Chrome browser with the Browser Bridge extension:

Install the Browser Bridge extension:
- Download the latest opencli-extension-v{version}.zip from the GitHub Releases page
- Unzip it, open chrome://extensions in Chrome, and enable Developer mode
- Click Load unpacked and select the unzipped folder
Login to x.com in Chrome — opencli reuses your existing browser session
Verify connectivity:

opencli doctor

This 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 for-you\|following`, `--limit N` (default 20)
Search tweets	`opencli twitter search "QUERY"`	`--filter top\|live`, `--limit N` (default 15)
Trending topics	`opencli twitter trending`	`--limit N` (default 20)
Bookmarks	`opencli twitter bookmarks`	`--limit N` (default 20)
Recent tweets from a user	`opencli twitter tweets USERNAME`	`--limit N` (default 20)
View a specific thread	`opencli twitter thread TWEET_ID`	`--limit N` (default 50)
Twitter article	`opencli twitter article TWEET_ID`	—
User profile	`opencli twitter profile USERNAME`	— (defaults to logged-in user)
Followers	`opencli twitter followers USERNAME`	`--limit N` (default 50)
Following	`opencli twitter following USERNAME`	`--limit N` (default 50)
Notifications	`opencli twitter notifications`	`--limit N` (default 20)

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

# 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

Key rules

Check setup first — run opencli doctor before any other command if unsure about connectivity
Use -f json or -f yaml for structured output when processing data programmatically
Use -f csv when the user wants spreadsheet-compatible output
Use --limit N to control result count — start with 10-20 unless the user asks for more
For search, use --filter — top (default) for relevance, live for latest tweets
Read-only — don't post, like, retweet, reply, quote, follow, or delete, even though opencli exposes some of these commands

Output 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

Tweet-listing commands (timeline, search, thread) include: id, author, text, created_at, likes, retweets, replies, views, url, has_media, media_urls.

tweets (per-user posts) also includes is_retweet.

bookmarks columns: author, text, likes, retweets, bookmarks, url.

trending columns: rank, topic, tweets, category.

Profile (profile) columns: screen_name, name, bio, location, url, followers, following, tweets, likes, verified, created_at.

followers / following columns: screen_name, name, bio, followers.

notifications columns: id, action, author, text, url.

Step 4: Present the Results

Lead with what matters for the user's research question rather than a raw dump. Attribute each tweet (@handle, text, engagement such as likes and views, and the URL when the user may want the full thread), group search results by theme, and note the bullish or bearish lean and where views are consensus or contrarian. For profiles, give follower count, bio, and notable recent activity. Keep browser session details private.

Step 5: Diagnostics

If something isn't working, run:

opencli doctor

This 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 examples
references/schema.md — Output format documentation and column definitions

Read the reference files when you need exact command syntax, research workflow patterns, or output details.

Files

ATTRIBUTION.mdAdded by AutoGineer888 B
LICENSELicence file added by AutoGineer1.0 KiB
README.md2.3 KiB
SKILL.md7.6 KiB
references/commands.md8.4 KiB
references/schema.md4.2 KiB

references/commands.md

opencli Twitter Command Reference (Read-Only)

Complete read-only reference for Twitter commands in 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:

Node.js >= 20 (or Bun >= 1.0)
Chrome with the Browser Bridge extension installed
Logged into x.com in Chrome

Install the Browser Bridge extension:

Download opencli-extension-v{version}.zip from the GitHub Releases page
Unzip it, open chrome://extensions, enable Developer mode
Click Load unpacked and select the unzipped folder

Verify setup:

opencli doctor

This auto-starts the daemon, verifies extension connectivity, and checks browser session health.

Read Operations

Timeline (Home Feed)

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

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).

opencli twitter trending                          # Top 20 trending topics (default)
opencli twitter trending --limit 10               # Limit count
opencli twitter trending -f json                  # JSON output

Bookmarks

opencli twitter bookmarks                         # View bookmarked tweets
opencli twitter bookmarks --limit 30              # Limit count
opencli twitter bookmarks -f json                 # JSON output

Thread / Tweet Detail

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

opencli twitter article TWEET_ID                  # View long-form article
opencli twitter article TWEET_ID -f json          # JSON output

User Data

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.

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

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

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

opencli twitter search "$NVDA" --filter live --limit 30 -f json
opencli twitter search "$SPY puts" --filter live --limit 20 -f json

Track analyst commentary

# 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

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

# 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

# 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)

Requirements and compatibility

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Needs: Needs an API key, Needs Node.js

Security

What our scanner noticed· Low risk

Instructions that use the network

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Created by

Alex Yang

Publisher

Alex Yang (Community)

Source

himself65/finance-skills · plugins/social-readers/skills/twitter-reader · commit a085078

Licence

MIT License (redistribution allowed)

LICENSE (added by AutoGineer from LICENSE)
ATTRIBUTION.md (written by AutoGineer)

Synced

2026-11-08

AutoGineer is not affiliated with or endorsed by Alex Yang.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download twitter-reader.zip

From the author

AutoGineer summary

What it does

When to use it

Advantages

Usage examples

Install

Documentation by Alex Yang

Twitter Skill (Read-Only)

Step 1: Ensure opencli Is Installed and Ready

Setup

Common setup issues

Step 2: Identify What the User Needs

Step 3: Execute the Command

General pattern

Key rules

Output format flag (-f)

Output columns

Step 4: Present the Results

Step 5: Diagnostics

Error Reference

Reference Files

Files

references/commands.md

opencli Twitter Command Reference (Read-Only)

Setup

Read Operations

Timeline (Home Feed)

Search

Trending Topics

Bookmarks

Thread / Tweet Detail

Twitter Articles

User Data

Recent Tweets from a User

Notifications

Output Formats

Output columns by command

Financial Research Workflows

Search for earnings sentiment

Monitor fintwit for a ticker

Track analyst commentary

Macro / Fed watching

Daily market reading workflow

Export for analysis

Error Reference

Limitations

Best Practices

Requirements and compatibility

Security

Attribution and licence

Related skills

Playwright

Defuddle

Playwright Automation Fill In Form

Latchshot Page Capture

Agent Browser

Stitched Full Page Capture

Download ZIP

Output format flag (`-f`)