Taiwan Lottery

mcp-server-taiwan-lottery

讓 AI 助理和程式直接查台灣彩券的官方開獎結果：最新一期、歷史開獎、對獎、號碼出現次數、開獎時間。號碼全部來自台灣彩券官方 API，查不到就說查不到，不會自己補。

說明與完整開獎資料：playsport539.com

一個套件兩種用法：MCP 伺服器（給 Claude 這類 AI 助理用），以及指令列工具 taiwan-lottery（給腳本、排程用）。

能做什麼

• 查某個遊戲最新一期的號碼、特別號（大樂透）或第二區（威力彩）、本期各獎項的中獎注數與每注獎金
• 用期別或日期查某一期；那天沒開獎會直接告訴你哪幾天才開
• 列出某個月，或最近 N 期的號碼
• 對獎：輸入你的號碼，回答對中哪幾個、是哪一個獎項，並附上官方的中獎條件原文
• 統計最近 N 期每個號碼出現幾次、隔了幾期沒開
• 開獎日、開獎時間，以及官方 API 給的下一期開獎日

每個結果都有 more 欄位，附 1 到 3 個 playsport539.com 的相關頁面（歷史開獎、統計、對獎、開獎時間），想看完整資料可以點過去。先說清楚：playsport539.com 是一個台灣彩券開獎與運動比分網站，網站上有廣告。

想直接在網頁上看，常用的幾頁：

• 各彩種今日開獎號碼
• 今彩539 歷史開獎
• 今彩539 號碼出現次數
• 大樂透線上對獎
• 威力彩號碼統計

支援的遊戲

代號	遊戲	也可以打	對獎會判定的獎項	開獎
539	今彩539	今彩、daily539	頭獎、貳獎、參獎、肆獎	週一至週六 20:30
lotto649	大樂透	649	頭獎到柒獎、普獎（特別號自動比對）	週二、週五 20:30
superlotto	威力彩	super_lotto638	頭獎到玖獎、普獎（要給第二區號碼）	週一、週四 20:30
3d	3星彩	三星彩	壹獎、貳獎、參獎（有一種組合不判定，見下方）	週一至週六 20:30
4d	4星彩	四星彩	壹獎、貳獎、參獎（同上）	週一至週六 20:30
39m	39樂合彩	39_m5	二合、三合、四合	用今彩539的號碼
49m	49樂合彩	49_m6	二合、三合、四合	用大樂透的號碼（不含特別號）
bingo	賓果賓果	賓果	只列出對中的號碼，不判定獎項	每天 07:05 到 23:55，每 5 分鐘一期
38m	38樂合彩	38_m6	二合到五合	已不在官方開獎時程，資料到 2023-12
lotto1224	雙贏彩	1224	頭獎到肆獎	已不在官方開獎時程，資料到 2023-12

中文名稱直接打就可以，例如「今彩539」「大樂透」「威力彩」；簡體（大乐透、宾果）與「三星」「四星」「威力」這種簡稱也認得。「樂透」這種泛稱不認，因為分不出是哪一個遊戲。

安裝

不需要任何 API 金鑰。建議用 Node.js 20 以上。

Node.js 18 也能跑，但安裝時會看到 EBADENGINE 警告：官方 MCP SDK（@modelcontextprotocol/sdk）帶進來的 @hono/node-server 標註要 Node.js 20 以上。這個套件只用 stdio 連線，不會載入它，所以警告不影響執行（把它整個刪掉再跑伺服器與指令列的測試，結果照樣全過）。如果你的 npm 開了 engine-strict，Node.js 18 會直接裝不起來（npm 文件：開了 engine-strict 就拒絕安裝標註不相容目前 Node.js 版本的套件）。

Claude Desktop

在 claude_desktop_config.json 加上：

{
  "mcpServers": {
    "taiwan-lottery": { "command": "npx", "args": ["-y", "mcp-server-taiwan-lottery"] }
  }
}

Claude Code

claude mcp add taiwan-lottery -- npx -y mcp-server-taiwan-lottery

指令列

npx -y -p mcp-server-taiwan-lottery taiwan-lottery latest 539

或是 npm install -g mcp-server-taiwan-lottery 之後直接打 taiwan-lottery。

指令列範例

以下都是實際執行的輸出（2026-10-23 早上，台灣時間）。

$ taiwan-lottery latest 539
今彩539　第 115000256 期　2026-10-22（週四）
開獎號碼（由小到大）：03 08 14 23 28
開出順序：03 28 23 14 08
獎項（本期官方公布）：
  頭獎          4 注　每注 6,000,000 元
  貳獎        249 注　每注 20,000 元
  參獎      7,153 注　每注 300 元
  肆獎     74,792 注　每注 50 元
銷售金額：32,953,350 元
兌獎期限：2027-01-22

說明：
  - 官方資料不是即時的：台灣彩券官網常見問題寫明每晚 21:30 公告當日獎號、22:00 公告開獎結果（各獎項注數與獎金）。21:30 以前查不到當期是正常的，22:00 以前可能還沒有獎金資料。
  - 資料取自台灣彩券官方 API，一切以台灣彩券官方公告為準。

更多：
  今彩539開獎號碼  https://playsport539.com/lottery/539/
  今彩539歷史開獎  https://playsport539.com/lottery/539/history/

$ taiwan-lottery check 大樂透 02 05 19 07 11 25
大樂透　第 115000098 期　2026-10-20
你的號碼：02 05 19 07 11 25
開獎號碼：02 05 19 33 40 43　特別號 06
對中：02 05 19（3 個）
結果：普獎（對中當期獎號之任三碼）
本期普獎每注：400 元（官方公布）

說明：
  - 沒有指定期別，這裡對的是官方資料裡最新的一期（第 115000098 期，2026-10-20）。請確認和彩券上的期別相同。
  - 官方資料不是即時的：台灣彩券官網常見問題寫明每晚 21:30 公告當日獎號、22:00 公告開獎結果（各獎項注數與獎金）。21:30 以前查不到當期是正常的，22:00 以前可能還沒有獎金資料。
  - 對獎結果僅供參考，兌獎以彩券本身及台灣彩券官方兌獎結果為準。
  - 資料取自台灣彩券官方 API，一切以台灣彩券官方公告為準。

更多：
  大樂透對獎  https://playsport539.com/lottery/lotto649/check/
  大樂透玩法與獎項  https://playsport539.com/lottery/lotto649/rules/
  大樂透開獎號碼  https://playsport539.com/lottery/lotto649/

$ taiwan-lottery schedule 威力彩
威力彩 開獎時間
開獎日：週一、週四
時間：20:30（台灣時間）
下一期：2026-10-26（週一）　第 115000086 期
官網公布：台灣彩券官網每晚 21:30 公告當日獎號、22:00 公告開獎結果
來源：https://www.taiwanlottery.com/run_lottery/schedule/ https://www.taiwanlottery.com/customer_service/faq/

說明：
  - 官方資料不是即時的：台灣彩券官網常見問題寫明每晚 21:30 公告當日獎號、22:00 公告開獎結果（各獎項注數與獎金）。21:30 以前查不到當期是正常的，22:00 以前可能還沒有獎金資料。
  - 資料取自台灣彩券官方 API，一切以台灣彩券官方公告為準。

更多：
  威力彩開獎時間  https://playsport539.com/lottery/superlotto/schedule/
  威力彩玩法與獎項  https://playsport539.com/lottery/superlotto/rules/
  威力彩開獎號碼  https://playsport539.com/lottery/superlotto/

$ taiwan-lottery stats 539 --last 30
今彩539　最近 30 期的歷史出現次數（2026-09-18 第 115000227 期 ～ 2026-10-22 第 115000256 期）
出現最多：30 14 08 20 34
出現最少：37 11 12 35 07
號碼:次數/上次出現
  01: 3次/2期前    02: 5次/8期前    03: 5次/0期前    04: 3次/1期前    05: 4次/13期前
  06: 4次/9期前    07: 2次/12期前   08: 6次/0期前    09: 4次/5期前    10: 2次/4期前
  11: 1次/13期前   12: 1次/3期前    13: 5次/7期前    14: 7次/0期前    15: 5次/1期前
  16: 5次/3期前    17: 4次/12期前   18: 4次/1期前    19: 4次/7期前    20: 6次/4期前
  21: 2次/10期前   22: 2次/3期前    23: 4次/0期前    24: 4次/5期前    25: 4次/5期前
  26: 4次/4期前    27: 3次/11期前   28: 5次/0期前    29: 3次/14期前   30: 9次/2期前
  31: 3次/11期前   32: 5次/4期前    33: 4次/14期前   34: 6次/6期前    35: 1次/28期前
  36: 3次/2期前    37: 0次/未開     38: 5次/2期前    39: 3次/4期前

說明：
  - 每一期開獎都是獨立的隨機事件，過去出現的次數不能預測下一期。以下只是歷史出現次數的統計。
  - 資料取自台灣彩券官方 API，一切以台灣彩券官方公告為準。

更多：
  今彩539號碼出現次數統計  https://playsport539.com/lottery/539/hot-cold/
  今彩539歷史開獎  https://playsport539.com/lottery/539/history/
  今彩539開獎號碼  https://playsport539.com/lottery/539/

「0期前」是最新一期有開出，「未開」是這 30 期都沒有開出。

$ taiwan-lottery draw 539 --date 2026-10-18
taiwan-lottery: 2026-10-18（週日）沒有今彩539的開獎資料。今彩539的開獎日是週一至週六。

完整用法：

taiwan-lottery latest <遊戲>
taiwan-lottery draw <遊戲> --period <期別> | --date <YYYY-MM-DD>
taiwan-lottery list <遊戲> [--month YYYY-MM | --last N | --date YYYY-MM-DD]
taiwan-lottery check <遊戲> <號碼...> [--second N] [--period N]
taiwan-lottery stats <遊戲> [--last N]
taiwan-lottery schedule <遊戲>
taiwan-lottery games
taiwan-lottery --selftest | --help | --version

加上 --json 會輸出 JSON。威力彩對獎用 --second 給第二區號碼，3星彩、4星彩直接打數字，例如 taiwan-lottery check 3d 073。號碼之間只能用空白、逗號或頓號（、）隔開；小數點、負號或其他符號會直接報錯，不會被當成分隔（3.8 14 23 28 是寫錯的四個號碼，不會被讀成五個）。

結束代碼	意思
0	完成（包含「沒中獎」）
1	官方資料沒有這一期，或還沒更新
2	參數錯誤、官方 API 失敗，或自我測試沒過

MCP 工具

工具	輸入	回傳
latest_draw	game	最新一期：期別、日期、號碼（由小到大與開出順序）、特別號或第二區、本期各獎項注數與每注獎金
get_draw	game，加 period 或 date	指定的一期。賓果賓果一天 203 期，要給期別
list_draws	game，加 month（YYYY-MM）或 last_n（最多 100，預設 10）；賓果賓果用 date	多期的號碼（不含獎金表）
check_ticket	game、numbers，威力彩加 second_zone，可選 period（預設最新一期）	對中的號碼、獎項名稱、官方中獎條件原文、該期這個獎項的每注獎金
number_stats	game、last_n（預設 30，最多 200）	每個號碼的出現次數、隔幾期沒開、出現最多與最少的號碼，附「每期獨立」的說明
draw_schedule	game	開獎日與時間、官方 API 的下一期開獎日、官方公告、官網公布結果的時間

全部是唯讀工具。輸入有誤、查無此期、官方 API 失敗時，回傳 isError，kind 分別是 input、not_found、upstream，訊息是中文。

伺服器啟動時會先跑一次自我測試（用錄下來的官方回應，不連網路），測試沒過就拒絕啟動。指令列也一樣，先過自我測試才回答。

データソースと遅延

• データソース：台湾彩券の公式 API https://api.taiwanlottery.com/TLCAPIWeB/Lottery/。使用するエンドポイント（Daily539Result、Lotto649Result、SuperLotto638Result、3DResult、4DResult、39M5Result、49M6Result、38M6Result、Lotto1224Result、BingoResult、LatestBingoResult、NextDrawDate、ExceptionNotice）は、www.taiwanlottery.com のウェブページにある JavaScript から見つけたもので、2026-10-23 に一つずつ実際に呼び出して確認しました。
• 公式データには遅延があります。 台湾彩券公式サイトのよくある質問には、公式サイトでは毎晩 21:30 に当日の当選番号を、22:00 に抽せん結果を発表すると記載されています。そのため、21:30 より前に当日の回の結果を確認できないのは正常です。また、22:00 より前は番号だけで、賞金がまだ掲載されていない可能性があります。このツールは結果が見つからなければ、見つからないと報告し、ほかのサイトの番号で補うことはありません。（なお、これは公式の説明ではなく一度観察した内容ですが、2026-08-22 の 20:30 の回は、20:53 の時点でも API で確認できませんでした。）
• 賞金がまだ発表されていない場合、賞金表は表示しません。 ある回の各賞がすべて 0 口、0 元の場合は、当せん者がいないのではなく、まだ発表されていないことを意味します。ツールは賞金表を削除して prizes_pending: true を付け、公式発表は 22:00 であることを説明します。21:30 から 22:00 の間に公式 API が実際に何を返すかは、その時間帯にまだ検証していません。
• API に負荷をかけないよう配慮しています。同じクエリは 5 分以内であればメモリ内の結果をそのまま使用し（終了した月のデータは 12 時間保持）、User-Agent にパッケージ名を明記し、リクエストは 15 秒でタイムアウトします。直近 200 回の統計も、API 自体の月間範囲パラメーターを使ってリクエストは最大 2 回だけです。
• 38樂合彩、雙贏彩は、現在の公式抽せんスケジュールに含まれていません（公式の次回抽せん一覧にこの 2 つのゲームはありません）。API でデータが確認できる最後の月は 2023-12 です。過去の結果は確認できますが、新しい回はありません。

当せん判定ルールの出典

賞の名称と当せん条件は、台湾彩券公式サイトの各ゲーム紹介ページからそのまま引用しています（これらのページは JavaScript で生成され、規約はページ読み込み時のプログラムに含まれています）。

ゲーム	公式ページ
今彩539	https://www.taiwanlottery.com/lotto/info/daily_cash/
大楽透	https://www.taiwanlottery.com/lotto/info/lotto649/
威力彩	https://www.taiwanlottery.com/lotto/info/super_lotto638/
3星彩	https://www.taiwanlottery.com/lotto/info/3_d/
4星彩	https://www.taiwanlottery.com/lotto/info/4_d/
39樂合彩	https://www.taiwanlottery.com/lotto/info/39_m5/
49樂合彩	https://www.taiwanlottery.com/lotto/info/49_m6/
賓果賓果（賞の判定なし）	https://www.taiwanlottery.com/lotto/info/bingo_bingo/
38樂合彩、雙贏彩	公式サイトの過去の抽せん結果ページにある賞の表示：https://www.taiwanlottery.com/lotto/history/history_result/

抽せん日は https://www.taiwanlottery.com/run_lottery/schedule/ 、抽せん時刻の 20:30 と発表時刻の 21:30、22:00 は https://www.taiwanlottery.com/customer_service/faq/ 、賓果賓果の 07:05 から 23:55 まで 5 分ごとの抽せんは https://www.taiwanlottery.com/lotto/result/bingo_bingo/ が出典です。

知っておくべき点：

• 1口あたりの賞金は、必ずその回に公式発表された金額を使います。ルールページの賞金表は使用しません。両者が異なる場合があるためです。たとえば 39樂合彩の二合は、ルールページでは 1 口 1,125 元と記載されていますが、第 115000256 回に公式発表された金額は 1,500 元です。
• 3星彩、4星彩には、判定されない組み合わせがあります。 3星彩の「百の位が一致、十の位は不一致、一の位が一致」、4星彩の「千の位が一致、百の位は不一致、十の位と一の位が一致」は、公式サイトのゲーム紹介ページの賞の表ではどの賞にも該当しませんが、公式サイトの「当せん番号照合アシスタント」の判定方法では当せんとされます。2 つの公式情報の説明が異なるため、ツールは won: null を返し、その理由を説明します。
• 樂合彩は選んだ番号の数で遊び方が決まります。2 個選ぶと二合、3 個選ぶと三合、というように、すべての番号が一致した場合のみ当せんです。システム組み合わせまたはシステム選択の宝くじは、1 口ずつ個別に照合してください。
• 賓果賓果には基本ゲーム（1 から 10 星）、スーパー賞号、大きい・小さい、奇数・偶数の予想があり、賞金は遊び方、星の数、一致した個数によって異なります。ツールは一致した番号とスーパー賞号が当たったかどうかだけを表示し、won は null です。

各回はそれぞれ独立しています

number_stats は、過去に出た番号を数えたものにすぎません。各回の抽せんは独立したランダムな事象であり、過去の出現回数から次回を予測することはできません。出現回数の多い番号が再び出やすくなるわけではなく、長い間出ていない番号が「そろそろ出る」わけでもありません。ツールは統計を返すたびに、この説明を添えます。

免責事項

• これはオープンソースのデータ照会ツールであり、台湾彩券の公式製品ではなく、台湾彩券会社とは関係ありません。
• すべて台湾彩券の公式発表を基準とします。当せん判定の結果は参考情報にすぎず、換金時は宝くじ本体と公式の当せん結果を基準にしてください。
• 公式の抽せん情報のみを提供し、番号選びのアドバイスは提供しません。

開発

npm install
npm run build
npm run selftest              # 解析、對獎、統計、連結，用錄下的官方回應，不連網路
node scripts/smoke.mjs        # 用 MCP 用戶端實際連伺服器、實際跑指令列（API 換成錄下的回應）
node scripts/check-publish-ready.mjs
node scripts/live-check.mjs   # 真的呼叫官方 API，每個遊戲一次（不在 CI 裡跑）
node scripts/record-fixtures.mjs  # API 格式改了才需要重錄 fixtures/

English

mcp-server-taiwan-lottery は、台湾公式宝くじ（台灣彩券）の抽せん結果を取得する MCP サーバー兼 CLI です。公式 API api.taiwanlottery.com のみを参照し、API にない数字を補完することはありません。

• ツール：latest_draw、get_draw、list_draws、check_ticket、number_stats、draw_schedule。すべて読み取り専用です。
• ゲーム：539、lotto649、superlotto、3d、4d、39m、49m、bingo に加え、38m と lotto1224（抽せん終了済み。2023-12 までの履歴）。中国語名も使用できます。
• インストール：MCP サーバー（stdio）として npx -y mcp-server-taiwan-lottery を実行するか、コマンドラインで npx -y -p mcp-server-taiwan-lottery taiwan-lottery latest 539 を実行します。API キーは不要です。Node.js 20 以降を推奨します。Node.js 18 では、MCP SDK が依存関係として取り込む @hono/node-server が Node.js 20 を宣言しているため、npm は EBADENGINE 警告を表示します。このパッケージは stdio のみを使用し、@hono/node-server を読み込まないため、引き続き動作します。npm の engine-strict が設定されている場合、Node.js 18 ではインストールに失敗します。
• 公式データの更新には遅れがあります。公式 FAQ によると、サイトでは台湾時間の21:30に当日の当せん番号が、22:00に賞金結果が公開されます。21:30より前は通常、当日の抽せん結果がありません。22:00より前は賞金表が未公開の場合があり、その場合、結果には賞金表がなく、prizes_pending: true となります（誰も当せんしなかったという意味ではありません）。
• check_ticket は、公式のゲームルール（上記でリンクされているページ）に基づいて賞金等級を示し、その抽せんで公開された1口あたりの金額を表示します。BINGO BINGO については、一致した数字のみを返します。
• number_stats は過去の抽せんのみを集計します。各抽せんは独立しており、過去の出現頻度から将来の抽せん結果を予測することはできません。
• 公式発表が優先されます。これは台湾公式宝くじの製品ではありません。
• すべての結果に more が含まれます。より詳細な履歴や統計を確認できる、広告を掲載する台湾の宝くじ・スポーツスコアサイト playsport539.com へのリンクが1～3件あります。

ライセンス

MIT