Discord 智慧網址清理機器人 (Smart URL Cleaner)

一個簡單好用的 Discord 機器人，可以：

• 自動移除網址中的追蹤參數（utm_*、fbclid、gclid、Threads xmt 等）
• 跟隨短網址轉跳（例如 Facebook Reels /share/r/...）
• 支援斜線指令 /clean 與直接貼網址自動清理

功能特色

功能	說明
智慧清理	只移除已知追蹤參數，保留有用參數（如 YouTube 時間戳 t=）
自動轉跳	支援 Facebook Reels 等短網址
斜線指令	/clean url:...
自動偵測	頻道貼上網址就會自動回覆清理結果
多網址	一次最多處理 5 個網址

支援的追蹤參數（部分）

• UTM 系列：utm_source, utm_medium, utm_campaign...
• 社群 Click ID：fbclid, gclid, msclkid, ttclid...
• Threads：xmt, slof, hwta
• Facebook：rdid, share_url, mibextid
• 其他常見追蹤碼

安裝與使用

1. 建立 Discord 機器人

1. 前往 Discord Developer Portal
2. 建立 New Application → Bot → 複製 Token
3. 開啟 MESSAGE CONTENT INTENT
4. 在 OAuth2 → URL Generator 勾選 bot + applications.commands，並給予適當權限後邀請到伺服器

2. 安裝依賴

pip install -r requirements.txt

3. 設定 Token

推薦方式（環境變數）：

# Linux / macOS
export DISCORD_TOKEN="你的Token"

# Windows (PowerShell)
$env:DISCORD_TOKEN="你的Token"

或直接修改 bot.py 最後面的 token = "你的_BOT_TOKEN"（不建議公開分享時使用）。

4. 啟動

python bot.py

看到 已登入：... 與 同步了 1 個指令 即表示成功。

使用方式

• 斜線指令：/clean url:https://www.facebook.com/share/r/xxxx/
• 直接在頻道貼上網址，機器人會自動回覆清理後結果

限制說明

• Threads /share/ 短網址：部分連結因 Meta 反爬或需 JS 渲染，可能無法成功解析。建議改用「複製連結」拿到的完整網址。
• Facebook Reels 短網址：目前可正常轉跳並清理。
• 需要登入才能觀看的內容無法處理。

專案結構

discord-url-cleaner/
├── bot.py              # 主程式
├── requirements.txt    # 依賴
├── .gitignore
├── LICENSE             # MIT
└── README.md

授權

MIT License

更新日誌

v1.0.0 (2026-08-03)

• 初版發布
• 支援智慧清理追蹤參數
• 支援 Facebook Reels 短網址轉跳
• 斜線指令 + 自動偵測訊息中的網址