sports-scores-research

体育赛事与竞技运动研究

通过 Crawlora API，从五个体育数据源获取实时比分、排名、阵容、球员/球队数据、博彩公司赔率，以及耐力运动路线/俱乐部信息，并以标准化 JSON 返回——无需抓取记分牌小组件或统计数据页面。

工具范围与数据流

可选的 Shell 辅助工具是此技能要求运行的唯一命令。它只会向已记录且列入允许列表的 Crawlora 路由发送 GET 请求。调用时，它会读取 CRAWLORA_API_KEY，并通过 HTTPS 将其作为 x-api-key 标头发送到 api.crawlora.net；不会将密钥发送给 ESPN、SofaScore、Strava 或其他体育数据源。它会在 TMPDIR 下短暂写入权限为 600 的 curl 配置文件，并在命令退出时将其删除。它不会检查其他环境变量、枚举文件、安装软件或以提升的权限运行。查询、公开赛事/球员/球队标识符及请求的路由会发送到 Crawlora；请避免使用机密的研究目标。

除了比分/统计数据端点，此技能还涵盖 Cricinfo 和 Sportskeeda 的公开体育编辑内容、文章、维基、问答和视频页面。仅在与用户请求相关时使用这些来源。Strava 路线和俱乐部查询可能会暴露对位置敏感的训练模式；不要用它们来推断某人的住处、日常活动或敏感的位置历史。

何时使用此技能

• “ 现在的比分/状态如何？”
• “显示 的阵容/赛季数据/排名。”
• “ 本赛季的数据如何？”
• “给我 的技术统计表/逐回合记录。”
• “ 和 的交锋历史。”
• 如需详细的赛后足球表现简报，若已安装，请使用 football-match-performance-analysis；此技能仍是查询一般比分/数据的入口。
• 联赛新闻、排名/投票结果或博彩赔率快照（如有提供）。
• “ 的赔率/让分/总分是多少？”或“赢得 的期货赔率是多少？”（DraftKings Sportsbook）。
• “查找 的跑步/骑行/徒步路线”或“查询这个 Strava 俱乐部。”

设置（一次性）

• 免费获取 Crawlora API 密钥（每月 2,000 个额度，无需银行卡）：https://crawlora.net。
• 运行辅助工具前，在环境中设置 CRAWLORA_API_KEY。
• 辅助工具会从环境中读取 CRAWLORA_API_KEY，并向 https://api.crawlora.net/api/v1 发送请求。密钥缺失或无效时返回 401。

工作原理

1. ESPN（大多数体育项目／联赛） — /espn/scoreboard 查询今天或指定日期的比赛（使用运动项目和联赛参数）；/espn/teams / /espn/team 获取球队列表和详情；/espn/team-roster 获取球队阵容；/espn/standings 查询排名；/espn/athlete 查询球员；/espn/game-summary 查询单场比赛的对阵、赔率和技术统计；此外还有 /espn/news 和 /espn/rankings（例如 AP Top 25）。
2. SofaScore（以全球足球为主，涵盖多种体育项目） — 使用 /sofascore/search 查找球队／球员／赛事 ID；使用 /sofascore/live-events 查询当前正在进行的比赛；使用 /sofascore/event（以及 /event-statistics、/event-lineups、/event-incidents、/event-odds、/event-h2h）深入了解单场比赛；还可使用 /sofascore/standings、/sofascore/team、/sofascore/team-events、/sofascore/team-players、/sofascore/player。
3. MLB — 使用 /mlb/schedule 按日期查询比赛和比分；使用 /mlb/game（以及 /mlb/game-boxscore、/mlb/game-play-by-play）查看单场比赛详情；使用 /mlb/standings、/mlb/teams、/mlb/team-roster、/mlb/team-stats；使用 /mlb/player 和 /mlb/player-stats；使用 /mlb/transactions 查询签约、交易和伤病名单变动；使用 /mlb/league-stats 查询联赛排名领先者。
4. Strava — 使用 /strava/routes 浏览路线（需要 sport，可选值为 hiking、road-biking、mountain-biking、trail-running、gravel-biking，以及 country 和 region slug）；使用 /strava/routes/detail（path）查询单条路线；使用 /strava/clubs/{id} 查询俱乐部；使用 /strava/challenges 查询当前公开挑战。
5. DraftKings Sportsbook — 使用 /draftkings/sportsbook/leagues 列出体育项目／联赛（获取 league_id），然后使用 /draftkings/sportsbook/odds（league_id）查询所有即将举行赛事的独赢盘、让分盘和大小盘赔率。使用 /draftkings/sportsbook/live 查询正在进行的赛事；使用 /draftkings/sportsbook/event（以及带有 subcategory_id 的 /event-markets）查看单场赛事的完整市场详情；使用 /draftkings/sportsbook/futures（league_id 和 subcategory_id）查询未来赛事市场。/draftkings/sportsbook/teams 和 /team 用于查询球队。

完整的端点列表、方法和参数请参阅：reference/endpoints.md。

调用 API

# ESPN scoreboard + team:
scripts/crawlora.sh /espn/scoreboard sport=basketball league=nba | jq '.'
scripts/crawlora.sh /espn/team-roster sport=basketball league=nba team=lal | jq '.'

# SofaScore live + match detail:
scripts/crawlora.sh /sofascore/live-events sport=football | jq '.'
scripts/crawlora.sh /sofascore/event id=<event-id> | jq '.'

# MLB:
scripts/crawlora.sh /mlb/schedule date=2026-08-10 | jq '.'
scripts/crawlora.sh /mlb/player-stats id=<mlb-id> group=hitting | jq '.'

# Strava:
scripts/crawlora.sh /strava/challenges | jq '.'
scripts/crawlora.sh /strava/routes sport=hiking country=<country-slug> region=<region-slug> | jq '.'

# DraftKings Sportsbook odds:
scripts/crawlora.sh /draftkings/sportsbook/leagues | jq '.'
scripts/crawlora.sh /draftkings/sportsbook/odds league_id=<league-id> | jq '.'

所有请求都使用 scripts/crawlora.sh；它可以避免将 API 密钥暴露在命令行参数中。

端点参考

请参阅 reference/endpoints.md，了解此技能使用的所有 ESPN、 SofaScore、MLB、Strava 和 DraftKings Sportsbook 端点。

示例

• 实时赛事追踪： 按间隔轮询 /espn/scoreboard 或 /sofascore/live-events， 并在比分变化时即时报告。
• 赛前简报： /sofascore/event-h2h（历史交锋）+ /draftkings/sportsbook/odds 或 /sofascore/event-odds（市场预期）+ 两支球队的 /sofascore/team-events（近期表现）。
• 赛后表现简报： 如果已安装，请使用 football-match-performance-analysis，根据 SofaScore 的统计数据、赛事事件和阵容 生成附有来源说明的叙述。
• 赛季数据领先者： 使用 /mlb/league-stats 或 /espn/rankings 查询 表现最佳者，然后使用 /mlb/player-stats / /espn/athlete 查看详情。
• 阵容／交易动态追踪： 使用 /mlb/team-roster + /mlb/transactions 追踪 本周新增或离队的球员。
• 冠军赔率追踪： 使用 /draftkings/sportsbook/futures 查询联赛冠军／奖项赔率， 并与 /espn/rankings 的媒体共识进行比较。

注意事项和限制

• **积分／成功后付费：**仅在返回 2xx 时计费；免费套餐每月 2,000 积分。 在 https://crawlora.net 获取密钥。
• 仅限公开数据——公开的排行榜／统计页面；赔率仅供参考， 不提供博彩服务。
• **安全性：**密钥仅保存在 CRAWLORA_API_KEY 中——切勿将其硬编码、放入查询参数或提交到代码库。
• ESPN 和 SofaScore 涵盖许多体育项目／联赛，可通过 sport／league 参数指定——在假定某个联赛受支持之前，请先查看 reference/endpoints.md 中接受的值。
• 实时比分端点会按照数据源自身的更新频率反映信息——应定期轮询， 不要假定数据会在一秒内更新。
• Strava 的 country／region 是平台专用的 slug，不是自由文本名称——工具架构中未列出 slug 的确切格式；如果 /strava/routes 返回 404，请在 crawlora.net/docs 或游乐场 验证可用值——/strava/challenges 无需参数，是安全的起点。

Cricinfo 和 Sportskeeda 的编辑内容与体育数据

Cricinfo 提供公开的板球记分卡、解说、球员资料、纪录和文章； 使用其发现端点查找可用的锦标赛和系列赛。这些是编辑内容／数据提供方的快照， 并非官方联赛记录。

Sportskeeda 还提供新闻／文章、作者和主题相关内容、支持的足球及其他体育数据页面， 以及社区和媒体页面。请查看端点参考，了解各路由对联赛、版块和标识符的 具体要求；选择足球视图前，使用 sportskeeda_football_options 查找选项。编辑内容中的 阵容深度图和新闻报道不是官方的名单公告，也不是实时比分信息源。 不要将 ESPN／SofaScore ID 用于 Sportskeeda。

scripts/crawlora.sh /sportskeeda/football-options

分析 FotMob 球员／足球数据时，请使用 fotmob-research；查询 Flashscore 或 LiveScore 比赛时，如果已安装，请使用 multi-sport-match-research。此处捆绑的辅助工具 仅保留其自身端点参考中列出的数据提供方。