HK Odds Pick — 港彩赔率 AI 预测 SEO 实战
实时赔率 + AI 因子模型 + SportsEvent schema 三位一体。公开架构决策、多 LLM fallback、env 卫生机制。
RedClaw 为 HK Odds Pick（hkoddspick.com）构建一套「实时赔率 ingestion → AI 因子模型 → 时效性 SEO 内容」的端到端架构。差异化在于：(1) 完整 SportsEvent schema；(2) AI 因子模型 fallback 链（Gemini → Claude → DeepSeek）；(3) env var 卫生机制；(4) 时效性内容自动化。
HK Odds Pick（hkoddspick.com）是什么？
HK Odds Pick 是 RedClaw 服务的香港赛马赔率 AI 预测平台，对应域名 hkoddspick.com。RedClaw 负责 SEO 架构、AI 因子预测模型工程、时效性内容 pipeline 与基础设施维护。
產品基本資料
系統指標（截至 2026-05-24）
架構與技術指標公開；流量與營收數據受 NDA 保護。
RedClaw 為 HK Odds Pick（hkoddspick.com）部署 3 層 LLM fallback 鏈（Gemini → Claude → DeepSeek），單一 API 失敗時自動切換，搭配 env 衛生機制（防止 trailing newline 讓 LLM 靜默回空），確保 AI 因子分析的可用性與一致性。 (來源: RedClaw, 2026-05-24)
為什麼這套架構會贏：三根支柱
一般 sportsbook 站把每場賽事寫成文章 + 表格。我們把每場賽事標 SportsEvent + Event status + competitor + offerCount + lowPrice / highPrice，讓 Google 把整場賽事當「實體」處理。長尾查詢「[馬名] 賠率」「[騎師] 勝率」直接命中富結果。
Gemini 2.5 Flash 預設啟 thinking tokens 會吃光 maxOutputTokens 把 JSON 截斷；Claude 偶爾 rate limit；DeepSeek 便宜但中文穩定度差。我們用 fallback 鏈：Gemini（含 thinkingConfig: { thinkingBudget: 0 } 關掉 thinking）→ Claude → DeepSeek，任一失敗自動切。每次切換寫進 syncLogs 可追蹤。
Vercel 環境變數最常見的災難是「值尾端帶 \n」— Google 會拒收 GEMINI_API_KEY、aiFactors 靜默回空，每次 debug 30 分鐘起跳。我們寫了 sanitize-env.ts 在 build 時掃所有 env，trailing \n\r\s 直接 fail。這是跨專案的工程化護欄。
這證明了什麼（對未來客戶）
HK Odds Pick（hkoddspick.com）是一個活著的 sportsbook / 賠率產品 SEO 範本 — 可被直接訪問與引用。
- 1能在竞争最激烈的香港赛马 SEO 取得空间
香港赛马 SEO 玩家多，传统 Article 已被洗到第 3 页。HK Odds Pick 走 SportsEvent + Knowledge Graph 路线，长尾查询切进富结果。
- 2能交付 AI 因子产品 — 不只「用 ChatGPT 写文章」
6 因子 prompt + 3 层 fallback + thinkingConfig + syncLogs + env sanitization。每个技术决策都有原因。
- 3能用「跨专案工程护栏」防止重复踩同一个坑
sanitize-env.ts、Vercel pre-deploy、Firestore SA key 验证、Gemini thinkingBudget=0 — 全部同步进 RedClaw 跨专案知识库。
常見問題
为什么 sportsbook 站要用 SportsEvent schema 而不是 Article？▾
Article 是「人类撰写的文章」。SportsEvent 是「真实赛事实体」。后者让 Google 视赔率为 dynamic facts，可进入赛事 carousel、Knowledge Panel 与 AI Overview。
为什么用 3 层 LLM fallback 而不是直接挑最好的一个？▾
三个现实：Gemini thinking tokens 截 JSON、偶发 region rate limit；Claude 配额尖峰撞墙；DeepSeek 便宜但中文不稳。赛事时效性产品，fallback 链保「永远有产出」。
env 尾端 \n 为什么是灾难级的 bug？▾
剪贴簿、CI/CD、shell 都可能让 env 尾端带 \n。后果：API 「key not valid」、LLM 静默回空、Firestore SA key 解析失败。sanitize-env.ts 在 build 时扫，发现就 fail。
怎么验证 HK Odds Pick 案例的真实性？▾
四个方式：访问 hkoddspick.com 看赔率页；view-source 看 SportsEvent schema；Google Rich Results Test 验；签 NDA 后开放 repo + pipeline + syncLogs。
这套架构可以复制到其他赛事类产品吗？▾
可以。SportsEvent 适用足球/篮球/F1/电竞等所有 sportsbook 垂直；fallback 与 env 卫生与 vertical 无关。新客户差异：赔率 API / 因子定义 / 在地化 schema。2-3 周上线。
AI 因子模型用了什么 6 个因子？▾
赛马 6 因子：实时赔率走势、场地适性、骑师成绩、马匹状态、血统、天气。每因子独立 prompt，LLM 整合。