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