2026FIFAWorldCup/docs/professional-data-reference.md

專業外部資料參考台帳（完整版）

本頁定義 2026 世界盃投注研究站的「參考來源矩陣」，目標是從官方公告、賠率市場、新聞訊號、球隊統計、場地天氣五大軸建立可追溯的高勝率研究底盤。
所有時區均以 Asia/Taipei（UTC+8） 對齊顯示。

一、來源接入分級

• active：已在系統中可直接抓取並回報健康狀態
• conditional：有條件接入（依環境金鑰）
• planned：規劃中，作為未來接入候選
• reference_only：僅作人工/參考核對，不列為即時抓取來源

二、主流外部來源矩陣

1. 官方與賽事主體

1. FIFA 官方 — fifa_official

   • 網址：https://www.fifa.com/fifa-world-cup
   • 類型：官方主辦
   • 狀態：reference_only
   • 權重：1.00
   • 用途：規則、公告、賽制、場地政策、重大異動參考

2. FIFA 官方賽程與賽果 — fifa_world_cup_fixtures

   • 網址：https://www.fifa.com/fifa-world-cup/fixtures-and-results
   • 類型：官方主辦
   • 狀態：reference_only
   • 權重：0.98
   • 用途：核對開賽時間、場次順序、場地異動

2. 賠率與市場資料

1. The Odds API — the_odds_api

   • 網址：https://api.the-odds-api.com
   • 類型：API
   • 狀態：active
   • 權重：0.96
   • 用途：主體市場抓取（1X2、讓球、大小球、BTTS）

2. Sportradar — sportradar

   • 網址：https://developer.sportradar.com
   • 類型：API（企業授權）
   • 狀態：planned
   • 權重：0.90
   • 用途：賽事事件與場內關鍵事件補強

3. API-FOOTBALL Odds — apifootball_odds

   • 網址：https://www.api-football.com
   • 類型：API（商用授權）
   • 狀態：planned
   • 權重：0.85
   • 用途：賠率備援與市場交叉驗證

4. Odds API 社群備援 — odds_api_fallback

   • 網址：https://www.odds-api.com
   • 類型：聚合參考
   • 狀態：reference_only
   • 權重：0.75
   • 用途：主幹與外部市場口徑偏差觀察

3. 新聞與事件訊號

1. NewsAPI — newsapi

   • 網址：https://newsapi.org
   • 類型：API
   • 狀態：conditional
   • 權重：0.82
   • 用途：有金鑰時抓取英文新聞與情緒信號

2. Google News RSS — google_news_rss

   • 網址：https://news.google.com
   • 類型：RSS
   • 狀態：active
   • 權重：0.70
   • 用途：無金鑰新聞備援，保證資訊補充持續可用

3. Reuters — reuters

   • 網址：https://www.reuters.com/sports
   • 類型：官方媒體
   • 狀態：reference_only
   • 權重：0.90
   • 用途：突發與敏感事件高可信核對

4. BBC Sport — bbc_sport

   • 網址：https://www.bbc.com/sport
   • 類型：官方媒體
   • 狀態：reference_only
   • 權重：0.84
   • 用途：主流新聞來源交叉核對

5. ESPN FC — espn

   • 網址：https://www.espn.com/soccer/
   • 類型：官方媒體
   • 狀態：reference_only
   • 權重：0.80
   • 用途：前瞻、輪替、戰術文本信號

6. Goal.com — goal

   • 網址：https://www.goal.com
   • 類型：官方媒體
   • 狀態：reference_only
   • 權重：0.74
   • 用途：傷病與賽前動態補充

7. Sky Sports — skysports

   • 網址：https://www.skysports.com/football
   • 類型：官方媒體
   • 狀態：reference_only
   • 權重：0.69
   • 用途：歐洲戰術與賽前觀察補充

8. The Guardian — guardian_sport

   • 網址：https://www.theguardian.com/football
   • 類型：官方媒體
   • 狀態：reference_only
   • 權重：0.71
   • 用途：深度報導、風險語意交叉核對

9. Associated Press — associated_press

   • 網址：https://apnews.com
   • 類型：官方媒體
   • 狀態：reference_only
   • 權重：0.77
   • 用途：突發事件高可見度校驗

10. OneFootball — onefootball

• 網址：https://onefootball.com
• 類型：官方媒體
• 狀態：reference_only
• 權重：0.66
• 用途：跨區域社群與賽事摘要補充

4. 球隊/球員與高階數據

1. SofaScore — sofascore

   • 網址：https://www.sofascore.com
   • 類型：Web
   • 狀態：planned
   • 權重：0.76
   • 用途：先發與戰況補強觀測

2. WhoScored — whoscored

   • 網址：https://www.whoscored.com
   • 類型：Web
   • 狀態：planned
   • 權重：0.81
   • 用途：場面效率與球員表現深度指標

3. FBref — fbref

   • 網址：https://fbref.com
   • 類型：Web
   • 狀態：planned
   • 權重：0.78
   • 用途：xG、節奏、每90分鐘效率

4. Understat — understat

   • 網址：https://understat.com
   • 類型：Web
   • 狀態：planned
   • 權重：0.79
   • 用途：xG 分佈與得分質量

5. WorldFootball.net — worldfootball

   • 網址：https://www.worldfootball.net
   • 類型：Web
   • 狀態：reference_only
   • 權重：0.64
   • 用途：歷史交手、賽事流程補充

6. Soccerway — soccerway

   • 網址：https://int.soccerway.com
   • 類型：Web
   • 狀態：reference_only
   • 權重：0.62
   • 用途：賽程與歷史進程交叉

7. Transfermarkt — transfermarkt

   • 網址：https://www.transfermarkt.com
   • 類型：Web
   • 狀態：reference_only
   • 權重：0.70
   • 用途：球員輪值、傷停、出場補充

8. Statbunker — statbunker

   • 網址：https://www.statbunker.com
   • 類型：Web
   • 狀態：reference_only
   • 權重：0.58
   • 用途：場均效率與歷史指標補充

9. Footystats — footystats

   • 網址：https://footystats.org
   • 類型：Web
   • 狀態：reference_only
   • 權重：0.60
   • 用途：效率模型參考

5. 比賽環境（天氣）

1. Open-Meteo — open_meteo

   • 網址：https://open-meteo.com
   • 類型：氣象 API
   • 狀態：planned
   • 權重：0.68
   • 用途：風速、溫濕度、降雨條件修正

2. WeatherAPI — weatherapi

   • 網址：https://www.weatherapi.com
   • 類型：氣象 API
   • 狀態：planned
   • 權重：0.64
   • 用途：天候補強與模型對照

3. OpenWeather — openweathermap

   • 網址：https://openweathermap.org
   • 類型：氣象 API
   • 狀態：planned
   • 權重：0.60
   • 用途：天氣交叉比對備援

三、資料使用原則（專業投注研究）

1. 先用官方公告與賽程基準定義「比賽可比性」。
2. 以 The Odds API 作為主幹，計算市場共識機率與賠率偏離。
3. 將新聞事件（Reuter/ESPN/Goal/Google RSS）轉為「風險熱度」與「臨場訊號」。
4. 在 2026 世界盃短天數高密度賽事下，優先看多源一致方向，降低單源誤差對單場判斷影響。
5. 使用官方/高可信來源權重作為優先裁決條件，reference_only 僅作核查，不與 active 源同等作決策。

四、系統落地映射

• GET /api/source-registry：回傳本台帳中的每個來源、整合層級、目前 runtime 狀態、延遲與錯誤摘要。
• GET /api/today-insights：回傳台北時區「今日可下注賽事」高/中/低/爆冷摘要，做為首頁主題化投研入口資料。
• 主幹賠率：the_odds_api（失敗會直接反映為 source-registry error）
• 新聞雙通道：newsapi（有金鑰）與 google_news_rss fallback
• 參考層：reference_only 僅保留為研究證據，不列為即時決策主因

五、建議的下一階段高價值接入

1. 將 weatherapi/open_meteo/openweathermap 其中一個正式接入，做場地環境修正模型。
2. 接入至少一個可授權備援 odds provider（如 Sportradar 或 API-FOOTBALL）降低單點失效。
3. 訓練新聞關鍵字模型（injury、rotation、rest）到權重輸入，提升短期決策穩定性。

六、台灣市場參考來源補充

台灣運彩官方網站 — taiwan_sports_lottery

• 網址：https://www.sportslottery.com.tw/
• 類型：官方/台灣市場參考網站
• 狀態：reference_only
• 權重：0.72
• 用途：台灣使用者投注玩法、賽事名稱、盤口呈現、賠率口徑與市場語言核對。
• 使用限制：正式導入爬蟲前必須檢查網站條款、robots、頻率限制與資料授權；未確認前僅作參考與人工核對，不作高頻抓取主資料源。
• 對產品的價值：用於校準台灣繁體中文介面、投注術語、玩法分類與本地市場可理解度，避免網站只像國外 odds dashboard，而不像台灣使用者真正會用的投研工具。