Twitter Reader
Read Twitter/X timelines, search, and profiles for market sentiment and fintwit research without posting or API keys, via opencli and your Chrome session.
Overview
Twitter-reader is an agent skill most often used in Idea (also Grow analytics) that reads X/Twitter via opencli for financial search, sentiment, and fintwit monitoring without write access.
Install
npx skills add https://github.com/himself65/finance-skills --skill twitter-readerWhat is this skill?
- Read-only X/Twitter: feed, search, trending, bookmarks, profiles, threads, articles, notifications—no post/like/retweet/
- Nine read surfaces: home feed, search, trending, bookmarks, user tweets, profiles, followers/following, threads/articles
- Uses opencli with Chrome Browser Bridge—reuses logged-in x.com session, no Twitter API keys
- Trigger phrases include market sentiment, fintwit, ticker discussions, and @user lookups
- Explicit platform limit: CLI agents with network access; not Claude.ai sandbox
- Nine documented read capabilities (feed, search, trending, bookmarks, user tweets, profiles, threads/articles, notificat
- Read-only: no post, like, retweet, or reply operations
Adoption & trust: 857 installs on skills.sh; 2.7k GitHub stars; 1/3 security scanners passed (skills.sh audits).
What problem does it solve?
You need timely market chatter and analyst takes on X without paying for API access or risking accidental posts from your research agent.
Who is it for?
Solo traders and indie builders on Claude Code or similar CLI agents who already use Chrome logged into x.com for fintwit research.
Skip if: Claude.ai web sessions, automated posting or engagement bots, or users who need certified exchange-grade data feeds instead of social sentiment.
When should I use this skill?
User asks to check feed, search Twitter/X for tickers or themes, show bookmarks, look up @user, read fintwit sentiment, or mentions Twitter in financial market research.
What do I get? / Deliverables
You get structured read-only Twitter data—search results, feeds, profiles, and threads—to inform research notes or monitoring dashboards.
- Search results or timelines summarized for the agent session
- Profile, trending, or bookmark reads for financial context
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Financial discovery and sentiment scanning most often start in Idea research before you commit capital or product bets. The skill is read-only social research for markets—canonical first shelf is research under Idea, with reuse in growth monitoring.
Where it fits
Search X for early sentiment on a sector theme before sizing a side project or trade thesis.
Read timelines of fintwit accounts discussing rival products or tickers in your niche.
Monitor trending topics and bookmarked threads weekly to see if user narrative matches your metrics.
Gauge whether real users complain about a problem you plan to solve by keyword search on X.
How it compares
Browser-session social reader via opencli—not a Twitter API integration and not a trade execution skill.
Common Questions / FAQ
Who is twitter-reader for?
Financial researchers and indie builders who want read-only X/Twitter access from CLI coding agents for tickers, macro themes, and fintwit monitoring.
When should I use twitter-reader?
During Idea research for sentiment on a symbol, Grow lifecycle checks on narrative shifts, or anytime you ask to search Twitter, read a feed, or look up @users for market context.
Is twitter-reader safe to install?
It is read-only on X but uses your browser session and network; review the Security Audits panel on this Prism page and avoid running it where browser bridge access is untrusted.
SKILL.md
READMESKILL.md - Twitter Reader
# twitter-reader Read-only Twitter/X skill for financial research using [opencli](https://github.com/jackwener/opencli). ## What it does Reads Twitter/X for financial research — searching market discussions, reading analyst tweets, tracking sentiment, and monitoring financial news. Capabilities include: - **Home feed / timeline** — read your feed ("For You" or "Following") - **Search** — find tweets by keyword with relevance or recency filters - **Trending** — view trending topics for market themes - **Bookmarks** — view your saved tweets - **User tweets** — fetch a user's recent posts (chronological) - **User profiles** — look up users, their followers, and following - **Tweet threads & articles** — view specific threads and long-form articles - **Notifications** — read your Twitter notifications **This skill is read-only.** It does NOT support posting, liking, retweeting, replying, or any write operations. ## Authentication No API keys needed — opencli reuses your existing Chrome browser session via the Browser Bridge extension. Just be logged into x.com in Chrome. ## Triggers - "check my feed", "search Twitter for", "show my bookmarks" - "what are people saying about AAPL", "market sentiment on Twitter" - "look up @user", "who follows", "fintwit", "what's trending" - Any mention of Twitter/X in context of financial news or market research ## Platform Works on **Claude Code** and other CLI-based agents. Does **not** work on Claude.ai — the sandbox restricts network access and binaries required by opencli. ## Setup ```bash # As a plugin (recommended — installs all skills) npx plugins add himself65/finance-skills --plugin finance-social-readers # Or install just this skill npx skills add himself65/finance-skills --skill twitter-reader ``` See the [main README](../../../../README.md) for more installation options. ## Prerequisites - Node.js >= 21 (for `npm install -g @jackwener/opencli`) - Chrome with the [Browser Bridge extension](https://github.com/jackwener/opencli/releases) installed (load unpacked from `chrome://extensions` in Developer mode) - Logged into x.com in Chrome ## 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 # 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 >= 21 (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`), `