Discord Reader — A Financial Research Skill for Read-Only Discord Message Access

Skill Overview

Discord Reader is a read-only Claude skill that connects to the Discord desktop app through opencli. It helps you list servers and channels, search and read messages from trading communities, and collect discussions and sentiment references related to cryptocurrency and stock markets. It never sends messages, adds reactions, or performs any write operations.

Use Cases

1. Monitoring discussion activity in cryptocurrency or stock communities
   When you are tracking community opinions about BTC, ETH, or a particular stock, you can directly read recent chats in the target channel to quickly understand which topics are currently receiving attention and whether sentiment is optimistic or cautious.

2. Searching historical messages about specific assets in trading servers
   Use Discord’s built-in search to find keywords such as “company earnings,” “price target,” or “reduce position,” gathering scattered historical discussions from channels at once for market sentiment retrospectives.

3. Organizing server and channel structures to identify research data sources
   First list the servers your current account has joined, the channels within each server, and online members. Then determine which channels are worth monitoring over the long term before reading their contents, avoiding unnecessary searches through irrelevant channels.

Core Features

1. Server, channel, and member lists
   Use the opencli discord-app servers, channels, and members commands to view joined servers, the channel list of the current server, and online members. JSON, YAML, table, and other output formats are supported for convenient programmatic processing.

2. Reading recent channel messages
   Use opencli discord-app read to read a specified number of recent messages from the current channel. It is recommended to start with a small batch, such as 20 messages, and increase the number if needed. Messages include the speaker, content, and timestamp, making attribution and chronological analysis easier.

3. Searching historical messages by keyword
   Use opencli discord-app search "keyword" to invoke Discord’s built-in search and find historical messages about a specified topic within a channel. This is more efficient than scrolling through messages page by page and is suitable for focused collection around a particular asset or event.

Frequently Asked Questions

Can Discord Reader send messages or add reactions?

No. This is a strictly read-only skill used only for viewing and searching. Although opencli itself has commands for sending and deleting content, this skill explicitly does not call them. It does not send messages, add emoji reactions, edit or delete content, or perform any server administration. You can conduct research without using your account’s write permissions at all.

What needs to be prepared before use? Is a bot account or token required?

No bot account or token extraction is required. opencli connects to the Discord desktop app through the Chrome DevTools Protocol (CDP), so you only need to keep the Discord desktop client running. Two steps are required: first, launch Discord with a remote debugging port (on macOS: /Applications/Discord.app/Contents/MacOS/Discord --remote-debugging-port=9232); second, set the environment variable OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9232". Then use opencli discord-app status to confirm the connection status.

Why can’t messages be read when it says there is no active channel?

opencli reads the server and channel currently open in the Discord application; it does not support directly reading a channel by specifying its channel ID. If it reports that there is no active channel, Discord is not currently displaying any channel page. Open the target channel in the client and run the read command again. To switch data sources, first use channels to review the available channels, then switch channels in Discord.

What should I do if the CDP connection is refused?

Usually, Discord was not started with a remote debugging port, or the port is occupied by another program. You can first use lsof -i :9232 to confirm whether the port is listening, then use echo $OPENCLI_CDP_ENDPOINT to verify that the environment variable is active. If both are normal but the connection still fails, restart Discord with the debugging parameter and try again. It is recommended to add export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9232" to .zshrc or .bashrc to avoid resetting it each time you open a new terminal.

Can frequent requests trigger rate limiting?

Yes. Searches and reads use Discord’s own interfaces, and a large number of requests in a short period may trigger rate limiting, causing commands to fail or return abnormal results. If this happens, wait a few minutes before trying again, and limit the number of messages read to what is genuinely needed for the research. Start with a small batch and increase it only after confirming that the results are useful.

How can the output be used?

All commands support the -f option for specifying the format. JSON is suitable for direct processing by models or programs, YAML is structured and readable, Markdown is useful for compiling reports, and CSV can be imported into spreadsheets. JSON is recommended for quantitative or sentiment analysis, while Markdown or tables are more intuitive for manual review.