{"id":17707671,"url":"https://github.com/wdzeng/shopee-coins-bot","last_synced_at":"2025-03-13T12:32:39.480Z","repository":{"id":37233338,"uuid":"497706298","full_name":"wdzeng/shopee-coins-bot","owner":"wdzeng","description":"💰 蝦皮簽到機器人 💰","archived":true,"fork":false,"pushed_at":"2023-09-30T16:28:01.000Z","size":631,"stargazers_count":447,"open_issues_count":5,"forks_count":806,"subscribers_count":11,"default_branch":"main","last_synced_at":"2025-02-12T14:21:22.449Z","etag":null,"topics":["bot","coin","shopee"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wdzeng.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2022-05-29T20:48:28.000Z","updated_at":"2025-02-08T08:49:15.000Z","dependencies_parsed_at":"2023-02-17T01:25:30.221Z","dependency_job_id":"6b376e55-c9be-44ac-b052-f3f06f5572b3","html_url":"https://github.com/wdzeng/shopee-coins-bot","commit_stats":null,"previous_names":[],"tags_count":37,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wdzeng%2Fshopee-coins-bot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wdzeng%2Fshopee-coins-bot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wdzeng%2Fshopee-coins-bot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wdzeng%2Fshopee-coins-bot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wdzeng","download_url":"https://codeload.github.com/wdzeng/shopee-coins-bot/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243405801,"owners_count":20285819,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bot","coin","shopee"],"created_at":"2024-10-25T01:06:13.739Z","updated_at":"2025-03-13T12:32:39.172Z","avatar_url":"https://github.com/wdzeng.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 蝦皮簽到機器人\n\n[![release](https://badgen.net/github/release/wdzeng/shopee-coins-bot/stable?color=red)](https://github.com/wdzeng/shopee-coins-bot/releases/latest)\n[![unittests](https://img.shields.io/github/actions/workflow/status/wdzeng/shopee-coins-bot/unittests.yml?branch=main\u0026label=unittests)](https://github.com/wdzeng/shopee-coins-bot/actions/workflows/unittests.yml)\n[![docker](https://badgen.net/badge/icon/docker?icon=docker\u0026label=)](https://hub.docker.com/repository/docker/hyperbola/shopee-coins-bot)\n[![ghcr](https://badgen.net/badge/icon/ghcr/black?icon=github\u0026label=)](https://github.com/wdzeng/shopee-coins-bot/pkgs/container/shopee-coins-bot)\n\n\u003e [!IMPORTANT]  \n\u003e 蝦皮的登入驗證程序不時更新且越來越嚴格，維護登入步驟花費不少時間與力氣。正在實驗的新版\n\u003e ([v2](https://github.com/wdzeng/shopee-coins-bot/tree/features/v2))\n\u003e 機器人將不會再支援使用帳號密碼登入，而是改用與\n\u003e [pinkoi 簽到機器人](https://github.com/wdzeng/pinkoi-coins-bot)同樣的人工給予 cookie\n\u003e 的方式。新版機器人會在九月釋出，屆時當前 (v1) 的機器人將會停止維護。\n\n💰💰 簽到蝦皮領蝦幣 💰💰\n\n這支程式針對台灣的蝦皮用戶設計，也就是 [shopee.tw](https://shopee.tw/) 網站的使用者。其他國家沒試過。\n\n## 使用方式\n\n這支程式需要用到 [docker](https://www.docker.com/) 或 [podman](https://podman.io/)。\n\n機器人已經包成容器，映像位於 Docker Hub\n[`hyperbola/shopee-coins-bot`](https://hub.docker.com/repository/docker/hyperbola/shopee-coins-bot)\n以及 GitHub Container Registry\n[`ghcr.io/wdzeng/shopee-coins-bot`](https://github.com/wdzeng/shopee-coins-bot/pkgs/container/shopee-coins-bot)。\n支援 amd64、arm64（樹梅派 4）以及 armv7。\n\n### Tags\n\n以下為映像最新的 tag。其他可用的 tag 請參考 Docker Hub 或 GitHub Container Registry 頁面。\n\n- `latest`, `1`, `1.3`, `1.3.1`\n\n### 使用說明\n\n傳入 `--help` 可以印出使用說明。\n\n```sh\ndocker run hyperbola/shopee-coins-bot:1 --help\n```\n\n### 帳號密碼登入\n\n第一次使用時，需要提供蝦皮帳號密碼，並且強烈建議設定機器人登入後儲存 cookie\n的位置，以備未來機器人能夠執行自動登入。如果你不指定一個 cookie 的位置，那未來每次登入都會需要帳號與密碼。\n\n```sh\ndocker run -v /path/to/somewhere:/cookie \\\n    hyperbola/shopee-coins-bot:1 -u username -p password -c /cookie\n```\n\n\u003e [!IMPORTANT]  \n\u003e 機器人進行登入期間，你可能會收到來自 shopee 的 Email\n\u003e 或手機驗證簡訊，其中會有一個驗證登入的連結。請在 10\n\u003e 分鐘內進行驗證，在這期間機器人會等你。一旦你點了驗證簡訊後，機器人會立即繼續執行下去。\n\n### 自動登入\n\n如果之前有儲存過 cookie，用 cookie 登入即可，這樣就不會觸發簡訊驗證。\n\n```sh\ndocker run -v /path/to/somewhere:/cookie hyperbola/shopee-coins-bot:1 -c /cookie\n```\n\n## 參數\n\n所有參數都是選填。\n\n- `-u`, `--user \u003cSTRING\u003e`: 蝦皮帳號；可以是手機、電子信箱或蝦皮 ID\n- ~~`-p`, `--pass \u003cSTRING\u003e`: 蝦皮密碼~~ **DEPRECATED**\n- `-P`, `--path-to-pass \u003cFILE\u003e`: 密碼檔案\n- `-c`, `--cookie \u003cFILE\u003e`: cookie 檔案\n- ~~`-i`, `--ignore-password`: 不要儲存密碼~~ **DEPRECATED**\n- `-x`, `--no-sms`: 如果觸發簡訊驗證，直接令程式以失敗結束；預設為 `false`\n- `-y`, `--no-email`: 如果觸發電子郵件驗證，直接令程式以失敗結束；預設為 `false`\n- `-f`, `--force`: 如果今天已經領過蝦幣，令程式以成功作收；預設為 `false`\n- `-q`, `--quiet`: 不要印出訊息；但仍會印出警告與錯誤訊息\n- `-s`, `--screenshot \u003cDIR\u003e`: 簽到失敗時將螢幕截圖的儲存於指定資料夾下（圖檔檔名\n  為 screenshot.png）\n- `-V`, `--version`: 印出版本\n- `-h`, `--help`: 印出參數說明\n\n如果你同時設定了帳號、密碼與 cookie，機器人會以下列順序嘗試登入：\n\n1. cookie\n2. 帳號與密碼\n\n每次登入成功時，機器人就會將 cookie 更新至最新狀態。\n\n\u003e [!IMPORTANT]  \n\u003e Cookie 是機密資料，請妥善保存。\n\nCookie 檔案的位置以下列優先順序決定。\n\n1. 環境變數 `COOKIE`\n2. 程式參數 `--cookie`\n\n帳號以下列優先順序決定。\n\n1. 環境變數 `USERNAME`\n2. 程式參數 `--user`\n\n密碼以下列優先順序決定。\n\n1. 環境變數 `PASSWORD`\n2. ~~程式參數 `--pass`~~ **DEPRECATED**\n3. 環境變數 `PATH_PASS`\n4. 程式參數 `--path-to-pass`\n\n## Exit Code\n\n| Exit code | 解釋                                                              |\n| --------- | ----------------------------------------------------------------- |\n| 0         | 簽到成功。                                                        |\n| 1         | 今日已簽到。如果傳了 `--force` 參數，那就會改為回傳 0。           |\n| 2         | 需要簡訊驗證，但你傳了 `--no-sms` 參數。                          |\n| 3         | 機器人遇到拼圖遊戲。這通常是因為嘗試登入次數太多，被網站 ban 掉。 |\n| 4         | 操作逾時。                                                        |\n| ~~5~~     | ~~觸發電子郵件驗證。機器人尚不支援。~~ **DEPRECATED**             |\n| 6         | 使用者進行簡訊驗證時選擇拒絕機器人登入。                          |\n| 7         | 需要電子郵件驗證，但你傳了 `--no-email` 參數。                    |\n| 69        | 嘗試登入次數太多被 ban。                                          |\n| 77        | 參數不合法。                                                      |\n| 87        | 帳號或密碼錯誤。                                                  |\n| 88        | 不明錯誤。                                                        |\n\n## 姊妹機器人\n\n- [Pinkoi 簽到機器人](https://github.com/wdzeng/pinkoi-coins-bot/)\n- [批踢踢登入機器人](https://github.com/wdzeng/ptt-login-bot/)\n- [Telegram ID 覬覦者](https://github.com/wdzeng/telegram-id-pretender/)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwdzeng%2Fshopee-coins-bot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwdzeng%2Fshopee-coins-bot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwdzeng%2Fshopee-coins-bot/lists"}