Football Odds History

@pipeworx/football-odds-history

来自体育博彩公司的历史足球（soccer）比赛结果和赔率——包括胜平负、 大小 2.5 球和亚洲让球——覆盖 22 个主要欧洲联赛，数据追溯至 1993/94 赛季； 另覆盖 16 个国家，数据大致追溯至 2012/13 赛季。

属于 Pipeworx 的一部分——一个将 AI Agent 连接到 1866+ 个实时数据源的 MCP 网关。这是独立、非官方的集成，与上游提供商无关联、未获其认可，也并非由其发布。

工具

• list_odds_leagues() — 列出此工具包覆盖的所有联赛代码，以及名称、国家和文件布局（主要联赛：每个赛季一个文件；额外联赛：一个文件涵盖所有赛季）。
• match_odds(league, season?, team?, date_from?, date_to?, limit?, bookmakers?) — 查询一个联赛 + 赛季的比赛结果和赔率（22 个主要联赛必须指定赛季；16 个额外联赛国家可不指定，因为其单个文件已涵盖所有赛季）。可选球队 / 日期筛选条件。
• team_results(team, league, seasons?, limit?, bookmakers?) — 查询某支球队在单个联赛多个赛季中的比赛结果和赔率，按时间从新到旧排列。 对于主要联赛，如果未提供 seasons，则默认为最近的 5 个赛季。

响应大小。 一个完整赛季有 380 场比赛；单场比赛的完整赔率详情（所有博彩公司、初盘和终盘）可达数 KB——默认情况下，内容太多，不适合直接提供给模型。两个工具默认都返回精简格式：Pinnacle、Bet365 和市场平均值 / 最高值的终盘胜平负赔率；市场终盘大小 2.5 球赔率；以及亚洲让球终盘的盘口（即数字，不包含逐家博彩公司明细）；不包含裁判 / 半场 / 射门、角球、黄牌和红牌数据。limit 用于限制返回的比赛数量（默认值为 50，最大值为 400）；响应始终会报告 match_count（已返回数量）、total_matches（符合筛选条件的所有记录数）、truncated，以及在结果被截断时用于说明如何缩小结果范围的参数名称 narrow_hint。传入 bookmakers: "all" 可获取所有博彩公司各自的初盘 + 终盘赔率及完整比赛详情；传入 bookmakers: ["B365","PS"] 则只获取指定代码对应博彩公司提供的这些详情。每个响应都会说明返回的数据格式（odds_form / odds_form_detail）。

每项赔率都会标明博彩公司，以及对应的是初盘还是终盘；较早的赛季所包含的博彩公司列较少（大约在 2019/20 赛季之前甚至没有终盘赔率）——响应只包含源赛季实际提供的数据，不会伪造任何数值。

身份验证

无需密钥。上游服务免费且无需注册。

数据源

• football-data.co.uk（由 Joseph Buchdahl 汇编）——涵盖 22 个欧洲主要联赛和另外 16 个国家的历史足球比赛结果及博彩公司赔率，免费且无需密钥。该网站要求注明来源；每个工具响应都会将 football-data.co.uk 列为来源。

各赛季的列覆盖范围有所不同——该网站会随时间增加博彩公司和明确的收盘赔率，因此，1990 年代的文件所含赔率列远少于 2020 年代的文件，而且有少数非常早期的组合（例如，尚未开始跟踪时的英格兰全国联赛）根本不存在。本工具包会读取特定赛季文件中实际存在的列，而不假定固定布局；如果请求的网站不支持某个组合，会返回明确错误，而不是悄无声息地给出空结果。

两个博彩公司代码对应同一个名称，是结构原因而非数据错误：在所有已观察到的赛季中，Pinnacle 的 1X2 赔率列为 PS*，而大小球和亚洲让球列则为普通的 P*。两者都标记为“Pinnacle”——每个条目都会保留原始列代码，因此需要时仍可区分。

2000 年代中期之前的日期在源文件中使用两位数年份；本工具包会应用显而易见的转换规则（<=30 → 20xx，否则为 19xx），这对于该网站实际的 1993/94 至今的时间范围是安全的。

该网站各国页面是唯一列出有效联赛/赛季组合的地方；由于没有机器可读的索引，本工具包中的 list_odds_leagues 代码列表是通过逐一检查各国页面构建的。如果 football-data.co.uk 添加了联赛，应重新核实。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "football-odds-history": {
      "url": "https://gateway.pipeworx.io/football-odds-history/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/football-odds-history/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、discover_tools、search_within、remember/recall 和网关范围内的其他工具。因此，你看到的工具数量会多于此表：单个工具包端点目前除了工具包自身的工具，还会列出约 30 个共享工具。连接的 initialize 响应会说明其确切范围，并且是当天情况的权威答案。

这是有意为之，并非意外的多路复用。元工具可以让范围受限的连接通过 ask_pipeworx 跨整个目录路由，从而回答本工具包无法覆盖的问题，而无需你再添加第二个 MCP 服务。目前无法挂载不含这些元工具的工具包端点；如果额外的架构定义占用的上下文超过了路由带来的价值，请改为只连接一次完整网关，而不是连接多个工具包端点。

也可以连接完整的 Pipeworx 网关，直接列出每个工具包的所有工具，而不只是这个工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都会连接到同一个网关和相同的 1866+ 个数据源。唯一的区别是哪些工具包的工具会被直接列出；无论连接哪个端点，ask_pipeworx 都能访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/list_odds_leagues \
  -H 'Content-Type: application/json' \
  -d '{}'

首次调用无需账户。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/list_odds_leagues。查找工具：使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。

独立运行（无需网关账户）

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需通过网关中转：

{
  "mcpServers": {
    "football-odds-history": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-football-odds-history"]
    }
  }
}

也可以直接运行，以确认其能够启动：

npx -y @pipeworx/mcp-football-odds-history

它通过 stdin/stdout 使用 MCP 通信，并响应 initialize/tools/list/tools/call，但仅提供此工具包的工具——不包含上述网关连接额外提供的共享元工具。数据源和工具相同，但没有 ask_pipeworx 路由。

使用 ask_pipeworx

你也可以用通俗英语提问，而不是直接调用工具——这既适用于上述工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Football Odds History data" })

网关会选择合适的工具并自动填入参数。

More

• Docs and guides
• pipeworx.io

License

MIT