用途:为指定国家/市场与日期范围整理公开列出的足球转播信息,输出带当地日期时间、时区、球队、赛事、频道和采集时间的赛程指南。
主要能力:通过 Crawlora 的 FotMob 相关工具获取有效市场代码、某市场的电视指南、频道列表和比赛发现;可按日期、球队、赛事或频道在本地筛选赛程,并按比赛 ID 与市场去重,保留多个已列出频道。
使用方式:设置 CRAWLORA_API_KEY;已连接时优先使用 Crawlora MCP 工具,否则使用 scripts/crawlora.sh,它向 https://api.crawlora.net/api/v1 发送 x-api-key。先调用 fotmob_tv_guide_countries 获取有效市场代码(这些是提供商代码,不等于 ISO 代码转换),再为该国家和明确时区请求 fotmob_tv_guide,仅暴露当前七天窗口;频道发现同样只针对该市场当周窗口。示例:scripts/crawlora.sh /fotmob/tv-guide-countries;scripts/crawlora.sh /fotmob/tv-guide country=gb timezone=Europe/London;scripts/crawlora.sh /fotmob/tv-guide-channels country=gb。
限制与边界:认证错误应停止,429 需退避,瞬时上游失败可重试一次;按范围与额度限制页数和调用。超出返回窗口的日期应标记为未覆盖,不得平移日期或声称存在更长赛程。国家频道列表不代表用户订阅或设备可观看;返回的公开联盟元数据不保证免费直播、可播放视频、包含在订阅内、设备兼容或可绕过地域限制。不得编造流媒体 URL,不得擅自注册、购买订阅或设置通知。频道不跨市场通用。赛程与转播可能变化;指南时间与刷新比赛时间不一致时应展示差异和时间戳。缺失频道列表不能证明比赛在其他地方未转播。