Discordボット開発#32サーバーログ・監査ログ(Audit Log)チャンネルを作ろう！メッセージの削除・編集・入退室・キックまで自動記録(Pythonサンプル) 🕵️

pip install -U discord.py python-dotenv

token=여기에_봇_토큰

# discord.py 2.7.1 / Python 3.9+ / python-dotenv 1.x
import os
import json
import asyncio

import discord
from discord import app_commands
from discord.ext import commands
from dotenv import load_dotenv

load_dotenv()
token = os.getenv("token")

CONFIG_FILE = "log_config.json"   # {サーバーID(str): ログチャンネルID(int)}
MAX_CONTENT = 1000                # 埋め込みフィールドは最大1024文字 → 余裕をもって切る

intents = discord.Intents.default()
intents.message_content = True   # 削除されたメッセージの「内容」を見るには必須(特権インテント)
intents.members = True           # 入退室・ニックネーム・ロール変更の検知(特権インテント)
intents.moderation = True        # キック・BAN + 監査ログイベント

bot = commands.Bot(command_prefix="!", intents=intents, max_messages=5000)

log_channels: dict[str, int] = {}
lock = asyncio.Lock()

def save():
    with open(CONFIG_FILE, "w", encoding="utf-8") as f:
        json.dump(log_channels, f, ensure_ascii=False, indent=2)


def load():
    global log_channels
    if os.path.exists(CONFIG_FILE):
        with open(CONFIG_FILE, encoding="utf-8") as f:
            log_channels = json.load(f)


def get_log_channel(guild: discord.Guild):
    cid = log_channels.get(str(guild.id))
    return guild.get_channel(cid) if cid else None


def make_embed(title: str, color: discord.Color, user=None) -> discord.Embed:
    embed = discord.Embed(title=title, color=color, timestamp=discord.utils.utcnow())
    if user is not None:
        embed.set_author(name=f"{user} ({user.id})", icon_url=user.display_avatar.url)
    return embed


async def send_log(guild: discord.Guild, embed: discord.Embed):
    channel = get_log_channel(guild)
    if channel is None:
        return
    try:
        await channel.send(embed=embed)
    except discord.Forbidden:
        print(f"⚠️ {guild.name}: ログチャンネルにメッセージを送信する権限がありません。")


def cut(text: str) -> str:
    text = text or "(内容なし — 埋め込み/添付ファイルのみ、またはキャッシュにない)"
    return text if len(text) <= MAX_CONTENT else text[:MAX_CONTENT] + " …(省略)"

async def find_deleter(guild: discord.Guild, author_id: int, channel_id: int):
    """監査ログから「たった今この人のメッセージをこのチャンネルで削除した管理者」を探します。"""
    try:
        async for entry in guild.audit_logs(limit=5, action=discord.AuditLogAction.message_delete):
            same_target = entry.target is not None and entry.target.id == author_id
            same_channel = entry.extra.channel.id == channel_id
            recent = (discord.utils.utcnow() - entry.created_at).total_seconds() < 15
            if same_target and same_channel and recent:
                return entry.user
    except discord.Forbidden:
        return None
    return None


@bot.event
async def on_raw_message_delete(payload: discord.RawMessageDeleteEvent):
    if payload.guild_id is None:      # DMは無視
        return
    guild = bot.get_guild(payload.guild_id)
    msg = payload.cached_message

    embed = make_embed("🗑️ メッセージ削除", discord.Color.red(), msg.author if msg else None)
    embed.add_field(name="チャンネル", value=f"<#{payload.channel_id}>", inline=True)

    if msg is None:
        embed.add_field(name="内容", value="キャッシュにないメッセージです(ボット起動前のメッセージ)", inline=False)
        embed.set_footer(text=f"メッセージID: {payload.message_id}")
    else:
        if msg.author.bot:
            return
        deleter = await find_deleter(guild, msg.author.id, payload.channel_id)
        who = deleter.mention if deleter else "本人(または確認できず)"
        embed.add_field(name="削除した人", value=who, inline=True)
        embed.add_field(name="内容", value=cut(msg.content), inline=False)
        if msg.attachments:
            files = "\n".join(a.filename for a in msg.attachments)
            embed.add_field(name="添付ファイル", value=files, inline=False)
        embed.set_footer(text=f"メッセージID: {msg.id}")

    await send_log(guild, embed)


@bot.event
async def on_raw_message_edit(payload: discord.RawMessageUpdateEvent):
    if payload.guild_id is None:
        return
    before = payload.cached_message
    after = payload.message
    if before is None or after.author.bot:
        return
    if before.content == after.content:      # 埋め込みプレビュー生成などの「偽の編集」を除外
        return

    guild = bot.get_guild(payload.guild_id)
    embed = make_embed("✏️ メッセージ編集", discord.Color.orange(), after.author)
    embed.add_field(name="チャンネル", value=after.channel.mention, inline=True)
    embed.add_field(name="リンク", value=f"[メッセージへ移動]({after.jump_url})", inline=True)
    embed.add_field(name="編集前", value=cut(before.content), inline=False)
    embed.add_field(name="編集後", value=cut(after.content), inline=False)
    await send_log(guild, embed)


@bot.event
async def on_raw_bulk_message_delete(payload: discord.RawBulkMessageDeleteEvent):
    if payload.guild_id is None:
        return
    guild = bot.get_guild(payload.guild_id)
    embed = make_embed("🧹 メッセージ一括削除", discord.Color.dark_red())
    embed.add_field(name="チャンネル", value=f"<#{payload.channel_id}>", inline=True)
    embed.add_field(name="件数", value=f"{len(payload.message_ids)}件", inline=True)
    await send_log(guild, embed)

@bot.event
async def on_member_join(member: discord.Member):
    embed = make_embed("📥 メンバー参加", discord.Color.green(), member)
    embed.add_field(name="メンバー", value=member.mention, inline=True)
    embed.add_field(name="アカウント作成日", value=discord.utils.format_dt(member.created_at, "R"), inline=True)
    embed.add_field(name="現在の人数", value=f"{member.guild.member_count}人", inline=True)
    await send_log(member.guild, embed)


@bot.event
async def on_member_remove(member: discord.Member):
    embed = make_embed("📤 メンバー退出", discord.Color.light_grey(), member)
    embed.add_field(name="メンバー", value=f"{member} ({member.mention})", inline=True)
    if member.joined_at:
        embed.add_field(name="参加日", value=discord.utils.format_dt(member.joined_at, "R"), inline=True)
    roles = [r.mention for r in member.roles if r != member.guild.default_role]
    if roles:
        embed.add_field(name="持っていたロール", value=" ".join(roles), inline=False)
    await send_log(member.guild, embed)


@bot.event
async def on_member_update(before: discord.Member, after: discord.Member):
    if before.nick != after.nick:
        embed = make_embed("🏷️ ニックネーム変更", discord.Color.blue(), after)
        embed.add_field(name="変更前", value=before.nick or "(なし)", inline=True)
        embed.add_field(name="変更後", value=after.nick or "(なし)", inline=True)
        await send_log(after.guild, embed)

    added = [r for r in after.roles if r not in before.roles]
    removed = [r for r in before.roles if r not in after.roles]
    if added or removed:
        embed = make_embed("🎭 ロール変更", discord.Color.blurple(), after)
        if added:
            embed.add_field(name="➕ 追加", value=" ".join(r.mention for r in added), inline=False)
        if removed:
            embed.add_field(name="➖ 削除", value=" ".join(r.mention for r in removed), inline=False)
        await send_log(after.guild, embed)

MOD_ACTIONS = {
    discord.AuditLogAction.kick: ("👢 キック(Kick)", discord.Color.dark_orange()),
    discord.AuditLogAction.ban: ("🔨 BAN(Ban)", discord.Color.dark_red()),
    discord.AuditLogAction.unban: ("🕊️ BAN解除(Unban)", discord.Color.teal()),
}


@bot.event
async def on_audit_log_entry_create(entry: discord.AuditLogEntry):
    if entry.action not in MOD_ACTIONS:
        return
    title, color = MOD_ACTIONS[entry.action]
    embed = make_embed(title, color, entry.user)
    target = entry.target
    embed.add_field(name="対象", value=f"{target} (<@{target.id}>)" if target else "(不明)", inline=True)
    embed.add_field(name="実行者", value=entry.user.mention if entry.user else "(不明)", inline=True)
    embed.add_field(name="理由", value=entry.reason or "(理由なし)", inline=False)
    await send_log(entry.guild, embed)

@bot.event
async def on_guild_channel_create(channel: discord.abc.GuildChannel):
    embed = make_embed("📁 チャンネル作成", discord.Color.green())
    embed.add_field(name="チャンネル", value=f"{channel.mention} (`{channel.name}`)", inline=True)
    embed.add_field(name="種類", value=str(channel.type), inline=True)
    await send_log(channel.guild, embed)


@bot.event
async def on_guild_channel_delete(channel: discord.abc.GuildChannel):
    embed = make_embed("🗂️ チャンネル削除", discord.Color.red())
    embed.add_field(name="チャンネル", value=f"`{channel.name}`", inline=True)
    embed.add_field(name="種類", value=str(channel.type), inline=True)
    await send_log(channel.guild, embed)


@bot.tree.command(name="로그설정", description="[管理者] サーバーログを送るチャンネルを設定します")
@app_commands.describe(채널="ログが溜まっていくテキストチャンネル")
@app_commands.checks.has_permissions(administrator=True)
async def set_log(interaction: discord.Interaction, 채널: discord.TextChannel):
    me = interaction.guild.me
    perms = 채널.permissions_for(me)
    if not (perms.send_messages and perms.embed_links):
        return await interaction.response.send_message(
            f"❌ {채널.mention}に**メッセージを送信・埋め込みリンク**の権限がありません。", ephemeral=True)
    async with lock:
        log_channels[str(interaction.guild.id)] = 채널.id
        save()
    await interaction.response.send_message(f"✅ これからサーバーログを{채널.mention}に記録します！", ephemeral=True)
    await 채널.send(embed=make_embed("🟢 ログチャンネルに設定されました", discord.Color.green(), interaction.user))


@bot.tree.command(name="로그해제", description="[管理者] サーバーログの記録を停止します")
@app_commands.checks.has_permissions(administrator=True)
async def unset_log(interaction: discord.Interaction):
    async with lock:
        log_channels.pop(str(interaction.guild.id), None)
        save()
    await interaction.response.send_message("⏹️ ログの記録をオフにしました。", ephemeral=True)


@bot.tree.error
async def on_app_command_error(interaction: discord.Interaction, error: app_commands.AppCommandError):
    if isinstance(error, app_commands.MissingPermissions):
        await interaction.response.send_message("❌ 管理者だけが使えるコマンドです。", ephemeral=True)
    else:
        raise error


@bot.event
async def on_ready():
    load()
    await bot.tree.sync()
    print(f"✅ ログイン: {bot.user} / ログ設定済みのサーバー {len(log_channels)}個")


bot.run(token)

discord.AuditLogAction.member_update: ("⏳ タイムアウト/ニックネーム変更", discord.Color.gold()),
discord.AuditLogAction.role_create: ("🎨 ロール作成", discord.Color.green()),
discord.AuditLogAction.role_delete: ("🎨 ロール削除", discord.Color.red()),
discord.AuditLogAction.message_bulk_delete: ("🧹 一括削除(管理者)", discord.Color.dark_red()),