电影票房比较

安装指南

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

什么是

电影票房比较可根据通过 Crawlora 获取的 Box Office Mojo 数据，构建以证据为基础的比较。它支持可比影片简报、国内与国际市场构成、上映窗口分析和系列影片表现分析，同时保留每部影片的身份、上映范围、货币、统计口径和来源历史。
此技能强调同类比较：周末预测值与最终数据分别处理，不把终身总票房与发行组票房相加，并将缺失数据视为覆盖范围缺口，而不是零。作为 Openclaw Skills 中用于结构化研究的技能之一，它也提醒用户不要把院线票房视为制片厂利润，也不要根据不完整的成本数据推断投资回报率。

应用场景

使用明确的一组影片和一致的票房口径，制作可比影片简报。
在日期和上映档期一致时，比较国内、国际和全球院线表现。
使用网站返回的年份、周次和日期范围，查看周末表现或上映窗口比较。
在发现可用维度后，分析系列影片、类型、市场或年份数据集。
调查重映和发行组，同时避免将其与影片终身总票房混为一谈。
记录统计截止时间、缺失字段和来源覆盖范围的差异，以支持可靠分析。

工作原理

明确比较范围和口径，例如周末票房还是终身票房、首轮上映还是重映，以及预测值还是更新后的数据。
筛选前先发现可用的数据集维度，然后搜索相关记录，并在有帮助时请求完整数据。
使用返回的 ID 和链接确认每部影片、每次上映和每个发行组。将影片 ID (tt…)、上映 ID (rl…) 和发行组 ID (gr…) 视为不同实体。
在可用时通过 Crawlora MCP 工具获取相关榜单或详细记录，或使用随附的 scripts/crawlora.sh 脚本。
保留来源 ID、URL、来源日期、抓取或观测时间、货币、地区、单位、上映范围和统计日期。
检查应用层面的 code 以及 HTTP 状态码，并从 data 字段读取结果。遇到身份验证错误时停止，遇到 429 时退避等待，暂时性的上游故障重试一次。
只比较兼容的数据。仅在日期和上映档期一致且全球票房分母非零时计算国内或国际市场占比；披露差异，不要强行使总额相符。
提供影片身份与上映记录表，以及展示范围、日期、来源、票房数据、公式、覆盖情况和缺失字段的比较表。

配置指南

将 CRAWLORA_API_KEY 设置为你的 Crawlora API 密钥。连接了 Crawlora MCP 工具时优先使用这些工具；否则使用随附脚本，该脚本会在 x-api-key 标头中将密钥发送至 https://api.crawlora.net/api/v1。
查阅 reference/endpoints.md，了解所需端点支持的确切方法和参数。
在请求的范围和积分预算内执行请求。检查 HTTP 状态码和应用层 code；有效负载位于 data 中。
export CRAWLORA_API_KEY="your-crawlora-api-key"
scripts/crawlora.sh /datasets/boxofficemojo/facets facet=genre_names
scripts/crawlora.sh /datasets/boxofficemojo/search q="science fiction" hydrated=true page=1 page_size=10
scripts/crawlora.sh /boxofficemojo/weekend/domestic year=2025 week=52
在请求对应的实时详情路由之前，先复制返回的影片或上映 ID 和链接。接受 id、path 或 url 的路由要求且仅要求提供其中一个选项。

数据架构

身份： 数据集影片 ID 使用 IMDb 风格的 tt… 命名空间；上映 ID 使用 rl…；发行组 ID 使用 gr…。请区分这些实体类型。
范围： 分别记录影片、首轮上映、重映、发行组、地理市场和比较口径。影片终身票房数据可能已包含多轮上映。
票房值： 存储报告金额、原始货币标签、数值单位、地区和统计日期。数据集中的票房金额为报告的美元整数，不是美分。
时间与来源： 将来源 ID、来源 URL、来源日期和观测或抓取时间作为单独的元数据保留。保留返回的周末日期范围和数据收集截止时间。
覆盖范围： 记录数据是否已完整获取，并将缺失字段标记为覆盖范围缺口，而非票房为零。
比较结果： 提供影片身份与上映记录表，以及展示范围、日期、来源、票房数据、公式、覆盖情况和缺失字段的表格。
计算限制： 全球票房包含其地理组成部分；不要将国内票房加到全球票房中。仅在日期和上映档期兼容且分母非零时计算市场占比。未经有来源支持的假设，不要进行货币换算或通胀调整。

高级特性

在应用精确的数据集筛选条件之前，先发现系列、品牌、类型和年份维度。
获取实时详情路由前，先跟进返回的影片和上映链接以确认记录。
将周末预测值与最终观测数据分开，并且只比较连续且兼容的周末。
区分年度榜单指标与终身排名或年份记录；它们的统计口径不可互换。
根据请求范围和 Crawlora 积分预算限制 API 调用和分页；按照文档工作流程处理身份验证错误、速率限制和暂时性故障。
避免重复计算终身票房和发行组票房；报告截止时间差异，不要强行使占比总和等于一。
明确区分院线票房与制片厂净收入或利润；不要仅凭榜单排名、预算或不完整的成本数据推断投资回报率或投资价值。

name: film-box-office-comparison description: Compare theatrical film grosses through Crawlora Box Office Mojo charts, title/release records, and stored data. Use for comparable-film briefs, domestic/international mix, release-window comparisons, or franchise performance with title, release, currency, and reporting basis preserved.

Film box-office 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.

Compare theatrical performance for a selected film set, release window, market, franchise, or genre. Define the comparison basis before retrieving data: weekend/year versus lifetime, original run versus reissues, and reported estimates versus updated figures are different measures.

Resolve titles, release groups, and source scope
Discover stored franchise/brand/genre/year facets before exact dataset filters. Hydrated records can include release groups and market tables; missing hydration or fields are coverage gaps, not zero gross. Store the source/crawl date.
Dataset title IDs use the IMDb-style tt… namespace also used on Box Office Mojo title pages. A release (rl…) or release-group (gr…) ID is a different entity. Copy returned links/IDs before the corresponding live detail route; routes accepting id/path/url require exactly one of those alternatives.
Keep each title's original run, rereleases, release groups, and geographic markets separate. A lifetime title figure can already include multiple runs; adding release-group figures to it double counts revenue. Similar titles and franchise branding do not establish the same film or release.
Weekend endpoints use the site's year/week and returned date range, not a presumed ISO-week conversion. Keep weekend estimates separate from finalized observations and use the same collection cutoff. Annual charts measure that chart's year/basis; they are not interchangeable with lifetime rank/year records.
scripts/crawlora.sh /datasets/boxofficemojo/facets facet=genre_names
scripts/crawlora.sh /datasets/boxofficemojo/search q="science fiction" hydrated=true page=1 page_size=10
scripts/crawlora.sh /boxofficemojo/weekend/domestic year=2025 week=52

# Follow returned title/release IDs before fetching their detail.

Compare equivalent grosses

Keep raw currency labels, numeric units, territories, dates, and reissue scope. Dataset gross amounts are whole reported USD dollars; do not treat them as cents or apply currency/inflation conversion without sourced assumptions. Nominal figures across decades do not establish inflation-adjusted performance.

Where compatible figures are available, compute domestic share as domestic / worldwide and international share as international / worldwide, with nonzero denominators and matching dates/runs. Worldwide already includes its geographic components: do not add domestic to worldwide. If totals differ by reporting cutoff, show the discrepancy rather than forcing shares to sum to one. A weekend drop requires consecutive comparable weekend figures for the same run, not an estimate paired with an unrelated release's finalized figure.

Return an identity/release ledger and comparison table with scope, dates, sources, grosses, formulas, coverage, and missing fields. Theatrical gross is not studio net revenue or profit; budgets alone do not provide marketing, distribution, exhibitor splits, financing, or other revenue/costs. Do not infer ROI or production investment merit from incomplete cost data, chart ranks, or an observed genre sample.

Xbox 游戏研究
航班行程比较