PTT Alertor 使用指南：從安裝到進階設定，助你不再錯過關鍵資訊！
PTT (Professional Technology Template) 是台灣最大的網路論壇之一，每天產生海量的資訊。然而，長時間瀏覽 PTT 並非效率最高的獲取資訊方式。PTT Alertor 應運而生，它是一個可以監控 PTT 特定關鍵字，並透過各種管道 (例如：手機簡訊、Telegram、Email) 提醒你的工具。本文將深入淺出地介紹 PTT Alertor 的使用方法，從安裝、基本設定到進階技巧，幫助你輕鬆掌握 PTT 上重要的資訊。
什麼是 PTT Alertor？為什麼需要它？
PTT Alertor 是一個開源的 PTT 監視工具。簡單來說，它就像一個「關鍵字警報器」，你可以設定想要追蹤的關鍵字，Alertor 會持續監控 PTT 的文章，當出現包含該關鍵字的帖子時，就會立即透過你設定的管道通知你。
為什麼需要 PTT Alertor？
- 節省時間： 無需長時間瀏覽 PTT，就能掌握關鍵資訊。
- 即時性： 快速接收警報，不錯過任何重要消息。
- 客製化： 可以根據自己的需求設定關鍵字、通知方式和過濾條件。
- 多元管道： 支持簡訊、Telegram、Email等多種通知方式，方便選擇。
- 追蹤特定話題： 追蹤股價、新聞事件、特定品牌或產品等。
準備工作：系統需求與安裝
在使用 PTT Alertor 之前，你需要先準備好相關的環境。
系統需求：
- 作業系統： Linux (建議使用 Debian 或 Ubuntu)、macOS、Windows (需要使用 WSL)
- Python： 3.6 或以上版本
- PHP： 7.4 或以上版本 (部分功能需要)
- Composer： PHP 的依賴管理工具
- Git： 版本控制工具
安裝步驟 (以 Linux 為例 – Debian/Ubuntu)：
-
更新系統：
bash sudo apt update && sudo apt upgrade -
安裝必要的套件：
bash sudo apt install python3 python3-pip php php-cli git -
安裝 Composer：
bash curl -sS https://getcomposer.org/installer | php sudo mv composer.phar /usr/local/bin/composer -
克隆 PTT Alertor 儲存庫：
bash git clone https://github.com/yichengchen/pttalertor.git cd pttalertor -
安裝 PHP 依賴：
bash composer install -
設定環境變數： (這部分很重要，請仔細設定！)
-
編輯
config.php檔案，設定 PTT 帳號、密碼、以及通知方式等參數。 -
PTT_USERNAME: 你的 PTT 帳號 -
PTT_PASSWORD: 你的 PTT 密碼 -
ALERT_METHOD: 通知方式 (sms, telegram, email) -
SMS_API_KEY: 簡訊 API 金鑰 (如果使用簡訊通知) -
TELEGRAM_BOT_TOKEN: Telegram Bot Token (如果使用 Telegram 通知) -
TELEGRAM_CHAT_ID: Telegram Chat ID (如果使用 Telegram 通知) -
EMAIL_ADDRESS: Email 地址 (如果使用 Email 通知) -
EMAIL_PASSWORD: Email 密碼 (如果使用 Email 通知) -
設定 Cron Job (自動執行)：
bash crontab -e在 crontab 中加入以下行，設定定期執行 Alertor 的腳本 (例如每 5 分鐘執行一次)：*/5 * * * * php /path/to/pttalertor/alert.php >> /path/to/pttalertor/log.txt 2>&1(請將/path/to/pttalertor替換成你實際的 PTT Alertor 安裝路徑)
安裝其他系統： 可以參考 PTT Alertor 的官方 GitHub 儲存庫，裡面有針對 macOS 和 Windows (WSL) 的詳細安裝說明。 https://github.com/yichengchen/pttalertor
基本設定：關鍵字設定與通知方式
安裝完成後，就可以開始設定關鍵字和通知方式了。
關鍵字設定：
-
編輯
keyword.txt檔案，每行輸入一個關鍵字，例如：台積電 iPhone 15 新冠肺炎你可以根據自己的需求設定多個關鍵字。 -
可以使用正規表達式 (Regular Expression) 來設定更複雜的關鍵字模式。例如，要追蹤所有包含 "AAPL" 或 "Apple" 的文章，可以使用
AAPL|Apple。
通知方式設定：
在
config.php
檔案中，設定
ALERT_METHOD
參數來選擇通知方式。
-
簡訊 (sms)：
需要申請簡訊 API 金鑰，並在
config.php檔案中設定SMS_API_KEY。 -
Telegram：
需要建立 Telegram Bot 並取得 Bot Token 和 Chat ID，分別在
config.php檔案中設定TELEGRAM_BOT_TOKEN和TELEGRAM_CHAT_ID。 -
Email：
需要在
config.php檔案中設定你的 Email 地址和密碼，分別為EMAIL_ADDRESS和EMAIL_PASSWORD。
進階設定：過濾條件與除外關鍵字
為了讓 Alertor 更精準地通知你，你可以設定一些進階的過濾條件和除外關鍵字。
-
過濾看板：
可以設定只監控特定的 PTT 看板。在
config.php檔案中，設定BOARD參數，例如BOARD=Gossiping,MobileComm。 - 過濾作者： 可以設定只監控特定作者的文章。
-
除外關鍵字：
可以設定一些除外關鍵字，讓 Alertor 忽略包含這些關鍵字的帖子。例如，如果你追蹤 "台積電"，但不想收到與 "營收預警" 相關的通知，可以在
keyword.txt檔案中加入-營收預警。 - 時間限制： 你可以設定通知的時間範圍，避免在非工作時間被打擾。
- 文章數量限制： 你可以設定每次通知最多發送的文章數量。
常見問題與解決方法
- 無法登入 PTT： 檢查 PTT 帳號和密碼是否正確。PTT 的驗證機制比較複雜，如果遇到問題，可以嘗試在 PTT 網站上登入一次，確認帳號可用。
- 無法收到簡訊： 檢查簡訊 API 金鑰是否正確，以及簡訊餘額是否足夠。
- Telegram Bot 無法正常工作： 檢查 Telegram Bot Token 和 Chat ID 是否正確，以及 Bot 是否已在 Telegram 中啟動。
-
Alertor 沒有反應：
檢查 Cron Job 是否設定正確，以及 Alertor 的腳本是否有執行錯誤。可以查看
log.txt檔案，了解錯誤訊息。 - 關鍵字過於寬泛，收到太多通知： 調整關鍵字，使其更具體，或者加入除外關鍵字。
總結
PTT Alertor 是一個功能強大的 PTT 監視工具，可以幫助你節省時間，掌握關鍵資訊。希望本文能幫助你成功安裝和設定 PTT Alertor，並充分利用它的功能。 不論你是投資人、新聞記者、還是單純想密切關注 PTT 上特定話題的人，PTT Alertor 都能成為你的得力助手。
