足球观赛指南

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install football-viewing-guide
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 football-viewing-guide。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

足球观赛指南使用 Crawlora 的 FotMob 市场、赛程、频道和比赛发现数据，帮助用户查找所在国家/地区公开列出足球赛事转播的平台。它可按日期、球队、赛事或频道筛选可用赛程，并将当地开球时间与 UTC 时间、比赛详情及来源信息一并呈现。
此 Openclaw Skills 工具旨在报告来源列出的信息，而非保证用户拥有观赛权限。频道被列出并不表示比赛包含在用户的订阅中、可在其设备上播放，或不受地理限制。

应用场景

查找指定国家/地区某场足球比赛已列出的频道。
汇总当前七天赛程窗口内的转播频道。
按偏好的球队、赛事、日期或已列出的频道筛选比赛。
比较受支持市场的转播列表，但不要假设其频道或转播权可以互换。
判断赛程为空还是数据请求失败。
分享实用观赛指南，包含当地开球时间、时区、比赛链接和数据采集时间。

工作原理

收集观众所在国家/地区或市场、IANA 时区、偏好的球队或赛事，以及请求的日期范围。
使用 fotmob_tv_guide_countries 查找有效的市场代码；使用返回的提供商代码，不要猜测基于 ISO 的代码。
为所选国家/地区和明确指定的时区获取 fotmob_tv_guide。该端点涵盖当前七天窗口，不接受任意日期范围。
如需匹配频道或创建特定频道指南，则请求同一市场和当前窗口的频道发现数据。
在本地按日期、球队、赛事或已列出的频道筛选返回的赛程。必要时通过搜索、比赛列表或比赛详情核实有歧义的球队或赛事。
按比赛 ID 和市场去重，同时保留所有已列出的频道。尽可能保留 UTC 和返回的当地时间、来源 ID 和 URL、来源日期及检索时间。
每场比赛显示一行，包含当地日期和时间、时区、球队、赛事、市场、已列出的频道、可用的比赛或来源链接，以及采集时间。标明时间差异并说明赛程覆盖范围限制。

配置指南

将 CRAWLORA_API_KEY 设置为有效的 Crawlora API 密钥。
如有可用的 Crawlora MCP 工具，优先使用。否则使用随附的 scripts/crawlora.sh 封装脚本，该脚本会将密钥发送到 https://api.crawlora.net/api/v1。
查阅 reference/endpoints.md，了解准确的端点方法和参数。
查找受支持的市场代码，然后使用观众的 IANA 时区请求指南。仅在相关时请求频道发现数据。
export CRAWLORA_API_KEY="your-crawlora-api-key"
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

数据架构

指南围绕比赛和所选市场组织结果。保留来源提供的字段，不要推断缺失数据。
数据元素 处理方式
市场 使用国家/地区发现返回的提供商代码；频道因市场而异。
比赛标识 保留比赛 ID，并按比赛 ID 加市场去重。
赛程 保留 UTC 时间、返回的当地时间、日期和 IANA 时区。不要在不同日期重复使用固定 UTC 偏移。
比赛详情 保留球队名称、赛事和所有返回的频道名称。
来源信息 保留提供的来源 ID、URL、来源日期及检索或采集时间。
覆盖范围 指南端点提供当前七天窗口；报告窗口之外的请求日期时，应标明未覆盖。
状态 区分受支持市场的空赛程与获取失败。
未指定特殊输出文件或持久化存储架构。将返回的赛程和频道列表视为来源数据：比赛和转播可能会变化，未列出频道并不能证明该比赛在其他地方无法观看。

高级特性

连接后使用 Crawlora MCP 工具，并提供内置 shell 脚本 API 作为备用方案。
验证提供商专用的市场代码，而不假设国家/地区缩写可直接使用。
遵守当前七天赛程边界；对未覆盖日期如实报告，不调整请求，也不暗示覆盖范围更广。
根据请求范围和额度预算限制调用次数和分页数量。
除 HTTP 状态外，还检查应用层的
code
，并从
data
负载读取结果。
遇到身份验证错误时停止；HTTP 429 时退避；上游出现暂时性故障时重试一次。
保留来源信息以及 UTC 和当地时间，以便审计并处理夏令时转换。
对比指南与刷新后的比赛时间，若不一致则附上时间戳报告，不进行静默调整。
不会编造流媒体 URL，也不会发起订阅、购买或通知，除非用户要求执行这些操作。

name: football-viewing-guide description: Build a dated, country-specific football broadcast guide using Crawlora FotMob market, channel, schedule, and match discovery. Use to find listed channels for a match or shortlist football broadcasts in the current seven-day window, without promising streaming access.

Football viewing guide

Access and scope

Set CRAWLORA_API_KEY to your Crawlora key. Prefer the listed Crawlora MCP tools when connected; otherwise use the bundled scripts/crawlora.sh, which sends x-api-key to https://api.crawlora.net/api/v1. Read reference/endpoints.md for exact methods and parameters. Check application code as well as HTTP status; payloads are inside data. Stop on authentication errors, back off on 429, and retry a transient upstream failure once. Bound pages and calls by the requested scope and credit budget. Preserve source IDs, URLs, retrieval times, and source dates where supplied.

Find the publicly listed football broadcasts for the requested market and dates. Start with the viewer's country/market, IANA timezone, preferred teams or competitions, and date window. A country-specific channel listing does not establish that the user can watch it with their subscriptions or device.

Discover the market and schedule

Call fotmob_tv_guide_countries for valid market codes. These are provider codes, not an ISO-code transformation: some values differ from a country's expected abbreviation. Use the returned code instead of inventing one.
Request fotmob_tv_guide for that country and explicit timezone. It exposes the current seven-day window, without an arbitrary past/future date argument. If requested dates lie outside the returned window, report them uncovered; do not shift dates or claim a longer schedule exists.
Channels discovery lists channels attached to that same market's current seven-day window; it is not a complete national channel or rights-holder directory. Request it only for channel matching or a channel-specific guide.
Filter the actual schedule locally by date, team, competition, or listed channel. Preserve match IDs, UTC time, returned local times, competition, teams, and all returned channel names. Channels are not interchangeable across markets. Verify a same-named team/fixture via search, matches, or match detail if needed.
scripts/crawlora.sh /fotmob/tv-guide-countries

# Select a discovered market code and the viewer's timezone:

scripts/crawlora.sh /fotmob/tv-guide country=gb timezone=Europe/London
scripts/crawlora.sh /fotmob/tv-guide-channels country=gb

Deliver a practical schedule with boundaries

Return one row per fixture with local date/time and timezone, teams, competition, market, listed channels, match/source link when returned, and collection time. Retain UTC time for joins and daylight-saving transitions; do not reuse a fixed UTC offset across the requested window. Deduplicate by match ID plus market, preserving multiple listed channels rather than counting them as separate games. If guide time and refreshed match time disagree, show the discrepancy and timestamp instead of silently reconciling it. Broadcast listings and fixtures may change.

Separate a supported market with an empty current schedule from a failed fetch. Missing channel listings do not prove a match is untelevised elsewhere. Returned public affiliate metadata is not guaranteed free streaming, a playable video, subscription inclusion, device compatibility, or permission to bypass geographic restrictions. Link an actually returned public page when useful; never fabricate stream URLs. Do not sign up, purchase subscriptions, or schedule notifications unless the user requests those actions.

医疗服务提供者研究
优惠发现研究