Discord Reader

Discord Skill (Read-Only)

Reads Discord for financial research using opencli, a universal CLI tool that bridges desktop apps and web services to the terminal via Chrome DevTools Protocol (CDP).

This skill is read-only. It is designed for financial research: searching trading server discussions, monitoring crypto/market groups, tracking sentiment in financial communities, and reading messages. It does NOT support sending messages, reacting, editing, deleting, or any write operations.

Important: opencli connects to the Discord desktop app via CDP — no bot account or token extraction needed. Just have Discord Desktop running.

---

Step 1: Ensure opencli Is Installed and Discord Is Ready

Current environment status:

!`(command -v opencli && opencli discord-app status 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 >= 21. It connects to Discord Desktop via CDP (Chrome DevTools Protocol) — no Browser Bridge extension is needed for the Discord adapter. Two things are required:

1. Start Discord with remote debugging enabled:

# macOS
/Applications/Discord.app/Contents/MacOS/Discord --remote-debugging-port=9232 &

# Linux
discord --remote-debugging-port=9232 &

2. Set the CDP endpoint environment variable:

export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9232"

Add this to your shell profile (.zshrc / .bashrc) so it persists across sessions.

3. Verify connectivity:

opencli discord-app status

Common setup issues

Tip: create a shell alias

alias discord-cdp='/Applications/Discord.app/Contents/MacOS/Discord --remote-debugging-port=9232 &'

---

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.

Note: opencli operates on the currently active server and channel in Discord. To read from a different channel, the user must navigate to it in the Discord app first, or use the channels command to identify what's available.

---

Step 3: Execute the Command

General pattern

# Use -f json or -f yaml for structured output
opencli discord-app servers -f json
opencli discord-app channels -f json

# Read recent messages from the active channel
opencli discord-app read 50 -f json

# Search for financial topics in the active channel
opencli discord-app search "AAPL earnings" -f json
opencli discord-app search "BTC pump" -f json

Key rules

1. Check connection first — run opencli discord-app status before any other command 2. Use `-f json` or `-f yaml` for structured output when processing data programmatically 3. Navigate in Discord first — opencli reads from the currently active server/channel in the Discord app 4. Start with small reads — use opencli discord-app read 20 unless the user asks for more 5. Use search for keywords — opencli discord-app search uses Discord's built-in search (Cmd+F / Ctrl+F) 6. NEVER execute write operations — this skill is read-only. opencli exposes discord-app send and discord-app delete commands; do not invoke them. Do not send messages, react, edit, delete, or manage server settings.

Output format flag (-f)

Typical workflow for reading a server

# 1. Verify connection
opencli discord-app status

# 2. List servers to confirm you're in the right one
opencli discord-app servers -f json

# 3. List channels in the current server
opencli discord-app channels -f json

# 4. Read recent messages (navigate to target channel in Discord first)
opencli discord-app read 50 -f json

# 5. Search for topics of interest
opencli discord-app search "price target" -f json

---

Step 4: Present the Results

After fetching data, present it clearly for financial research:

1. Summarize key content — highlight the most relevant messages for the user's financial research 2. Include attribution — show username, message content, and timestamp 3. For search results, group by relevance and highlight key themes, sentiment, or market signals 4. For server/channel listings, present as a clean table with names and types 5. Flag sentiment — note bullish/bearish sentiment, consensus vs contrarian views 6. Treat sessions as private — never expose CDP endpoints or session details

---

Step 5: Diagnostics

If something isn't working, check:

1. Is Discord running with CDP?

# Check if the port is open
lsof -i :9232

2. Is the environment variable set?

echo $OPENCLI_CDP_ENDPOINT

3. Can opencli connect?

opencli discord-app status

If all checks fail, restart Discord with the CDP flag:

/Applications/Discord.app/Contents/MacOS/Discord --remote-debugging-port=9232 &
export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9232"
opencli discord-app status

---

Error Reference

---

Reference Files

• references/commands.md — Complete read command reference with all flags and usage examples

Read the reference file when you need exact command syntax or detailed flag descriptions.

discord-reader

Read-only Discord skill for financial research using opencli.

What it does

Reads Discord for financial research — reading trading server messages, searching for market discussions, monitoring crypto/market groups, and tracking sentiment in financial communities. Capabilities include:

• Servers — list all joined servers
• Channels — list channels in the active server
• Messages — read recent messages from the active channel
• Search — find messages by keyword in the active channel
• Members — list online members in the active server

This skill is read-only. It does NOT support sending messages, reacting, editing, deleting, or any write operations.

Authentication

No bot account or token extraction needed — opencli connects to Discord Desktop via Chrome DevTools Protocol (CDP). Just have Discord running with --remote-debugging-port=9232.

Triggers

• "check my Discord", "search Discord for", "read Discord messages"
• "what's happening in the trading Discord", "show Discord channels"
• "Discord sentiment on BTC", "what are people saying in Discord about AAPL"
• "monitor crypto Discord", "list my servers"
• Any mention of Discord 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

# 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 discord-reader

See the main README for more installation options.

Prerequisites

• Node.js >= 21 (for npm install -g @jackwener/opencli)
• Discord Desktop running with --remote-debugging-port=9232
• Environment variable: export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9232"

The Browser Bridge extension is not required for the Discord adapter — it only uses CDP.

Reference files

• references/commands.md — Complete read command reference with all flags, research workflows, and usage examples

opencli Discord Command Reference (Read-Only)

Complete read-only reference for Discord commands in opencli, scoped to financial research use cases.

Install: npm install -g @jackwener/opencli

This skill is read-only. Write operations (sending messages, reacting, editing, deleting) are NOT supported in this finance skill.

---

Setup

opencli connects to Discord Desktop via Chrome DevTools Protocol (CDP) — no bot account, token extraction, or Browser Bridge extension needed.

Requirements: 1. Node.js >= 21 (or Bun >= 1.0) 2. Discord Desktop running with --remote-debugging-port=9232 3. OPENCLI_CDP_ENDPOINT environment variable set

Start Discord with CDP:

# macOS
/Applications/Discord.app/Contents/MacOS/Discord --remote-debugging-port=9232 &

# Linux
discord --remote-debugging-port=9232 &

Set the environment variable:

export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9232"

Verify connectivity:

opencli discord-app status

---

Read Operations

Connection Status

opencli discord-app status                        # Check CDP connection
opencli discord-app status -f json                # JSON output

Servers (Guilds)

opencli discord-app servers                       # List all joined servers
opencli discord-app servers -f json               # JSON output
opencli discord-app servers -f yaml               # YAML output

Channels

Lists channels in the currently active server in Discord.

opencli discord-app channels                      # List channels in current server
opencli discord-app channels -f json              # JSON output

Members

Lists online members in the currently active server.

opencli discord-app members                       # List online members
opencli discord-app members -f json               # JSON output

Read Messages

Reads recent messages from the currently active channel in Discord.

opencli discord-app read                          # Read last 20 messages (default)
opencli discord-app read 50                       # Read last 50 messages
opencli discord-app read 100 -f json              # JSON output
opencli discord-app read 30 -f yaml               # YAML output
opencli discord-app read 50 -f csv                # CSV output

Search Messages

Searches messages in the current context using Discord's built-in search (Cmd+F / Ctrl+F).

opencli discord-app search "keyword"              # Search in active channel
opencli discord-app search "AAPL earnings" -f json  # JSON output
opencli discord-app search "BTC pump" -f yaml     # YAML output

---

Output Formats

All commands support the -f / --format flag:

Output columns by command

---

Financial Research Workflows

Read latest messages from a trading channel

# Navigate to the target channel in Discord first, then:
opencli discord-app read 50 -f json

Search for crypto sentiment

opencli discord-app search "BTC pump" -f json
opencli discord-app search "ETH breakout" -f json

Search for earnings / market discussion

opencli discord-app search "earnings call" -f json
opencli discord-app search "price target" -f json
opencli discord-app search "NVDA" -f json

Survey a trading server

# 1. List servers
opencli discord-app servers -f json

# 2. List channels (navigate to target server in Discord)
opencli discord-app channels -f json

# 3. Read recent messages (navigate to target channel)
opencli discord-app read 50 -f json

# 4. Search for topics
opencli discord-app search "market outlook" -f json

Export for analysis

# CSV for spreadsheet analysis
opencli discord-app read 100 -f csv > trading_chat.csv

# JSON for programmatic processing
opencli discord-app read 100 -f json > messages.json

---

Error Reference

---

Limitations

• Read-only in this skill — opencli itself exposes discord-app send and discord-app delete commands, but this skill forbids them
• Active channel only — reads from the currently viewed channel in Discord; navigate in the app to switch
• No DMs — direct messages are not supported
• No voice channels — voice/audio not accessible
• No message history sync — no local database; reads live from the app
• No server-side search — search uses Discord's in-app Cmd+F / Ctrl+F
• Requires Discord Desktop — the web client is not supported (CDP connects to the Electron app)

---

Best Practices

• Navigate first, then read — switch to the target channel in Discord before running read or search
• Keep read counts reasonable — use read 50 not read 10000
• Use `-f json` for programmatic processing and LLM context
• Use `-f csv` when the user wants to analyze data in a spreadsheet
• Add CDP startup to your workflow — use a shell alias or launch script to start Discord with the CDP flag
• Treat CDP endpoints as private — never log or display connection URLs