Important
蝦皮的登入驗證程序不時更新且越來越嚴格,維護登入步驟花費不少時間與力氣。正在實驗的新版 (v2) 機器人將不會再支援使用帳號密碼登入,而是改用與 pinkoi 簽到機器人同樣的人工給予 cookie 的方式。新版機器人會在九月釋出,屆時當前 (v1) 的機器人將會停止維護。
💰💰 簽到蝦皮領蝦幣 💰💰
這支程式針對台灣的蝦皮用戶設計,也就是 shopee.tw 網站的使用者。其他國家沒試過。
機器人已經包成容器,映像位於 Docker Hub
hyperbola/shopee-coins-bot
以及 GitHub Container Registry
ghcr.io/wdzeng/shopee-coins-bot
。
支援 amd64、arm64(樹梅派 4)以及 armv7。
以下為映像最新的 tag。其他可用的 tag 請參考 Docker Hub 或 GitHub Container Registry 頁面。
latest
,1
,1.3
,1.3.1
傳入 --help
可以印出使用說明。
docker run hyperbola/shopee-coins-bot:1 --help
第一次使用時,需要提供蝦皮帳號密碼,並且強烈建議設定機器人登入後儲存 cookie 的位置,以備未來機器人能夠執行自動登入。如果你不指定一個 cookie 的位置,那未來每次登入都會需要帳號與密碼。
docker run -v /path/to/somewhere:/cookie \
hyperbola/shopee-coins-bot:1 -u username -p password -c /cookie
Important
機器人進行登入期間,你可能會收到來自 shopee 的 Email 或手機驗證簡訊,其中會有一個驗證登入的連結。請在 10 分鐘內進行驗證,在這期間機器人會等你。一旦你點了驗證簡訊後,機器人會立即繼續執行下去。
如果之前有儲存過 cookie,用 cookie 登入即可,這樣就不會觸發簡訊驗證。
docker run -v /path/to/somewhere:/cookie hyperbola/shopee-coins-bot:1 -c /cookie
所有參數都是選填。
-u
,--user <STRING>
: 蝦皮帳號;可以是手機、電子信箱或蝦皮 IDDEPRECATED-p
,--pass <STRING>
: 蝦皮密碼-P
,--path-to-pass <FILE>
: 密碼檔案-c
,--cookie <FILE>
: cookie 檔案DEPRECATED-i
,--ignore-password
: 不要儲存密碼-x
,--no-sms
: 如果觸發簡訊驗證,直接令程式以失敗結束;預設為false
-y
,--no-email
: 如果觸發電子郵件驗證,直接令程式以失敗結束;預設為false
-f
,--force
: 如果今天已經領過蝦幣,令程式以成功作收;預設為false
-q
,--quiet
: 不要印出訊息;但仍會印出警告與錯誤訊息-s
,--screenshot <DIR>
: 簽到失敗時將螢幕截圖的儲存於指定資料夾下(圖檔檔名 為 screenshot.png)-V
,--version
: 印出版本-h
,--help
: 印出參數說明
如果你同時設定了帳號、密碼與 cookie,機器人會以下列順序嘗試登入:
- cookie
- 帳號與密碼
每次登入成功時,機器人就會將 cookie 更新至最新狀態。
Important
Cookie 是機密資料,請妥善保存。
Cookie 檔案的位置以下列優先順序決定。
- 環境變數
COOKIE
- 程式參數
--cookie
帳號以下列優先順序決定。
- 環境變數
USERNAME
- 程式參數
--user
密碼以下列優先順序決定。
- 環境變數
PASSWORD
程式參數DEPRECATED--pass
- 環境變數
PATH_PASS
- 程式參數
--path-to-pass
Exit code | 解釋 |
---|---|
0 | 簽到成功。 |
1 | 今日已簽到。如果傳了 --force 參數,那就會改為回傳 0。 |
2 | 需要簡訊驗證,但你傳了 --no-sms 參數。 |
3 | 機器人遇到拼圖遊戲。這通常是因為嘗試登入次數太多,被網站 ban 掉。 |
4 | 操作逾時。 |
6 | 使用者進行簡訊驗證時選擇拒絕機器人登入。 |
7 | 需要電子郵件驗證,但你傳了 --no-email 參數。 |
69 | 嘗試登入次數太多被 ban。 |
77 | 參數不合法。 |
87 | 帳號或密碼錯誤。 |
88 | 不明錯誤。 |