Discord Bot API 使用指南：通过 curl 管理频道、消息和服务器

discord by vm0-ai/vm0-skills

94 周安装量

51 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/vm0-ai/vm0-skills --skill discord

团队协作自动化 API

🇨🇳中文介绍

Discord Bot API

通过直接的 curl 调用使用 Discord Bot API 来管理频道、服务器、消息和用户。

官方文档：https://discord.com/developers/docs

使用时机

当你需要以下功能时，请使用此技能：

发送消息到特定频道
读取频道中的消息
管理频道（创建、编辑、删除）
获取服务器信息（服务器、成员、角色）
对消息做出反应并管理内容
以编程方式创建 webhook

对于简单的消息发布，请使用 discord-webhook 技能。

前提条件

1. 创建应用

前往 Discord 开发者门户
点击"New Application"并为其命名
进入"Bot"部分，点击"Add Bot"

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

3. 启用意图（如果需要）

在 Bot 部分，启用：

Presence Intent（用于用户状态）
Server Members Intent（用于成员列表）
Message Content Intent（用于读取消息）

4. 邀请 Bot 到服务器

进入 OAuth2 → URL Generator
选择作用域：bot，applications.commands
选择所需的权限（例如，发送消息、读取消息）
复制 URL 并在浏览器中打开以邀请

启用开发者模式：用户设置 → 高级 → 开发者模式右键点击任意频道/用户/服务器 → 复制 ID

基础 URL：https://discord.com/api/v10

授权请求头：Authorization: Bot YOUR_TOKEN

1. 获取当前 Bot 用户信息

curl -s "https://discord.com/api/v10/users/@me" -H "Authorization: Bot $(printenv DISCORD_BOT_TOKEN)" | jq '{id, username, discriminator}'

2. 发送消息到频道

写入 /tmp/discord_request.json：

{
  "content": "Hello from bot!"
}

然后运行（将 <your-channel-id> 替换为实际的频道 ID）：

curl -s -X POST "https://discord.com/api/v10/channels/<your-channel-id>/messages" -H "Authorization: Bot $(printenv DISCORD_BOT_TOKEN)" -H "Content-Type: application/json" -d @/tmp/discord_request.json

3. 发送嵌入消息

写入 /tmp/discord_request.json：

{
  "embeds": [
    {
      "title": "Bot Message",
      "description": "This is from the bot API",
      "color": 5793266
    }
  ]
}

然后运行（将 <your-channel-id> 替换为实际的频道 ID）：

curl -s -X POST "https://discord.com/api/v10/channels/<your-channel-id>/messages" -H "Authorization: Bot $(printenv DISCORD_BOT_TOKEN)" -H "Content-Type: application/json" -d @/tmp/discord_request.json

4. 获取频道信息

将 <your-channel-id> 替换为实际的频道 ID：

curl -s "https://discord.com/api/v10/channels/<your-channel-id>" -H "Authorization: Bot $(printenv DISCORD_BOT_TOKEN)" | jq '{id, name, type, guild_id}'

5. 获取频道消息

将 <your-channel-id> 替换为实际的频道 ID：

curl -s "https://discord.com/api/v10/channels/<your-channel-id>/messages?limit=10" -H "Authorization: Bot $(printenv DISCORD_BOT_TOKEN)" | jq '.[] | {id, author: .author.username, content}'

6. 获取特定消息

将 <your-channel-id> 和 <your-message-id> 替换为实际的 ID：

curl -s "https://discord.com/api/v10/channels/<your-channel-id>/messages/<your-message-id>" -H "Authorization: Bot $(printenv DISCORD_BOT_TOKEN)" | jq '{id, content, author: .author.username}'

将 <your-channel-id> 和 <your-message-id> 替换为实际的 ID：

curl -s -X DELETE "https://discord.com/api/v10/channels/<your-channel-id>/messages/<your-message-id>" -H "Authorization: Bot $(printenv DISCORD_BOT_TOKEN)"

将 <your-channel-id> 和 <your-message-id> 替换为实际的 ID：

curl -s -X PUT "https://discord.com/api/v10/channels/<your-channel-id>/messages/<your-message-id>/reactions/%F0%9F%91%8D/@me" -H "Authorization: Bot $(printenv DISCORD_BOT_TOKEN)" -H "Content-Length: 0"

注意：表情符号必须进行 URL 编码（👍 = %F0%9F%91%8D）

9. 获取服务器信息

将 <your-guild-id> 替换为实际的服务器 ID：

curl -s "https://discord.com/api/v10/guilds/<your-guild-id>" -H "Authorization: Bot $(printenv DISCORD_BOT_TOKEN)" | jq '{id, name, member_count, owner_id}'

10. 列出服务器频道

将 <your-guild-id> 替换为实际的服务器 ID：

curl -s "https://discord.com/api/v10/guilds/<your-guild-id>/channels" -H "Authorization: Bot $(printenv DISCORD_BOT_TOKEN)" | jq '.[] | {id, name, type}'

11. 获取服务器成员

将 <your-guild-id> 替换为实际的服务器 ID：

curl -s "https://discord.com/api/v10/guilds/<your-guild-id>/members?limit=10" -H "Authorization: Bot $(printenv DISCORD_BOT_TOKEN)" | jq '.[] | {user: .user.username, nick, joined_at}'

12. 获取服务器角色

将 <your-guild-id> 替换为实际的服务器 ID：

curl -s "https://discord.com/api/v10/guilds/<your-guild-id>/roles" -H "Authorization: Bot $(printenv DISCORD_BOT_TOKEN)" | jq '.[] | {id, name, color, position}'

写入 /tmp/discord_request.json：

{
  "name": "My Webhook"
}

然后运行（将 <your-channel-id> 替换为实际的频道 ID）：

curl -s -X POST "https://discord.com/api/v10/channels/<your-channel-id>/webhooks" -H "Authorization: Bot $(printenv DISCORD_BOT_TOKEN)" -H "Content-Type: application/json" -d @/tmp/discord_request.json | jq '{id, token, url: "https://discord.com/api/webhooks/\(.id)/\(.token)"}'

14. 列出频道 Webhook

将 <your-channel-id> 替换为实际的频道 ID：

curl -s "https://discord.com/api/v10/channels/<your-channel-id>/webhooks" -H "Authorization: Bot $(printenv DISCORD_BOT_TOKEN)" | jq '.[] | {id, name, token}'

15. 创建文本频道

写入 /tmp/discord_request.json：

{
  "name": "new-channel",
  "type": 0
}

然后运行（将 <your-guild-id> 替换为实际的服务器 ID）：

curl -s -X POST "https://discord.com/api/v10/guilds/<your-guild-id>/channels" -H "Authorization: Bot $(printenv DISCORD_BOT_TOKEN)" -H "Content-Type: application/json" -d @/tmp/discord_request.json | jq '{id, name}'

类型	描述
0	文本频道
2	语音频道
4	分类
5	公告频道
13	舞台频道
15	论坛频道

速率限制：检查 X-RateLimit-* 请求头；实现退避机制
Token 安全：切勿暴露 bot token
权限：Bot 需要每个操作的适当权限
意图：在开发者门户中启用所需的意图
API 版本：使用 /v10 获取最新的稳定 API

🇺🇸English

Discord Bot API

Use the Discord Bot API via direct curl calls to manage channels, guilds, messages, and users.

Official docs: https://discord.com/developers/docs

When to Use

Use this skill when you need to:

Send messages to specific channels
Read messages from channels
Manage channels (create, edit, delete)
Get server info (guilds, members, roles)
React to messages and moderate content
Create webhooks programmatically

For simple message posting, use discord-webhook skill instead.

Prerequisites

1. Create Application

Go to Discord Developer Portal
Click "New Application" and give it a name
Go to "Bot" section and click "Add Bot"

2. Get Bot Token

In Bot section, click "Reset Token"
Copy the token (shown only once)

export DISCORD_BOT_TOKEN="MTIzNDU2Nzg5MDEyMzQ1Njc4OQ.ABcDeF.xxxxx..."

3. Enable Intents (if needed)

In Bot section, enable:

Presence Intent (for user status)
Server Members Intent (for member list)
Message Content Intent (for reading messages)

4. Invite Bot to Server

Go to OAuth2 → URL Generator
Select scopes: bot, applications.commands
Select permissions needed (e.g., Send Messages, Read Messages)
Copy URL and open in browser to invite

5. Get IDs

Enable Developer Mode: User Settings → Advanced → Developer Mode Right-click any channel/user/server → Copy ID

How to Use

Base URL: https://discord.com/api/v10

Authorization header: Authorization: Bot YOUR_TOKEN

1. Get Current Bot User

curl -s "https://discord.com/api/v10/users/@me" -H "Authorization: Bot $(printenv DISCORD_BOT_TOKEN)" | jq '{id, username, discriminator}'

2. Send Message to Channel

Write to /tmp/discord_request.json:

{
  "content": "Hello from bot!"
}

Then run (replace <your-channel-id> with the actual channel ID):

curl -s -X POST "https://discord.com/api/v10/channels/<your-channel-id>/messages" -H "Authorization: Bot $(printenv DISCORD_BOT_TOKEN)" -H "Content-Type: application/json" -d @/tmp/discord_request.json

3. Send Embed Message

Write to /tmp/discord_request.json:

{
  "embeds": [
    {
      "title": "Bot Message",
      "description": "This is from the bot API",
      "color": 5793266
    }
  ]
}

Then run (replace <your-channel-id> with the actual channel ID):

curl -s -X POST "https://discord.com/api/v10/channels/<your-channel-id>/messages" -H "Authorization: Bot $(printenv DISCORD_BOT_TOKEN)" -H "Content-Type: application/json" -d @/tmp/discord_request.json

4. Get Channel Info

Replace <your-channel-id> with the actual channel ID:

curl -s "https://discord.com/api/v10/channels/<your-channel-id>" -H "Authorization: Bot $(printenv DISCORD_BOT_TOKEN)" | jq '{id, name, type, guild_id}'

5. Get Channel Messages

Replace <your-channel-id> with the actual channel ID:

curl -s "https://discord.com/api/v10/channels/<your-channel-id>/messages?limit=10" -H "Authorization: Bot $(printenv DISCORD_BOT_TOKEN)" | jq '.[] | {id, author: .author.username, content}'

6. Get Specific Message

Replace <your-channel-id> and <your-message-id> with the actual IDs:

curl -s "https://discord.com/api/v10/channels/<your-channel-id>/messages/<your-message-id>" -H "Authorization: Bot $(printenv DISCORD_BOT_TOKEN)" | jq '{id, content, author: .author.username}'

7. Delete Message

Replace <your-channel-id> and <your-message-id> with the actual IDs:

curl -s -X DELETE "https://discord.com/api/v10/channels/<your-channel-id>/messages/<your-message-id>" -H "Authorization: Bot $(printenv DISCORD_BOT_TOKEN)"

8. Add Reaction

Replace <your-channel-id> and <your-message-id> with the actual IDs:

curl -s -X PUT "https://discord.com/api/v10/channels/<your-channel-id>/messages/<your-message-id>/reactions/%F0%9F%91%8D/@me" -H "Authorization: Bot $(printenv DISCORD_BOT_TOKEN)" -H "Content-Length: 0"

Note: Emoji must be URL encoded (👍 = %F0%9F%91%8D)

9. Get Guild (Server) Info

Replace <your-guild-id> with the actual guild ID:

curl -s "https://discord.com/api/v10/guilds/<your-guild-id>" -H "Authorization: Bot $(printenv DISCORD_BOT_TOKEN)" | jq '{id, name, member_count, owner_id}'

10. List Guild Channels

Replace <your-guild-id> with the actual guild ID:

curl -s "https://discord.com/api/v10/guilds/<your-guild-id>/channels" -H "Authorization: Bot $(printenv DISCORD_BOT_TOKEN)" | jq '.[] | {id, name, type}'

11. Get Guild Members

Replace <your-guild-id> with the actual guild ID:

curl -s "https://discord.com/api/v10/guilds/<your-guild-id>/members?limit=10" -H "Authorization: Bot $(printenv DISCORD_BOT_TOKEN)" | jq '.[] | {user: .user.username, nick, joined_at}'

12. Get Guild Roles

Replace <your-guild-id> with the actual guild ID:

curl -s "https://discord.com/api/v10/guilds/<your-guild-id>/roles" -H "Authorization: Bot $(printenv DISCORD_BOT_TOKEN)" | jq '.[] | {id, name, color, position}'

13. Create Webhook

Write to /tmp/discord_request.json:

{
  "name": "My Webhook"
}

Then run (replace <your-channel-id> with the actual channel ID):

curl -s -X POST "https://discord.com/api/v10/channels/<your-channel-id>/webhooks" -H "Authorization: Bot $(printenv DISCORD_BOT_TOKEN)" -H "Content-Type: application/json" -d @/tmp/discord_request.json | jq '{id, token, url: "https://discord.com/api/webhooks/\(.id)/\(.token)"}'

14. List Channel Webhooks

Replace <your-channel-id> with the actual channel ID:

curl -s "https://discord.com/api/v10/channels/<your-channel-id>/webhooks" -H "Authorization: Bot $(printenv DISCORD_BOT_TOKEN)" | jq '.[] | {id, name, token}'

15. Create Text Channel

Write to /tmp/discord_request.json:

{
  "name": "new-channel",
  "type": 0
}

Then run (replace <your-guild-id> with the actual guild ID):

curl -s -X POST "https://discord.com/api/v10/guilds/<your-guild-id>/channels" -H "Authorization: Bot $(printenv DISCORD_BOT_TOKEN)" -H "Content-Type: application/json" -d @/tmp/discord_request.json | jq '{id, name}'

Channel Types

Type	Description
0	Text channel
2	Voice channel
4	Category
5	Announcement
13	Stage
15	Forum

Guidelines

Rate limits : Check X-RateLimit-* headers; implement backoff
Token security : Never expose bot tokens
Permissions : Bot needs appropriate permissions for each action
Intents : Enable required intents in Developer Portal
API version : Use /v10 for latest stable API

Weekly Installs

Repository

vm0-ai/vm0-skills

GitHub Stars

First Seen

Jan 24, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykWarn

Installed on

opencode80

gemini-cli79

codex77

github-copilot74

cursor74

amp73

通过 LiteLLM 代理让 Claude Code 对接 GitHub Copilot 运行 | 高级变通方案指南

43,100 周安装

Discord Bot API 使用指南：通过 curl 管理频道、消息和服务器

🇨🇳中文介绍

Discord Bot API

使用时机

前提条件

1. 创建应用

相关 Skills

2. 获取 Bot Token

3. 启用意图（如果需要）

4. 邀请 Bot 到服务器

5. 获取 ID

使用方法

1. 获取当前 Bot 用户信息

2. 发送消息到频道

3. 发送嵌入消息

4. 获取频道信息

5. 获取频道消息

6. 获取特定消息

7. 删除消息

8. 添加反应

9. 获取服务器信息

10. 列出服务器频道

11. 获取服务器成员

12. 获取服务器角色

13. 创建 Webhook

14. 列出频道 Webhook

15. 创建文本频道

频道类型

指导原则

🇺🇸English

Discord Bot API

When to Use

Prerequisites

1. Create Application

2. Get Bot Token

3. Enable Intents (if needed)

4. Invite Bot to Server

5. Get IDs

How to Use

1. Get Current Bot User

2. Send Message to Channel

3. Send Embed Message

4. Get Channel Info

5. Get Channel Messages

6. Get Specific Message

7. Delete Message

8. Add Reaction

9. Get Guild (Server) Info

10. List Guild Channels

11. Get Guild Members

12. Get Guild Roles

13. Create Webhook

14. List Channel Webhooks

15. Create Text Channel

Channel Types

Guidelines

最新 Skills