К основному содержанию
скилл CX Codex

discordbot — скилл для Claude Code: что делает и как установить

Скилл discordbot для Claude Code управляет Discord от имени бота: показывает серверы и каналы, читает и отправляет сообщения. Работает на серверах, куда бота уже пригласили.

Apache-2.0 181 установок ★ 17 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add AceDataCloud/Skills --skill discordbot -a claude-code
Открыть на GitHub

Что делает discordbot

Скилл обращается к Discord REST API с помощью curl и jq, используя токен бота из $DISCORDBOT_TOKEN. Он может показать серверы и текстовые каналы, прочитать недавние сообщения, отправить сообщение или ответить на конкретное. Действия доступны только там, куда бота пригласили и где ему выдали нужные разрешения.

Для чтения текста сообщений нужен включённый Message Content Intent; без него часть сообщений возвращается с пустым содержимым. Личные сообщения разрешены одному пользователю после его явного обращения к боту. Перед отправкой нужно подтвердить адресата и текст: отправленное сообщение нельзя отменить.

Для личного сообщения скрипт scripts/discordbot.py проверяет сообщение с согласием и адресата; по умолчанию команда работает в режиме пробного запуска. Для работы нужны токен бота и python3. Если бот не состоит на сервере или у него нет нужных прав, Discord вернёт ошибку доступа.

Какие задачи решает

  • показать серверы, доступные боту
  • найти текстовые каналы на сервере
  • прочитать недавнюю переписку в канале
  • отправить сообщение или ответить на него
  • написать личное сообщение пользователю после его запроса

Примеры запросов агенту

  • Покажи серверы и текстовые каналы, которые видит мой бот в Discord.
  • Прочитай недавние сообщения в канале CHANNEL_ID и кратко перескажи их.
  • После проверки согласия отправь этому пользователю личное сообщение с текстом CONTENT.

Как установить discordbot

1Через Skills CLI (Vercel)

npx skills add AceDataCloud/Skills --skill discordbot -a claude-code

2Вручную: положить файлы

~/.claude/skills/discordbot/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/discordbot/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о discordbot

Как установить discordbot в Claude Code?

Выполните npx skills add AceDataCloud/Skills --skill discordbot -a claude-code. Файл скилла появится по пути ~/.claude/skills/discordbot/SKILL.md.

Что делает discordbot?

Он управляет Discord через REST API от имени бота: перечисляет доступные серверы и каналы, читает сообщения и публикует их. Личное сообщение отправляется одному пользователю после подтверждённого согласия.

Что нужно для чтения текста сообщений?

У бота должен быть включён Message Content Intent, а в канале — разрешение Read Message History. Без этого часть сообщений может приходить с пустым текстом.

Исходный текст

SKILL.md · Apache-2.0
---
name: discordbot
description: List channels, read recent messages, send channel messages, and send a single user-initiated DM on Discord using the user's own bot via the Discord REST API.
when_to_use: |
  Trigger when the user wants to send, read, or list things on Discord
  through their bot: list the servers/channels the bot can see, read recent
  messages in a channel, post / reply in a channel, or DM one user who has
  explicitly initiated the interaction. Messages are sent as the BOT, not
  the user's personal account, and only where the bot has access.
connections: [discordbot]
allowed_tools: [Bash]
license: Apache-2.0
metadata:
  author: acedatacloud
  version: "1.1"
---

We drive the [Discord API](https://discord.com/developers/docs/reference)
with `curl + jq` using the user's **bot** token in `$DISCORDBOT_TOKEN`. The
auth header is `Authorization: Bot $DISCORDBOT_TOKEN` — note the literal
`Bot ` prefix (NOT `Bearer`). Base URL is `https://discord.com/api/v10`.

This acts as the user's registered **bot**, so it can only see and act in
servers (guilds) the bot has been **invited to** and only where it has the
relevant permission (View Channels / Send Messages / Read Message History).
A `403 Forbidden` (code 50001 "Missing Access" / 50013 "Missing
Permissions") almost always means the bot isn't in that server or lacks the
permission — tell the user to invite the bot or grant the permission rather
than retrying.

Errors are JSON `{"code": <n>, "message": "<reason>"}`. A `401` means the
bot token is wrong/reset — ask the user to re-paste it at
`studio.acedata.cloud/console/connectors`. A `429` carries `retry_after`
(seconds) — sleep that long, then retry; never parallelize.

## Sending safety

- Before sending, confirm the exact destination and final content with the
  user. Sending is irreversible.
- A DM must be initiated by a recipient action, such as asking the bot for
  details by replying with an advertised keyword. Server membership, a public
  profile, or appearing in a member list is not consent.
- Send to exactly one recipient per invocation. Never enumerate members,
  create DM channels in a loop, or send unsolicited/bulk outreach.
- For an unattended scheduled run, send only when its task definition already
  contains one exact `recipient_id`, `consent_channel_id`,
  `consent_message_id`, `consent_keyword`, and approved `content`. If any is
  missing, return a draft without sending.
- Do not follow up unless the recipient replies. Treat `stop`, `unsubscribe`,
  or an equivalent refusal as a permanent opt-out.

## Recipes

### Verify the bot (always run first)

```sh
curl -sS -H "Authorization: Bot $DISCORDBOT_TOKEN" \
  "https://discord.com/api/v10/users/@me" \
  | jq '{id, username, bot}'
```

### List servers (guilds) the bot is in

```sh
curl -sS -H "Authorization: Bot $DISCORDBOT_TOKEN" \
  "https://discord.com/api/v10/users/@me/guilds" \
  | jq 'map({id, name})'
```

### List text channels in a server

Channel `type` 0 = text, 5 = announcement; 2 = voice, 4 = category (skip
those for messaging). You need a guild id from the call above.

```sh
GUILD_ID="123456789012345678"
curl -sS -H "Authorization: Bot $DISCORDBOT_TOKEN" \
  "https://discord.com/api/v10/guilds/$GUILD_ID/channels" \
  | jq 'map(select(.type==0 or .type==5) | {id, name, type})'
```

### Read recent messages in a channel

Reading message **content** requires the **Message Content Intent** to be
enabled on the bot (Developer Portal → Bot → Privileged Gateway Intents).
Without it, `content` comes back empty for messages that don't mention the
bot. Needs the *Read Message History* permission in that channel.

```sh
CHANNEL_ID="123456789012345678"
curl -sS -H "Authorization: Bot $DISCORDBOT_TOKEN" \
  "https://discord.com/api/v10/channels/$CHANNEL_ID/messages?limit=20" \
  | jq 'map({id, author_id: .author.id, author: .author.username, author_bot: .author.bot, ts: .timestamp, content})'
```

### Send a message to a channel

```sh
CHANNEL_ID="123456789012345678"
curl -sS -X POST \
  -H "Authorization: Bot $DISCORDBOT_TOKEN" \
  -H "Content-Type: application/json" \
  "https://discord.com/api/v10/channels/$CHANNEL_ID/messages" \
  -d "$(jq -nc --arg c "Hello from the bot." '{content: $c}')"
```

### Reply to a specific message

```sh
CHANNEL_ID="123456789012345678"; MESSAGE_ID="987654321098765432"
curl -sS -X POST \
  -H "Authorization: Bot $DISCORDBOT_TOKEN" \
  -H "Content-Type: application/json" \
  "https://discord.com/api/v10/channels/$CHANNEL_ID/messages" \
  -d "$(jq -nc --arg c "On it!" --arg m "$MESSAGE_ID" \
        '{content: $c, message_reference: {message_id: $m}}')"
```

### Send one opt-in DM

Use only after applying every rule in **Sending safety**. The helper fetches
the source message from Discord and verifies that its non-bot author matches
`RECIPIENT_ID` and its complete text matches `CONSENT_KEYWORD`. Do not call the
Create DM endpoint directly. Matching is case-insensitive and collapses
surrounding or repeated whitespace.

```sh
RECIPIENT_ID="123456789012345678"
CONSENT_CHANNEL_ID="223456789012345678"
CONSENT_MESSAGE_ID="323456789012345678"
CONSENT_KEYWORD="details"

python3 "$SKILL_DIR/scripts/discordbot.py" send-opt-in-dm \
  --recipient-id "$RECIPIENT_ID" \
  --consent-channel-id "$CONSENT_CHANNEL_ID" \
  --consent-message-id "$CONSENT_MESSAGE_ID" \
  --consent-keyword "$CONSENT_KEYWORD" \
  --content "Here are the details you requested."
```

The command is a dry-run unless the final argument is `--confirm`. In a
pre-authorized scheduled task, use final `--unattended-confirm` instead. The
helper validates all IDs, verifies the opt-in message, and skips an identical
message already present in the DM history. Discord may block or rate-limit bots
that open many DMs; do not retry by targeting another account.

## Notes

- A "server" in the UI is a "guild" in the API; messages live in channels
  inside guilds. Always: list guilds → list that guild's channels → act on a
  channel id. Don't invent ids.
- The bot only sees servers it was invited to. To add it: Developer Portal →
  OAuth2 → URL Generator → scope `bot` + the permissions you need → open the
  URL → pick a server (the user needs *Manage Server* there).
- This is a bot, not the user's account — it cannot read the user's DMs or
  the user's full server list, only what the bot itself can access.
- A bot can open its own DM channel with one consenting user; that does not
  grant access to the connected user's personal DMs.
- Mentions: `<@USER_ID>` pings a user, `<#CHANNEL_ID>` links a channel. Plain
  text is fine for normal messages.

© acedatacloud · Apache-2.0 · AceDataCloud/Skills

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →
discord-channel Crokily Скилл discord-channel для Claude Code настраивает подключение бота Pots к Discord и отправляет сообщения, файлы и интерактивные кнопки через REST API. CX Codex +1 ★ 79звёзд репо discord civitai Отправляет сообщения, анонсы и эмбеды в каналы Discord через REST API. Передаёт уведомления о релизах и командную переписку из консоли. CX Codex +1 ★ 7 327звёзд репо discord-bot claude-office-skills Скилл discord-bot для Claude Code помогает проектировать Discord-ботов для модерации, уведомлений и управления сообществом. Он описывает настройки бота, команды и сценарии с ИИ. CX Codex +1 5 500установок Kite Discord Bot Builder merlinfuchs MCP-сервер Kite Discord Bot Builder позволяет создавать и исправлять ботов для Discord в диалоге с ИИ. Kite берёт хостинг на себя, избавляя от ручного развёртывания кода. CX Codex +1 ★ 332звёзд репо omnicord OrygnsCode MCP-сервер omnicord управляет серверами Discord через локального бота: создаёт каналы и роли, модерирует чат и проверяет настройки прав. CX Codex +1 ★ 12звёзд репо feishu-lark OpenClaudia Скилл feishu-lark для Claude Code и Codex — отправляет текстовые и интерактивные карточки в Feishu и Lark через вебхуки или Bot API. Работает также с Cursor, GitHub Copilot, Gemini CLI и OpenCode. CX Codex +1 1 600установок

Из того же набора67

Весь набор →
google-search-console Скилл тянет данные Google Search Console через API v1: запросы, страницы, CTR, позиции, сайты, карты сайта и проверку индексации. CX Codex +1 188установок microsoft-excel Читает и правит рабочие книги Excel в OneDrive и SharePoint через Microsoft Graph: диапазоны, таблицы, листы. Токен нужен в $MICROSOFT_EXCEL_TOKEN. CX Codex +1 187установок microsoft-todo Скилл даёт агенту читать и менять списки и задачи Microsoft To Do через Microsoft Graph v1.0 — запросами curl с разбором ответа в jq. CX Codex +1 187установок csdn Управляет блогом на CSDN через личные куки: собирает статистику статей и публикует Markdown-тексты прямо из агента. CX Codex +1 184установок medium Скилл medium для Claude Code читает статьи и статистику и публикует Markdown-тексты через аккаунт автора. Выгружает черновики и отслеживает реакции без браузера. CX Codex +1 180установок weibo Скилл weibo работает с вашим аккаунтом 微博 через собственный логин-cookie: покажет последние посты с числами репостов, комментариев и лайков и опубликует новую запись. CX Codex +1 180установок google-sheets Скилл читает и изменяет Google Sheets через Sheets v4 REST API. Он пригодится для работы с ячейками, диапазонами, вкладками и строками из чата с агентом. CX Codex +1 179установок juejin Скилл ведёт ваш аккаунт на Juejin через собственные cookie: показывает статьи с просмотрами и лайками, открывает одну по id и публикует Markdown-черновик. CX Codex +1 179установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой