前言¶

做足球類內容的開發者大概都遇到過兩種麻煩：一是數據東拼西湊，賽程來自一個站、xG 來自另一個站，口徑對不上；二是讓模型自己回憶「皇馬這個賽季場均 xG 是多少」，它會一本正經地編一個數字。球小策足球數據（QiuXiaoCe Football Data）要解決的就是這件事——把權威、結構化的足球賽事事實源做成 Skill，讓智能體按接口取數，而不是憑記憶作答。

下面介紹這個 Skill 是什麼、能幹什麼、怎麼裝、怎麼調，以及幾個實際使用中會踩的點。

這是什麼¶

一句話定位：球小策官方出品的足球大數據與 AI 賽前分析技能包，面向自媒體創作者、數據分析師與球迷，爲大模型智能體提供結構化的賽事事實源。

出品方與維護方是球小策團隊（www.qiuxiaoce.com），Skill 以社區（community）來源發佈在 SkillHub，座標 @user_e5e08891/qiuxiaoce-football-data，分類 professional。官方地址：

https://api.skillhub.cn/user_e5e08891/qiuxiaoce-football-data

包內是一個標準 SKILL.md 主入口加若干 workflow 分支：意圖路由、取數腳本、本地緩存、內容模板、回測模板和自更新腳本。主入口文件只負責理解用戶意圖並分流，不憑自身內容直接回答數據問題。

需要說明一個版本差異：SkillHub 列表頁標註的版本是 2.8.0，而官方版本接口當前返回的最新版本是 2.16.0（發佈日期 2026-10-25）。以官方接口爲準。

覆蓋範圍與核心能力¶

數據覆蓋歐洲五大聯賽（英超、西甲、意甲、德甲、法甲）、歐冠歐聯及全球 80+ 主流聯賽。官方站公開了 88 項賽事數據項，含賽程比分、首發陣容、球員與球隊統計、進階指標、傷停、天氣等，每日自動統計。

能力分兩層：

1、免費層，無需密鑰：實時積分榜、球隊與聯賽中英文檢索、射手榜與助攻榜。
2、需密鑰層：註冊球小策開發者控制台（https://www.qiuxiaoce.com/data-account/ ）可領取 500 點體驗金，解鎖單場全景數據包等更深層數據。

技能包明確列出的指標包括：

• 球隊高階畫像：xG、xGA、戰術指紋
• 球員高階評分：綜合評分、OTI 進攻威脅（OTI 與 OTI-XG 雙口徑）、DII 防守參與度、GIM 比賽影響力，另有狀態、穩定性、疲勞，以及 xG 預期進球、xA 預期助攻
• 單場射門圖：逐次射門座標、單次 xG/PSxG、門將超額表現
• 其他：球隊主場檔案、市場行爲指數、傷停名單、歷史交鋒、轉會記錄、教練履歷、裁判執法風格

單場全景數據包號稱 200+ 維，涵蓋攻防均值、傷停量化折損、歷史交鋒等。技能觸發詞包括：查比賽、今天比賽、明天賽程、積分榜、射手榜、傷停、歷史交鋒、轉會、教練、裁判、賽前分析、幫我預測、出報告、查額度、更新 Skill。

安裝與啓用¶

官方沒有提供一行安裝命令，安裝走「取版本信息 → 下載 → 校驗 → 解壓 → 配密鑰」的流程，全部在代碼塊裏給出。

第一步，取最新版本信息，返回 version、download_url、sha256 校驗清單、文件列表與更新說明：

curl -s "https://www.qiuxiaoce.com/wp-json/abv2-creator/v1/skill/version"

第二步，按返回的 download_url 下載技能包，並用返回的 sha256 逐文件校驗。當前版本的下載地址形如：

curl -LO "https://www.qiuxiaoce.com/wp-json/abv2-creator/v1/skill/download?v=2.16.0"

第三步，解壓到本地技能目錄，保持包內頂層目錄結構，按包內 SKILL.md 完成初始化。包內文件包括 SKILL.md、scripts/（fetch_match.py、query_backtest.py、check_quota.py、update_skill.py、local_store.py）、prompts/、references/、templates/、workflows/。

第四步，配置密鑰。密鑰形如 qxck_xxxxxxxx，可寫入環境變量 QIUXIAOCE_API_KEY，或由技能寫入本地 .qiuxiaoce_key。免費層接口不需要密鑰，可以先跑通再配。

第五步，環境自檢。腳本依賴 Python（≥3.8，僅用標準庫，無需 pip install），每次會話第一次跑腳本前先確認：

python3 --version || python --version

兩條都報錯時不要自己折騰安裝，直接告訴宿主 AI 工具需要 Python 3 環境並配置到 PATH。初始化本地庫（不建也行，首次調用會自動建）：

python3 scripts/local_store.py init

環境類差異如實說明：官方聲明 WorkBuddy、Qoder、Trae 等第三方客戶端的安裝配置、運行環境以及客戶端內 Skill 如何導入加載，屬於第三方軟件自身的通用技能範疇，球小策不提供此類免費人工諮詢與技術支持。只能在網頁對話框裏對話、訪問不了文件系統的環境（豆包、通義千問、Kimi 等），裝不了 Skill，官方建議的替代路徑是直接給 AI 你的 API Key，按接口文檔取數分析。

典型用法¶

接口根地址：

https://www.qiuxiaoce.com/wp-json/abv2-creator/v1

認證方式是請求頭帶上 X-API-Key，按次扣點，60 秒內同請求不重複扣。官方文檔給出的最小可復現示例是今日總覽：

curl -H "X-API-Key: 換成你的Key" \
  "https://www.qiuxiaoce.com/wp-json/abv2-creator/v1/today/digest"

想在調接口前先讀文檔，用公開的文檔接口（無需密鑰）：

# 取全量文檔目錄，返回所有篇章的標題與 slug
curl -s "https://www.qiuxiaoce.com/wp-json/abv2-creator/v1/docs"

# 讀單篇正文
curl -s "https://www.qiuxiaoce.com/wp-json/abv2-creator/v1/docs/{slug}"

人讀版頁面在 https://www.qiuxiaoce.com/creator-docs/{slug}/，完整接口文檔在 https://www.qiuxiaoce.com/data-docs/（48 個數據接口，逐個標註用途、參數、單次價格和真實返回示例）。

取數邏輯是「本地優先」：先查本地 SQLite，未命中或過期才調接口，接口拿到的重要數據必須落庫。遇到報錯先查官方排障手冊 https://www.qiuxiaoce.com/creator-docs/api-error-codes-troubleshooting/，常見碼：

• 401：Key 缺失、格式不對，或已被重置/吊銷（api_key_revoked），到控制台複製最新完整 Key 並同步更新所有已配置該 Key 的腳本與客戶端
• 402：點數不足或已過期，需到 https://www.qiuxiaoce.com/data-service/ 充值
• 403：接口未開放，或權限不足（個別場次報告需要訂閱）
• 404：實體 ID 或接口路徑寫錯
• 429：請求過快，按響應頭 Retry-After 等待後重試

大批量調用前先查一次剩餘點數，避免跑到一半失敗。技能包本身也內置了更新流程（update_skill.py），升級前會逐項對比官方新版和你改過的文件，由你決定直接用新版還是保留改動合併升級。

適用場景與注意¶

適合三類人：做足球自媒體的創作者（賽前研報、文案生成）、做數據科學建模的分析師（需要可覈對口徑的結構化數據）、以及想給智能體接上賽事事實源的開發者。

幾個限制與坑：

1、環境前提硬。需要能讀寫本地文件、能執行命令的桌面或終端類 AI 工具，且要有 Python 3。純網頁對話框用不了 Skill 本體。
2、點數制計費。按次扣點，60 秒內同請求不重複扣；免費層只有積分榜、球隊聯賽檢索、射手榜助攻榜，單場全景包等深層數據要消耗點數。註冊送 500 點體驗金。
3、口徑要先校正。技能要求使用 xG、xGA、OTI、DII 這類指標前先按官方文檔校正口徑，樣本不足要在結論裏註明；缺數據就說缺什麼，不允許用「大概」「可能」糊過去。
4、版本差異。SkillHub 列表頁顯示的版本（2.8.0）落後於官方接口的最新發布（2.16.0），裝完要覈對實際版本號。
5、服務邊界。官方明確聲明不提供投注建議，也不做準確率承諾。技能包內容僅供賽事研究、數據科學建模與足球愛好者交流使用，不構成任何投注或投資建議。
6、數據降級要留意。近期版本增加了降級包標註：單場全景包新增 meta.quality（complete/degraded），降級包會自動退還點數，後臺重建後重取即得完整版。

結尾¶

球小策足球數據的價值在於把「權威 + 結構化 + 可覈對口徑」這件事做成了智能體能直接調用的 Skill，省掉了自己接多個數據源和對口徑的工作量。免費層可以先試，需要深層數據再配 Key。

官方地址：https://www.qiuxiaoce.com
SkillHub 頁面：https://www.skillhub.cn/skills/user_e5e08891/qiuxiaoce-football-data
接口文檔：https://www.qiuxiaoce.com/data-docs/