Twitter Reader — A Read-Only Twitter/X Financial Research Skill

Skill Overview

Twitter Reader is a read-only Twitter/X reading skill built on opencli. It reuses your session already logged in through Chrome, allowing you to read timelines, search tweets, view bookmarks, track trending topics and analyst activity without an API key or cookie extraction. It helps investors and financial researchers efficiently collect market sentiment and financial news.

Use Cases

1. Market sentiment and public-opinion research: When you want to understand the current level of discussion and bullish or bearish sentiment on Twitter regarding a specific stock, sector, or the broader market, you can search keywords directly and retrieve tweet text along with engagement data such as likes, reposts, and views. This can help assess consensus and contrarian perspectives.
2. Tracking analysts and financial bloggers: By reading the latest tweets from specified users or viewing the timeline of accounts you follow, you can quickly keep up with professionals’ real-time views during key events such as earnings season and monetary policy meetings, without manually digging through the feed.
3. Organizing research materials and topic ideas: Export bookmarks, trending topics, and search results in JSON, YAML, or CSV format for direct integration with scripts or spreadsheets. This is suitable for quantitative research, financial writing, and content planning that require material to be collected and organized.

Core Features

1. Multidimensional content retrieval: Covers timelines (For You and Following), keyword searches (Top and Latest sorting), trending topics, bookmarks, tweets from specified users, complete threads, individual long-form posts, and notifications—essentially covering the reading workflows commonly used in financial research. Every tweet includes the author, text, publication time, and engagement data.
2. User and relationship queries: View user profile details such as bio, location, follower count, following count, verification status, and registration date, as well as lists of their followers and accounts they follow. This helps quickly assess the influence and background of information sources.
3. Zero-key browser session reuse: Uses opencli’s Browser Bridge extension to reuse the logged-in x.com session in Chrome. There is no need to apply for a developer account, configure an API key, or manually export cookies. Multiple output formats—table, JSON, YAML, Markdown, and CSV—are also available for programmatic use.

Frequently Asked Questions

What is Twitter Reader, and what can it do?

It is a read-only Twitter/X reading skill implemented with opencli. You can use it to view the home timeline, search tweets, browse trending topics, read bookmarks, view a user’s latest tweets, expand complete threads and long-form posts, view profiles and follow relationships, and read notifications. It is intended for information gathering in financial research and does not involve any account operations.

Does it require an API key?

No. opencli works by reusing the session from your Chrome browser where you are already logged in to x.com. You only need to have logged in to x.com in Chrome and installed the Browser Bridge extension. Run opencli doctor to check whether the daemon, extension connection, and session status are working properly.

Does it support posting, liking, reposting, or following?

No. This is an explicit boundary of the skill. Twitter Reader is strictly read-only and will not perform any write operations, including posting, liking, reposting, replying, quoting, following, or deleting. If you need to publish content, use the official client.

What should I do if I see “Extension not connected” or “No session”?

The former indicates that the Browser Bridge extension is not installed or enabled in Chrome. Download the appropriate ZIP file from the opencli GitHub Releases page, extract it, enable Developer mode at chrome://extensions, and select “Load unpacked.” The latter indicates that there is currently no logged-in x.com session. Log in to x.com in Chrome and try again. If you see a missing CSRF token message, refreshing the x.com page to regenerate the cookie will usually resolve the issue. For other situations, run opencli doctor first to perform a complete diagnostic check.

How do I use it to search for discussions about a specific stock?

Use the search command with the relevant keyword. For example, to search for earnings-related discussions, pass "$AAPL earnings". To see the latest views, change the sorting to Latest with --filter live; to prioritize highly relevant content, keep the default Top sorting with --filter top. The likes, reposts, and views in the results can serve as references for assessing topic popularity, while tweet links let you return to the original post and view its full context.

How many items can it read at once?

Each command has a quantity parameter, with different defaults: timelines, trending topics, bookmarks, notifications, and tweets from specified users default to 20 items; searches default to 15; threads default to 50; and follower and following lists default to 50. It is recommended to start with 10 to 20 items, confirm that the results meet expectations, and then increase the amount as needed to avoid triggering platform rate limits.

Can the retrieved data be exported as a table?

Yes. Use -f csv to output CSV files that can be opened directly in spreadsheet software. Use -f json or -f yaml when passing the data to scripts or large language models for further processing. The columns vary slightly between commands. For example, tweet-related commands include the author, text, publication time, likes, reposts, replies, views, links, and media information.

What environment is required?

Node.js 20 or later is required, along with the Browser Bridge extension and a Chrome browser logged in to x.com. After installing opencli globally, it is recommended that you run opencli doctor once before first use to verify connectivity. Also note that making a large number of requests in a short period may trigger platform rate limits; wait a few minutes and try again.