Tickets Hunter 搶票機器人 🎫
📖 前言：因原專案 MaxBot作者 max32002/tixcraft_bot 已停止更新，本專案為後續延伸產品
🎯 目標：讓一般民眾與代購黃牛有相同的起跑線，用魔法對抗魔法；各位都能順利搶到大巨蛋棒球票！
🚨 嚴正警告：使用本程式當黃牛或有任何加價轉售牟利行為，本人代表各粉絲祝福您，早生貴子胎胎都三胞胎！本程式僅供個人合法使用，嚴禁商業牟利。
💬 需要協助或回報問題？
- 💬 加入 Discord 社群 - 即時討論、問答交流、經驗分享
- 🐛 回報 Bug - 確定是程式錯誤請開 Issue
- 🚀 提出新功能建議 - 想要新功能請點這裡
- 💬 查看已知問題 - 搜尋是否有人遇到相同問題
- 📝 更新紀錄 - 查看版本更新歷史
📋 專案概述
Tickets Hunter 是一個開放原始碼的多平台搶票自動化系統，支援台灣及海外主要票務網站。
🤖 技術特色：本專案是一項 AI 輔助軟體工程實驗 — 主要透過自然語言指令與 Claude Code 及 Codex 協作進行開發、除錯與維護，不手寫任何程式碼。從架構設計、功能實作到 PR 審查，皆由 AI 協助完成。
🔬 對 AI 開發有興趣？ 歡迎 Fork 本專案，嘗試使用不同的 AI / LLM 工具（如 Claude Code、Codex、GitHub Copilot、Cursor、Windsurf、Cline 等）進行開發與研究學習，探索各種 AI 輔助開發的可能性！
🎪 平台支援狀態
✅ NoDriver 完全支援：TixCraft、Teamear、TicketMaster、Indievox、KKTIX、TicketPlus、iBon、年代售票、寬宏售票、Cityline 買飛、HKTicketing 快達票、KHAM、FamiTicket、FANSI GO、FunOne
⚖️ 法律聲明
🚨 重要提醒：本軟體僅供教育研究用途，使用者需自行承擔法律責任。
作者沒有意圖要他人購得的票券進行加價轉售或使用在違法事情上。使用此程式即表示您同意法律聲明。
📍 台灣地區重要法規告知：
第 10-1 條 （法規來源）
政府應致力於保障民眾近用文化創意活動之權益，確保藝文表演票券正常流通。
第二項：將藝文表演票券以超過票面金額或定價販售者，按票券張數，由主管機關處票面金額或定價之十倍至五十倍罰鍰。
第三項：以虛偽資料或其他不正方式，利用電腦或其他相關設備購買藝文表演票券，取得訂票或取票憑證者，處三年以下有期徒刑，或科或併科新臺幣三百萬元以下罰金。
第四項：主管機關為調查或取締前二項違規事實，得洽請警察機關派員協助。
第五項：主管機關對於檢舉查獲第二項、第三項規定之行為，除應對檢舉人身分資料嚴守秘密外，並得酌予獎勵。對於檢舉人身分資料之保密，於訴訟程序，亦同。
第六項：前項主管機關受理檢舉案件之管轄、處理期間、保密、檢舉人獎勵及其他應遵行事項之辦法，由中央主管機關定之。
⚠️ 台灣地區適用範圍說明：
❌ 禁止用於文創法涵蓋之文化創意產業票券：
- 🎭 音樂及表演藝術：演唱會、音樂劇、舞台劇、戲劇、舞蹈表演等
- 🎨 視覺藝術：美術展覽、藝術博覽會等
- 🏛️ 文化資產應用及展演設施：博物館、展覽館特展等
- 🎬 電影產業：電影首映會、影展等
- 🎵 流行音樂及文化內容：演唱會、音樂節等
- 📺 廣播電視產業：電視節目錄製、廣播活動等
- 🎪 創意生活產業：文創市集、藝術節慶等
- 📱 數位內容產業：遊戲展、動漫展等
- 其他文創法第3條所列15項產業相關活動
✅ 適用範圍：
- 🏀 體育競技：職棒、職籃、桌球、網球、足球等純體育賽事
- 🚌 交通運輸：高鐵、台鐵、客運、捷運等交通票券
- ✈️ 旅遊服務：機票、飯店、遊樂園等旅遊票券
- 🏢 商業活動：商展、會議、講座等非文創商業活動
- 🌍 海外活動：非台灣地區舉辦之各類活動票券
使用原則：
- 勿以身試法，了解當地法規
- 不得用於商業牟利或惡意囤票
- 尊重售票平台使用條款
🚀 快速開始
📖 完整教學請參閱 使用者手冊
| 使用方式 | 適用對象 | 教學連結 |
|---|---|---|
| 🟢 執行檔版本 | 一般使用者（推薦） | 安裝與首次執行 |
| 🔴 Python 原始碼 | 開發者、進階使用者 | 快速入門指南 |
最簡步驟
執行檔版本：下載 → 解壓縮 → 雙擊 settings.exe → 設定 → 搶票
Python 版本：pip install -r requirement.txt → python src/settings.py → 設定 → 搶票
📚 使用者手冊
📖 完整使用者手冊入口 - 所有教學文件的統一入口
| 文件 | 說明 | 適用對象 |
|---|---|---|
| 安裝與首次執行 | 執行檔版本完整教學 | 一般使用者 |
| 快速入門指南 | Python 版本快速設定 | 開發者 |
| 關鍵字與回退機制 | 深入理解搶票邏輯 | 所有使用者 |
| 詳細設定說明 | settings.json 完整欄位參考 | 進階使用者 |
🏗️ 專案架構
tickets_hunter/
├── 📦 src/ # 原始碼目錄
│ ├── 🎯 核心搶票引擎
│ │ ├── nodriver_tixcraft.py # 主迴圈與 URL 路由（zendriver）
│ │ ├── nodriver_common.py # 共用瀏覽器基礎設施（DOM 工具、Cloudflare）
│ │ ├── platforms/ # 各平台獨立模組
│ │ │ ├── tixcraft.py # TixCraft / TicketMaster / Teamear / Indievox
│ │ │ ├── kktix.py # KKTIX
│ │ │ ├── ibon.py # iBon / 年代售票
│ │ │ ├── ticketplus.py # TicketPlus
│ │ │ ├── famiticket.py # FamiTicket
│ │ │ ├── kham.py # 寬宏售票
│ │ │ ├── fansigo.py # FANSI GO
│ │ │ ├── cityline.py # Cityline 買飛
│ │ │ ├── hkticketing.py # HKTicketing 快達票
│ │ │ ├── funone.py # FunOne
│ │ │ └── facebook.py # Facebook 登入輔助
│ │ └── util.py # 純工具函式（文字比對、關鍵字解析、DebugLogger）
│ ├── ⚙️ 設定介面
│ │ └── settings.py # 現代網頁設定介面
│ ├── 📋 設定檔
│ │ └── settings.json # 主要設定檔 (搶票參數)
│ ├── 🌐 網頁介面 # Web UI 資源
│ │ └── www/
│ │ ├── settings.html # 設定介面前端
│ │ ├── settings.js # 前端互動邏輯
│ │ ├── css/ # 樣式表
│ │ ├── dist/ # 編譯後檔案
│ │ └── icons/ # 圖示資源
│ └── 🔧 輔助工具
│ ├── NonBrowser.py # 非瀏覽器模式處理
│ └── assets/ # 資源檔案
│ └── sounds/ # 音效檔
└── 📋 專案資訊
├── README.md # 專案說明文件
├── CONTRIBUTING.md # 貢獻指南
├── LEGAL_NOTICE.md # 法律聲明
├── LICENSE # 授權條款
└── requirement.txt # Python 相依套件
⭐ Star History
📄 授權條款
本專案採用 GNU GPL 授權，遵循開源精神。使用時請遵守：
- 保持開源授權條款
- 標註原作者資訊
- 不得用於商業牟利
祝您搶票成功！ 🎉