Back to Skills

twitter-reader

Read Twitter/X for financial research using opencli (read-only). Use this skill whenever the user wants to read their Twitter feed, search for financial tweets, view bookmarks, look up user profiles, or gather market sentiment from Twitter/X. Triggers include: "check my feed", "search Twitter for", "show my bookmarks", "who follows", "look up @user", "what's trending about", "market sentiment on Twitter", "what are people saying about AAPL", "recent tweets from @elonmusk", "show me @user's posts

3,095stars357forksUpdated 8/1/2026

Security Assessment

Safe(90/100)
Security Score90/100

About twitter-reader

This skill reads Twitter/X for financial research using opencli, a universal CLI that bridges web services to the terminal by reusing an existing browser login session. It solves the problem of gathering market sentiment and financial discussion from Twitter/X — feeds, searches, bookmarks, profiles, trending topics, and threads — from the terminal without extracting cookies or provisioning API keys. The skill is explicitly and strictly read-only: it does not support posting, liking, retweeting, replying, following, or any write operation.

The workflow first checks that opencli is installed and healthy via opencli doctor, guiding installation through npm and setup of the Chrome Browser Bridge extension (requiring Node.js 21+ and being logged into x.com). It then maps user requests to specific read commands — timeline, search, trending, bookmarks, per-user tweets, threads, articles, profiles, followers, following, and notifications — each with limit and format flags. Output can be rendered as table, JSON, YAML, Markdown, or CSV, with documented column sets per command. Presentation guidance emphasizes summarizing relevant tweets, including attribution and engagement metrics, flagging bullish/bearish sentiment, and treating browser sessions as private and never exposing them.

It targets investors, analysts, and finance-focused agent users doing fintwit research and sentiment tracking. Because it reuses a logged-in Chrome session rather than exfiltrating credentials, and forbids all write actions, it stays within safe read-only bounds.

FAQ

Can this skill post or interact on Twitter?

No. It is strictly read-only and explicitly forbids posting, liking, retweeting, replying, quoting, following, and deleting.

How does it authenticate to Twitter/X?

It reuses your existing Chrome login session through the opencli Browser Bridge extension, so no API keys or cookie extraction are required — you just need to be logged into x.com in Chrome.

What are the setup requirements?

opencli installed globally via npm, Node.js 21 or newer, and the Browser Bridge Chrome extension loaded in developer mode, verified with opencli doctor.

What kinds of data can it read?

Timeline/feed, tweet search, trending topics, bookmarks, a user's recent tweets, threads, articles, profiles, followers, following, and notifications.

What output formats are supported?

Table (default), JSON, YAML, Markdown, and CSV, selected with the -f flag; JSON or YAML is recommended for programmatic processing.

All Files

4 files
SKILL.md7.7 KB
View
references/schema.md4.2 KB
View
references/commands.md8.4 KB
View
README.md2.3 KB
View

Install twitter-reader

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill