Appearance
腳本配置
管理銀行網銀爬蟲（Bank Scraper）的部署與連線狀態。爬蟲用於自動登入銀行網銀查帳，將入帳交易即時比對訂單並完成自動回調。
站點限定
此功能僅在特定站點啟用，若需啟用需與管理員接洽啟用。
頁面說明
頁面頂部提供「安裝教學」與「新增」按鈕，下方為爬蟲實例列表。
表格欄位
| 欄位 | 說明 |
|---|---|
| 名稱 | 爬蟲實例名稱（粗體） |
| 狀態 | online（綠色標籤）或 offline（灰色標籤），依 WebSocket 心跳判定 |
| 啟用卡號 | 該爬蟲負責監控的銀行卡號列表，最多顯示 3 個標籤，超過以 +N 標籤展開 |
| 最後心跳 | 上次 WebSocket 心跳的時間 |
| 建立時間 | 爬蟲實例建立時間 |
| 操作 | 功能按鈕 |
操作按鈕
| 按鈕 | 說明 |
|---|---|
| 複製安裝碼 | 複製該爬蟲的安裝碼至剪貼簿 |
| 重新產生金鑰 | 重新產生 API Key，產生後顯示新的安裝碼（需確認） |
| 編輯 | 修改名稱與啟用卡號 |
| 刪除 | 刪除爬蟲實例（需確認） |
新增爬蟲
點擊「新增」按鈕開啟表單：
| 欄位 | 必填 | 說明 |
|---|---|---|
| 名稱 | 是 | 爬蟲實例的識別名稱 |
| 啟用卡號 | 否 | 多選下拉，從 CTCPAY vendor 列表中選取該爬蟲要監控的卡號，支援全選/取消全選 |
建立成功後會彈出安裝碼（Setup Code），需複製並用於客戶端安裝。
DANGER
安裝碼包含 API Key，僅在建立與重新產生金鑰時顯示，請妥善保存。
安裝教學
點擊「安裝教學」按鈕開啟彈窗，以分頁方式提供 Windows 與 macOS 的安裝步驟：
Windows
- 安裝：開啟 PowerShell，貼上一行安裝指令（含安裝碼），自動下載並設定爬蟲
- 啟動：在開始選單搜尋
scraper即可啟動 - 解除安裝：貼上一行解除安裝指令即可移除
macOS
- 安裝：開啟終端機，貼上
curl安裝指令（含安裝碼），自動下載並設定 - 啟動：開啟終端機輸入
scraper即可啟動 - 解除安裝：貼上一行
curl解除安裝指令即可移除
系統需求
- macOS 10.15+ 或 Windows 10+
- 需要網路連線
- 約 500MB 磁碟空間
- 無需預先安裝任何軟體
編輯爬蟲
可修改爬蟲名稱與啟用卡號。啟用卡號的變更會即時透過 WebSocket 推送至已連線的爬蟲客戶端。
爬蟲運作原理
爬蟲客戶端安裝於客戶機器上，透過 Playwright 自動化瀏覽器登入銀行網銀，定期查詢帳戶交易明細。查詢到的入帳交易透過 WebSocket 回報至後端，後端根據金額與帳號資訊自動比對待付款訂單，匹配成功則完成訂單並發送回調通知。
目前支援的銀行包含國泰世華、玉山、台新等主要銀行，共計 56 支 adapter（含個人網銀與企業公戶）。