流媒体可观看情况比较

安装指南

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

什么是

流媒体可观看情况比较使用 Crawlora JustWatch 数据，查找并比较指定市场中电影、节目、季和集的观看渠道。它可以按国家和提供商创建候选清单，同时区分订阅、租赁、购买、免费观看和含广告的方案。
此技能注重谨慎匹配标题、使用特定国家/地区的提供商数据，并明确证据的局限性。Openclaw Skills 用户可以生成实用的比较结果，而不会将节目级别的方案视为某集可观看的证明，也不会将空搜索结果视为某个标题在任何地方都无法观看的证明。

应用场景

查找某部电影或节目在一个或多个国家/地区的可观看渠道。
在选择服务前比较不同地区目录中的流媒体提供商。
创建候选清单，分别列出订阅、租赁、购买、免费和含广告的方案。
使用特定集的身份信息，检查某一季或某一集。
准备地区可观看情况矩阵，列出价格、货币、呈现方式、来源和观测时间。
找出缺失的证据，例如套餐是否包含该内容、租赁时长或地区限制未知。

工作原理

确定所需的标题、发行年份、媒体类型、国家/地区、首选提供商、语言和呈现要求。
在相关国家/地区和语言下搜索 JustWatch，然后核实标题、年份和类型。保留原始 JustWatch ID 和规范标题 URL；不要替换为 IMDb 或 TMDB ID。
分别发现每个国家/地区的提供商。将提供商目录中存在该服务与已确认所选标题可观看区分开来。
使用经过验证的原始标题 ID 获取方案。每次调用最多请求五个国家/地区代码；将更大的市场集合拆分，并记录请求失败的国家/地区。
若要研究特定季或集，先获取该节目的季列表和该季的集列表，然后使用返回的集 ID 查询方案。
按国家/地区、提供商、标题或集的范围、变现类型、呈现方式、价格、货币、提供商链接和观测时间整理方案。
提供比较矩阵和实用候选清单，注明方案依据、来源和时间，以及尚未确认的条件。将错误、空结果和 404 响应视为有限证据，而非无法观看的确凿证明。

配置指南

在环境中设置 Crawlora API 密钥。连接 Crawlora MCP 工具时优先使用这些工具；否则使用捆绑的 scripts/crawlora.sh 辅助脚本。有关端点方法和参数，请参阅 reference/endpoints.md。
export CRAWLORA_API_KEY="your_crawlora_api_key"
scripts/crawlora.sh /justwatch/search query="Inception" country=US language=en limit=5
scripts/crawlora.sh /justwatch/providers country=US
验证原始 JustWatch 标题 ID 后，为相关国家/地区请求方案：
scripts/crawlora.sh /justwatch/title/offers id="$TITLE_ID" countries=US,GB language=en
检查应用程序 code 以及 HTTP 状态；响应负载位于 data 中。遇到身份验证错误时停止，遇到 HTTP 429 时退避等待，上游暂时性故障时重试一次。请求和分页内容应保持在所需范围和额度预算内。

数据架构

围绕标题或剧集以及特定国家/地区的方案组织比较结果。将来源标识符和时间戳作为独立字段保留，不要将它们合并。
Field Meaning
标题身份 已验证的标题、发行年份、媒体类型和原始 JustWatch ID（电影为 tm…，节目为 ts…；剧集为 tse…）
来源元数据 规范标题 URL、公开来源元数据、来源日期以及观测或抓取时间
市场 国家/地区代码，以及特定国家/地区的提供商标识符和简称或技术名称
方案 原始变现类型、呈现方式、价格、货币和提供商链接
范围 电影、节目、季或特定剧集；不要将相关 ID 视为可互换
证据缺口 国家/地区请求失败、空结果、缺少可用证据，以及来源未确认的条件
将订阅、租赁、购买、免费和含广告的方案分开。不要合并不同货币、整季购买与单集方案，或租赁访问与永久访问。提供商的订阅方案不能证明内容包含在用户的特定套餐中，也不能证明不存在频道附加服务。除非有证据支持，否则应将未知的租赁时长、无障碍选项或音频语言、广告、税费以及地区或设备限制记录为未知。

高级特性

在合并方案前先确认标题身份，有助于避免重拍作品、译名和相似名称造成的错误。
支持按国家/地区发现提供商并获取方案；请求可拆分为批次，每批最多包含五个国家/地区代码。
通过专门的季和集发现工作流程，支持节目、季和集的研究。
保留原始方案类型、呈现详情、货币、提供商链接、来源标识符和观测时间，以便进行可审计的比较。
采用有限重试策略：身份验证失败时停止，429 响应时退避等待，上游暂时性故障时重试一次。
明确说明证据局限：空结果和检索错误不能证明该内容在任何地方都无法观看；此工作流程不会订阅、付款、开始播放，也不承诺绕过地理限制。

name: streaming-availability-comparison description: Compare movie, show, season, and episode viewing offers across countries and providers using Crawlora JustWatch. Use for where-to-watch shortlists or regional availability matrices with subscription, rental, purchase, presentation, title identity, and missing-offer limits preserved.

Streaming availability comparison

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 calls/pages by the requested scope and credit budget. Retain source IDs, URLs, source dates, and observation/crawl times separately.

Find viewing offers for specified titles and markets. Establish the exact title, release year, movie/show/episode scope, countries, preferred providers, language, presentation quality, and user-supplied subscriptions when relevant.

Resolve titles and market-specific offers

Search in the requested country/language and verify title/year/type. Raw JustWatch title IDs are tm… for movies or ts… for shows, not IMDb/TMDB IDs. Similar names, remakes, and translated titles need identity checks before joins. Retain the result's canonical title URL and public source metadata.
Discover providers separately for each country. Provider catalog identity is not proof of availability for the selected title. Preserve country-specific short/technical names and IDs rather than assuming identical plans across markets.
Fetch title offers for the actual raw ID. countries accepts one to five comma-separated country codes per call; split a larger requested set and retain failed countries explicitly. A country format passing validation does not guarantee that every requested provider/title market is available.
For a specific season/episode, discover show seasons and season episodes first, then use the returned tse… episode ID for episode offers. A show-level offer does not establish every season/episode is included. Season IDs and title IDs are not interchangeable despite related numeric strings.
scripts/crawlora.sh /justwatch/search query="Inception" country=US language=en limit=5
scripts/crawlora.sh /justwatch/providers country=US

# Use a verified raw title ID before:
# scripts/crawlora.sh /justwatch/title/offers id="$TITLE_ID" countries=US,GB language=en

Compare viewing conditions and deliver

Keep subscription, rental, purchase, free, and ad-supported offers separate, retaining raw monetization type, presentation, price/currency, provider link, country, title/episode scope, and observation time. A subscription offer is not proof it is included in the user's specific plan or without a channel add-on. Rental duration, accessibility/audio languages, ads, taxes, and regional/device restrictions remain unknown unless supported by returned/source evidence.

Do not combine different currencies, a full-season purchase with a single episode, or a rental with permanent access. Use user-supplied plan costs only on their stated basis; provider catalogs do not supply a full subscription-price model. Return a title-by-country/provider matrix and a practical shortlist with offer basis, source/time, and missing-condition columns. A 404 search/detail or an empty market offer set is a bounded retrieval result, not proof the title is unavailable on every service. Errors remain unavailable evidence. Do not subscribe, pay, start playback, or promise geographic restriction bypass from this research task.

Twitch 类别机会研究
专利格局分析