mcpField
M
movie-tv-research

movie-tv-research

github.com/crawlora-org生产力146 次安装2 天前更新
代码仓库

关于 movie-tv-research

movie-tv-research 是通过 Crawlora 查询影视元数据、评分、流媒体选项、评论和票房数据的技能，适用于影视研究与比较，并将七个来源的数据整理为 JSON。

主要功能

  1. 01查询片名、演职员信息
  2. 02获取评分与评论
  3. 03按平台查找流媒体选项
  4. 04票房榜单与数据比较
  5. 05查找相似影视作品

适用场景

  1. 01查询电影或剧集的演职员
  2. 02比较影评人与观众评分
  3. 03查找流媒体和租赁选项
  4. 04分析系列作品的票房趋势

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/crawlora-org/crawlora-skills --skill movie-tv-research

安装后在 Claude Code 中输入/movie-tv-research确认已加载。

附带文件reference/endpoints.mdscripts/crawlora.sh

详细介绍

电影与电视研究

通过 Crawlora API，从七个影视数据源获取标题元数据、演职人员、评分、流媒体可用情况、评论和票房数据，并以标准化 JSON 格式返回——无需抓取 IMDb 页面或解析流媒体提供商的 HTML。

何时使用此技能

  • “<标题>有哪些演员／是谁导演的？”／查询演职人员和演职员表。
  • “<标题>在 IMDb／Rotten Tomatoes／Metacritic／Letterboxd 上的评分是多少？”
  • “在哪里可以观看流媒体版的<标题>？”（JustWatch 会列出提供商的内容。）
  • “<标题>的票房表现如何？”（Box Office Mojo）。
  • “查找与<标题>类似的作品”或“现在有什么热门作品？”
  • 比较影评人与观众的评论；分析系列／类型的票房表现。

设置（一次性）

  • 在 https://crawlora.net 获取免费的 Crawlora API 密钥（每月 2,000 积分，无需银行卡）。
  • 运行辅助程序前，在环境中设置 CRAWLORA_API_KEY。
  • 辅助程序会从环境中读取 CRAWLORA_API_KEY，并向 https://api.crawlora.net/api/v1 发送请求。缺少密钥或密钥无效 → 401。

工作原理

根据任务选择数据源：

  1. 身份信息与演职员表（IMDb / TMDB） — 先搜索：/imdb/search 或 /tmdb/search；然后获取详情：/imdb/title（需要 IMDb id）或 /tmdb/movie/{id} / /tmdb/tv/{id}。演职人员：/imdb/title/credits 或 TMDB 的标题数据。人物页面：/imdb/name、/tmdb/person/{id}。
  2. 评分与评论 — Rotten Tomatoes（/rottentomatoes/movie、/series、 /movie/reviews）、Metacritic（/metacritic/movie/{slug}、 /critic-reviews、/user-reviews）、IMDb（/imdb/title/reviews）、 Letterboxd（/letterboxd/film/{slug}、/reviews、/rating-histogram）。
  3. 在哪里观看（JustWatch） — /justwatch/search → 原始 id，然后调用 /justwatch/title/offers（或 /title-by-id + /title/offers）获取各提供商的流媒体／租赁／购买链接；调用 /justwatch/title/similar 获取推荐。
  4. 票房（Box Office Mojo） — 调用 /boxofficemojo/title 或 /release 获取单部影片的票房数据；调用 /weekend/domestic、/year/domestic、 /year/worldwide 获取排行榜；调用 /franchise / /genre / /brand 获取汇总数据；调用 /showdown 正面对比两部影片的上映表现。

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

调用 API

# Identity + scores:
scripts/crawlora.sh /imdb/search query="Dune Part Two" | jq '.'
scripts/crawlora.sh /tmdb/search query="Dune Part Two" | jq '.'
scripts/crawlora.sh /rottentomatoes/search query="Dune Part Two" | jq '.'

# Streaming availability:
scripts/crawlora.sh /justwatch/search query="Dune Part Two" | jq '.'
scripts/crawlora.sh /justwatch/title/offers id=<raw-justwatch-id> | jq '.'

# Box office:
scripts/crawlora.sh /boxofficemojo/title id=<mojo-title-id> | jq '.'

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

端点参考

请参阅 reference/endpoints.md，了解此技能使用的所有 IMDb、TMDB、 JustWatch、Letterboxd、Rotten Tomatoes、Metacritic 和 Box Office Mojo 端点。

示例

  • 影评人和观众评分差距： 对同一标题，同时调用 /metacritic/movie/{slug}（影评人 Metascore 与用户评分）和 /rottentomatoes/movie（Tomatometer 与观众评分）。
  • 查询所有观看渠道： 调用 /justwatch/search → /justwatch/title/offers 列出各提供商的所有订阅／租赁／购买选项及价格。
  • 系列票房趋势： 调用 /boxofficemojo/franchise 获取每部作品的首映票房和累计票房，并按时间顺序排序。
  • 匹配品味： 调用 /letterboxd/film/{slug}/similar 或 /tmdb/movie/{id}（TMDB 包含推荐），查找“类似作品”。

注意事项与限制

  • 积分／成功后收费： 仅对 2xx 响应计费；免费套餐每月 2,000 积分。 在 https://crawlora.net 获取密钥。
  • 仅限公开数据 — 公开的标题、评论和票房页面。
  • 安全性： 密钥仅保存在 CRAWLORA_API_KEY 中——切勿将其硬编码、作为查询参数传递或提交到代码仓库。
  • JustWatch 使用自身的原始 GraphQL id（不是 IMDb/TMDB id）——请先通过 /justwatch/search 或 /justwatch/title/by-id 解析。
  • 注明支持分页的结果可分页获取——传入 page 以遍历较长的列表 （评论、排行榜、作品目录）。

评论

支持 Markdown