discord-reader
installsforks
How to install discord-reader?
himself65/finance-skills/discord-reader
$npx -y skills add himself65/finance-skills --skill discord-readerRead Discord for financial research using opencli (read-only). Use this skill whenever the user wants to read Discord channels, search for messages in trading servers, view guild/channel info, monitor crypto or market discussion groups, or gather financial sentiment from Discord.
SKILL.md
| 1 | # Discord Skill (Read-Only) |
| 2 | |
| 3 | Reads Discord for financial research using [opencli](https://github.com/jackwener/opencli), a universal CLI tool that bridges desktop apps and web services to the terminal via Chrome DevTools Protocol (CDP). |
| 4 | |
| 5 | **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. |
| 6 | |
| 7 | **Important**: opencli connects to the Discord desktop app via CDP — no bot account or token extraction needed. Just have Discord Desktop running. |
| 8 | |
| 9 | --- |
| 10 | |
| 11 | ## Step 1: Ensure opencli Is Installed and Discord Is Ready |
| 12 | |
| 13 | **Current environment status:** |
| 14 | |
| 15 | ``` |
| 16 | !`(command -v opencli && opencli discord-app status 2>&1 | head -5 && echo "READY" || echo "SETUP_NEEDED") 2>/dev/null || echo "NOT_INSTALLED"` |
| 17 | ``` |
| 18 | |
| 19 | If the status above shows `READY`, skip to Step 2. If `NOT_INSTALLED`, install first: |
| 20 | |
| 21 | ```bash |
| 22 | # Install opencli globally |
| 23 | npm install -g @jackwener/opencli |
| 24 | ``` |
| 25 | |
| 26 | If `SETUP_NEEDED`, guide the user through setup: |
| 27 | |
| 28 | ### Setup |
| 29 | |
| 30 | 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: |
| 31 | |
| 32 | 1. **Start Discord with remote debugging enabled:** |
| 33 | |
| 34 | ```bash |
| 35 | # macOS |
| 36 | /Applications/Discord.app/Contents/MacOS/Discord --remote-debugging-port=9232 & |
| 37 | |
| 38 | # Linux |
| 39 | discord --remote-debugging-port=9232 & |
| 40 | ``` |
| 41 | |
| 42 | 2. **Set the CDP endpoint environment variable:** |
| 43 | |
| 44 | ```bash |
| 45 | export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9232" |
| 46 | ``` |
| 47 | |
| 48 | Add this to your shell profile (`.zshrc` / `.bashrc`) so it persists across sessions. |
| 49 | |
| 50 | 3. **Verify connectivity:** |
| 51 | |
| 52 | ```bash |
| 53 | opencli discord-app status |
| 54 | ``` |
| 55 | |
| 56 | ### Common setup issues |
| 57 | |
| 58 | | Symptom | Fix | |
| 59 | |---------|-----| |
| 60 | | `CDP connection refused` | Ensure Discord is running with `--remote-debugging-port=9232` | |
| 61 | | `OPENCLI_CDP_ENDPOINT not set` | Run `export OPENCLI_CDP_ENDPOINT="http://127.0.0.1:9232"` | |
| 62 | | `status` shows disconnected | Restart Discord with the CDP flag and retry | |
| 63 | | Discord not on expected port | Check that no other app is using port 9232, or use a different port | |
| 64 | |
| 65 | ### Tip: create a shell alias |
| 66 | |
| 67 | ```bash |
| 68 | alias discord-cdp='/Applications/Discord.app/Contents/MacOS/Discord --remote-debugging-port=9232 &' |
| 69 | ``` |
| 70 | |
| 71 | --- |
| 72 | |
| 73 | ## Step 2: Identify What the User Needs |
| 74 | |
| 75 | Match the user's request to one of the read commands below, then use the corresponding command from `references/commands.md`. |
| 76 | |
| 77 | | User Request | Command | Key Flags | |
| 78 | |---|---|---| |
| 79 | | Connection check | `opencli discord-app status` | — | |
| 80 | | List servers | `opencli discord-app servers` | `-f json` | |
| 81 | | List channels | `opencli discord-app channels` | `-f json` | |
| 82 | | List online members | `opencli discord-app members` | `-f json` | |
| 83 | | Read recent messages | `opencli discord-app read` | `N` (count), `-f json` | |
| 84 | | Search messages | `opencli discord-app search "QUERY"` | `-f json` | |
| 85 | |
| 86 | **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. |
| 87 | |
| 88 | --- |
| 89 | |
| 90 | ## Step 3: Execute the Command |
| 91 | |
| 92 | ### General pattern |
| 93 | |
| 94 | ```bash |
| 95 | # Use -f json or -f yaml for structured output |
| 96 | opencli discord-app servers -f json |
| 97 | opencli discord-app channels -f json |
| 98 | |
| 99 | # Read recent messages from the active channel |
| 100 | opencli discord-app read 50 -f json |
| 101 | |
| 102 | # Search for financial topics in the active channel |
| 103 | opencli discord-app search "AAPL earnings" -f json |
| 104 | opencli discord-app search "BTC pump" -f json |
| 105 | ``` |
| 106 | |
| 107 | ### Key rules |
| 108 | |
| 109 | 1. **Check connection first** — run `opencli discord-app status` before any other command |
| 110 | 2. **Use `-f json` or `-f yaml`** for structured output when processing data programmatically |
| 111 | 3. **Navigate in Discord first** — opencli reads from the currently active server/channel in the Discord app |
| 112 | 4. **Start with small reads** — use `opencli discord-app read 20` unless the user asks for more |
| 113 | 5. **Use search for keywords** — `opencli discord-app search` uses Discord's built |
People who liked this also viewed
6 picksType
- azure-resource-lookupList, find, and show Azure resources across subscriptions or resource groups. Handles prompts like \"list the websites in my subscription\", \"list my web apps\", \"show my app services\", \"list virtSkillsJul 2026
- azure-messagingTroubleshoot and resolve issues with Azure Messaging SDKs for Event Hubs and Service Bus. Covers connection failures, authentication errors, message processing issues, and SDK configuration problems. SkillsJul 2026
- lark-doc飞书云文档（Docx / Wiki 文档）：读取和编辑飞书文档内容。当用户给出文档 URL 或 token，或需要查看、创建、编辑文档、插入或下载文档图片附件时使用。文档中嵌入的电子表格、多维表格、画板，先用本 skill 提取 token 再切到对应 skill。当用户给出 doubao.com 的 /docx/ 或 /wiki/ URL/token 时，也应直接使用本 skill；路由依据是 SkillsJul 2026
- lark-im飞书即时通讯：收发消息和管理群聊。发送和回复消息、搜索聊天记录、管理群聊成员、上传下载图片和文件（支持大文件分片下载）、管理表情回复、发送应用内/短信/电话加急、发送和处理交互卡片（Interactive Card）、监听卡片按钮回调（card.action.trigger）。当用户需要发消息、查看或搜索聊天记录、下载聊天中的文件、查看群成员、搜索群、创建群聊或话题群、管理标记数据、管理 FeedSkillsJul 2026
- lark-wiki飞书知识库：管理知识空间、空间成员和文档节点。创建和查询知识空间、查看和管理空间成员、管理节点层级结构、在知识库中组织文档和快捷方式。当用户需要在知识库中查找或创建文档、浏览知识空间结构、查看或管理空间成员、移动或复制节点时使用。当用户给出 doubao.com 的 /wiki/ URL/token 时，也应直接使用本 skill，不要因为域名不是飞书而回退到 WebFetch；路由依据是 URLSkillsJul 2026
- lark-mail飞书邮箱：Use when user mentions 起草邮件、写邮件、草稿、发送/回复/转发邮件、查阅邮件、看邮件、搜索邮件、邮件文件夹、邮件标签、邮件联系人、监听新邮件、邮件收信规则等；use for mail/email intent only. Do not use for docs/sheets/calendar/auth setup/pure contact lookup/IM chSkillsJul 2026
