名称： odds-api-io
描述： 查询 Odds-API.io 以获取体育赛事、博彩公司和投注赔率（例如，“国际米兰对阵阿森纳的赔率是多少”、“获取 Paddy the Baddie 对阵 Gaethje 的赔率”）。当需要调用 Odds-API.io v3 API 或解析其响应时使用；需要用户提供 API 密钥。

Odds-API.io

概述

使用 Odds-API.io 搜索赛事并通过赛事 ID 获取赔率。此技能包含一个简单的 CLI 助手和一个简明的端点参考。

快速工作流

1. 通过 ODDS_API_KEY 环境变量或 --api-key 参数提供 API 密钥（切勿将其存储在此技能中）。
2. 如有需要，先查找支持的体育项目和博彩公司。
3. 搜索赛事以获取其 ID。
4. 使用指定的博彩公司列表获取该赛事的赔率。

# 1) 列出支持的体育项目和博彩公司
python3 odds-api-io/scripts/odds_api.py sports
python3 odds-api-io/scripts/odds_api.py bookmakers

# 2) 搜索赛事
python3 odds-api-io/scripts/odds_api.py search --query "Inter vs Arsenal" --sport football

# 3) 为选定的赛事 ID 获取赔率
python3 odds-api-io/scripts/odds_api.py odds --event-id 123456 --bookmakers "Bet365,Unibet"

# 可选：一步完成搜索并获取赔率
python3 odds-api-io/scripts/odds_api.py matchup --query "Inter vs Arsenal" --sport football --bookmakers "Bet365,Unibet"

CLI 助手

使用 scripts/odds_api.py 进行 API 调用。全局标志（如 --api-key 和 --dry-run）需在子命令之前传递。在测试时若无密钥，建议使用 --dry-run 来预览请求 URL。对 odds 或 matchup 子命令使用 --summary 参数可获得简洁的输出。

参考材料

加载 references/odds-api-reference.md 以获取基础 URL、端点摘要和响应字段说明。