mper 1.1.1

Discord bot permission scanner - Analyzes discord.py code to detect required permissions and generate invite links

mper

Discord Bot Permission Scanner - discord.pyのコードを解析し、必要なパーミッションを検出して招待リンクを生成するツール。

特徴

機能	説明
メソッドベース検出	.ban(), .kick(), .send() などのメソッド呼び出しからBotパーミッションを自動推測
証拠トラッキング	どのファイルの何行目でどのパーミッションが必要かを表示
全49パーミッション対応	Discord APIの全パーミッションをサポート
コンテキスト認識	member.edit(nick=...) と member.edit(mute=...) を区別
デコレータサポート	@bot_has_permissions（補助）、@has_permissions（ユーザー要件のみ）
アップデート通知	新しいバージョンがリリースされた際にCLIで通知

インストール

pip install mper

使い方

CLI

# 基本的な使い方
mper /path/to/bot/directory CLIENT_ID

# 詳細レポート付き
mper /path/to/bot/directory CLIENT_ID --report

# 詳細出力
mper /path/to/bot/directory CLIENT_ID --verbose

# ディレクトリを除外
mper /path/to/bot/directory CLIENT_ID --exclude tests docs

# カスタムOAuth2スコープ
mper /path/to/bot/directory CLIENT_ID --scope bot --scope applications.commands

# プレーンテキスト出力（色なし）
mper /path/to/bot/directory CLIENT_ID --plain

CLIオプション

オプション	説明
--report	証拠付きの詳細パーミッションレポートを表示
--verbose, -v	スキャン中の詳細出力を表示
--no-inferred	デコレータからの宣言パーミッションのみ使用
--exclude	除外するディレクトリを追加
--scope	招待リンクのOAuth2スコープ（デフォルト: bot, applications.commands）
--output, -o	招待リンクの出力ファイル（デフォルト: bot_invite_url.txt）
--no-color	色付き出力を無効化
--plain	プレーンテキスト出力（スタイルなし）

ライブラリとして使用

import mper

# 簡単に招待URLを生成（CLIと同じ動作）
url = mper.generate_invite_url("./my_bot", client_id="123456789012345678")
print(url)

# 詳細なスキャン結果を取得
result = mper.scan_directory("./my_bot")
print(f"検出されたパーミッション: {result['invite_link_permissions']}")

# パーミッション名から整数値を計算
perm_int = mper.calculate_permission_integer({'send_messages', 'ban_members'})

# カスタム招待URLを作成
url = mper.create_invite_link(
    client_id="123456789012345678",
    permissions=perm_int,
    scopes=['bot', 'applications.commands']
)

詳細な使用例は examples/ を参照してください。

出力例

╭──────────────────────────────────────────────────╮
│  mper - Discord Bot Permission Scanner           │
╰──────────────────────────────────────────────────╯

Scanning: /path/to/bot
Scanned 5 files (0 with errors)

┌─────────────────────────────────────────────────┐
│ Detected Permissions (from method calls)        │
├─────────────────┬───────────┬───────────────────┤
│ Permission      │ Bit Value │ Evidence          │
├─────────────────┼───────────┼───────────────────┤
│ ban_members     │ 0x4       │ bot.py:15         │
│ manage_messages │ 0x2000    │ bot.py:25         │
│ send_messages   │ 0x800     │ bot.py:10, 20, 30 │
└─────────────────┴───────────┴───────────────────┘

╔══════════════════════════════════════════════════╗
║ 🔗 INVITE LINK                                   ║
╠══════════════════════════════════════════════════╣
║ https://discord.com/oauth2/authorize?...         ║
╚══════════════════════════════════════════════════╝

仕組み

┌─────────────────────────────────────────────────────────────┐
│                    mper スキャンプロセス                      │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  1. メソッドベース検出 (PRIMARY)                              │
│     Python AST解析 → discord.pyメソッド検出 → パーミッション推測 │
│     例: member.ban() → ban_members                          │
│                                                             │
│  2. @bot_has_permissions (SUPPLEMENTARY)                    │
│     明示的なBot権限宣言 → 招待リンクに追加                     │
│                                                             │
│  3. @has_permissions (REFERENCE ONLY)                       │
│     ユーザー権限要件 → レポートに表示のみ（招待リンクには不含）  │
│                                                             │
└─────────────────────────────────────────────────────────────┘

対応パーミッション

Discord APIの全49パーミッション（ビット0-46, 49-50）に対応しています。

詳細は Discord API Documentation を参照してください。

ライセンス

MIT License - 詳細は LICENSE を参照してください。

Issues

問題や要望がある場合は、適切なタグを付けてIssueを作成してください：

タグ	用途
bug	バグ報告
enhancement	機能要望
question	質問

クレジット

• 開発者: @FreeWiFi7749