Skip to content

himself65/finance-skills / plugins/social-readers/skills/twitter-reader

twitter-reader

Unverified

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.

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:

  1. 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
  2. Login to x.com in Chrome — opencli reuses your existing browser session
  3. Verify connectivity:
opencli doctor

This auto-starts the daemon, verifies the extension is connected, and checks session health.

Common setup issues

SymptomFix
Extension not connectedInstall Browser Bridge extension in Chrome and ensure it's enabled
Daemon not runningRun opencli doctor — it auto-starts the daemon
No session for twitter.comLogin to x.com in Chrome, then retry
CSRF token missingRefresh 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 RequestCommandKey Flags
Setup checkopencli doctor—
Home feed / timelineopencli twitter timeline--type for-you|following, --limit N (default 20)
Search tweetsopencli twitter search "QUERY"--filter top|live, --limit N (default 15)
Trending topicsopencli twitter trending--limit N (default 20)
Bookmarksopencli twitter bookmarks--limit N (default 20)
Recent tweets from a useropencli twitter tweets USERNAME--limit N (default 20)
View a specific threadopencli twitter thread TWEET_ID--limit N (default 50)
Twitter articleopencli twitter article TWEET_ID—
User profileopencli twitter profile USERNAME— (defaults to logged-in user)
Followersopencli twitter followers USERNAME--limit N (default 50)
Followingopencli twitter following USERNAME--limit N (default 50)
Notificationsopencli 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

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

Output format flag (-f)

FormatFlagBest for
Table-f table (default)Human-readable terminal output
JSON-f jsonProgrammatic processing, LLM context
YAML-f yamlStructured output, readable
Markdown-f mdDocumentation, reports
CSV-f csvSpreadsheet 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

ErrorCauseFix
Extension not connectedBrowser Bridge not installed/enabledInstall extension and enable it in Chrome
No sessionNot logged into x.comLogin to x.com in Chrome
CSRF token missingCookie expired or page needs refreshRefresh x.com in Chrome
Rate limitedToo many requestsWait 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.

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: 463kUpdated Claude CodeCodexVerifiedInstall
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: 463kUpdated Claude CodeCodexVerifiedInstall
discernment-nudgeanthropics/skillsAfter you give a substantive answer or draft that the user may act on — advice or recommendations, drafted artifacts such as goals, plans, pitches, proposals, or emails, estimates or projections, analysis or interpretation of data, factual claims they may rely on, or a multi-step argument — invoke this skill BEFORE finalizing your reply and then, if it applies, append 2-3 short follow-up questions, each tied to something specific in what you just produced, that help the user check key facts, probe the reasoning or assumptions, and notice missing context. Do this at most once per conversation. Skip it when the user asked a trivial how-to or simple lookup, wants a purely educational explanation, asked you only to format, convert, or assemble a file from content they provided, is writing code they will run, is doing creative writing or casual chat, or already asked you to double-check, cite, or review — the skill file explains these boundaries and the exact output format.Stars: 195kUpdated Claude CodeCodexVerifiedInstall
internal-commsanthropics/skillsA set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill whenever asked to write some sort of internal communications (status reports, leadership updates, 3P updates, company newsletters, FAQs, incident reports, project updates, etc.).Stars: 195kUpdated Claude CodeCodexVerifiedInstall