pp-movie-goat
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseMovie Goat — Printing Press CLI
Movie Goat — Printing Press CLI
Prerequisites: Install the CLI
前提条件:安装CLI
This skill drives the binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:
movie-goat-pp-cli- Install via the Printing Press installer:
bash
npx -y @mvanhorn/printing-press install movie-goat --cli-only - Verify:
movie-goat-pp-cli --version - Ensure (or
$GOPATH/bin) is on$HOME/go/bin.$PATH
If the install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.23+):
npxbash
go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/movie-goat/cmd/movie-goat-pp-cli@latestIf reports "command not found" after install, the install step did not put the binary on . Do not proceed with skill commands until verification succeeds.
--version$PATH本技能基于二进制文件运行。在调用本技能的任何命令前,你必须确认CLI已安装。如果未安装,请先执行以下步骤:
movie-goat-pp-cli- 通过Printing Press安装程序安装:
bash
npx -y @mvanhorn/printing-press install movie-goat --cli-only - 验证安装:
movie-goat-pp-cli --version - 确保(或
$GOPATH/bin)已添加到$HOME/go/bin环境变量中。$PATH
如果安装失败(无Node环境、离线等情况),可改用Go直接安装(要求Go 1.23+版本):
npxbash
go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/movie-goat/cmd/movie-goat-pp-cli@latest如果安装后执行提示“command not found”,说明安装程序未将二进制文件添加到中。请在验证成功前不要执行技能相关命令。
--version$PATHWhen to Use This CLI
何时使用本CLI
Use Movie Goat when an agent needs to answer cinephile questions that require combining streaming availability with multi-source ratings. It is the right choice for tonight-picker scenarios, franchise marathon planning, and rated career timelines. It is not the right choice for box-office tracking, review sentiment analysis, or any workflow that needs LLM-style summaries of plot or reviews.
当需要结合流媒体可用性与多源评分来解答电影爱好者的问题时,可使用Movie Goat。它适用于以下场景:挑选今晚观看的影片、规划系列电影马拉松、查看影人评分化的职业时间线。但不适用于票房追踪、评论情感分析,或任何需要LLM风格的剧情/评论摘要的工作流。
When Not to Use This CLI
何时不应使用本CLI
Do not activate this CLI for requests that require creating, updating, deleting, publishing, commenting, upvoting, inviting, ordering, sending messages, booking, purchasing, or changing remote state. This printed CLI exposes read-only commands for inspection, export, sync, and analysis.
请勿针对以下请求激活本CLI:创建、更新、删除、发布、评论、点赞、邀请、订购、发送消息、预订、购买或更改远程状态。本CLI仅提供用于查看、导出、同步和分析的只读命令。
Unique Capabilities
独特功能
These capabilities aren't available in any other tool for this API.
这些功能是其他同类型API工具所不具备的。
Cinephile rituals
电影爱好者专属功能
-
— Pick what to watch tonight from trending titles actually streaming on your services.
tonightUse this when an agent needs a streaming-filtered shortlist; one call replaces tab-bouncing across TMDb/RT/JustWatch.bashmovie-goat-pp-cli tonight --mood thriller --max-runtime 120 --providers netflix,max --region US --json -
— TMDb + IMDb + Rotten Tomatoes + Metacritic ratings for any title in one card.
ratingsUse when an agent needs the canonical multi-source rating for a title; degrades gracefully to TMDb-only if OMDB_API_KEY is unset.bashmovie-goat-pp-cli ratings 550 --json -
— Plan a franchise marathon with watch order, total runtime, and suggested breaks.
marathonUse when planning an event watch; agent can dump the schedule to share with a group.bashmovie-goat-pp-cli marathon "The Avengers" --order release --breaks-every 240 --json -
— Explore any actor or director's full filmography with ratings and chronology.
careerUse when an agent needs a rated chronological filmography; replaces flat IMDb lists with cross-source ratings.bashmovie-goat-pp-cli career "Christopher Nolan" --since 2010 --role director --json -
— Compare two movies or shows side-by-side across ratings, cast, runtime, and streaming.
versusUse when an agent has to pick between two finalists; one command shows where they differ on every axis.bashmovie-goat-pp-cli versus 550 27205 --region US --json -
— List people who appear in 2+ of a person's credits, with count and titles.
collaboratorsUse when an agent is researching a filmmaker's circle; surfaces recurring DPs/composers/actors mechanically.bashmovie-goat-pp-cli collaborators "Christopher Nolan" --min-count 3 --role crew --json
-
— 从符合你流媒体服务的热门影片中挑选今晚观看的内容。
tonight当需要筛选出可流媒体观看的候选影片列表时使用;一次调用即可替代在TMDb/RT/JustWatch之间来回切换的操作。bashmovie-goat-pp-cli tonight --mood thriller --max-runtime 120 --providers netflix,max --region US --json -
— 一站式展示某部影片的TMDb + IMDb + Rotten Tomatoes + Metacritic评分。
ratings当需要获取某部影片的权威多源评分时使用;如果未设置OMDB_API_KEY,会自动降级为仅显示TMDb评分。bashmovie-goat-pp-cli ratings 550 --json -
— 规划系列电影马拉松,包含观看顺序、总时长和建议休息时间。
marathon当需要规划观影活动时使用;可导出日程表分享给群组。bashmovie-goat-pp-cli marathon "The Avengers" --order release --breaks-every 240 --json -
— 查看演员或导演的完整作品列表,包含评分和时间顺序。
career当需要获取评分化的影人时间线作品列表时使用;替代单一的IMDb列表,提供跨源评分信息。bashmovie-goat-pp-cli career "Christopher Nolan" --since 2010 --role director --json -
— 对比两部影片或剧集的评分、演员阵容、时长和流媒体平台。
versus当需要在两部候选作品中做选择时使用;一次命令即可展示两者在各维度的差异。bashmovie-goat-pp-cli versus 550 27205 --region US --json -
— 列出与某影人合作2次及以上的人员,包含合作次数和作品名称。
collaborators当需要研究电影人的合作圈子时使用;自动筛选出重复合作的摄影指导/作曲家/演员。bashmovie-goat-pp-cli collaborators "Christopher Nolan" --min-count 3 --role crew --json
Local state that compounds
可积累的本地状态
-
— Local SQLite watchlist; flag rows that are streamable on your services.
watchlist listUse weekly to surface streamable items from a saved list; eliminates ad-hoc JustWatch checks per title.bashmovie-goat-pp-cli watchlist list --available --providers netflix,max --region US --json -
— Suggest next-watch picks derived from your watchlist's recommendations and similars.
queueUse when an agent needs a fresh queue derived from saved interests; combines local state with API recommendations.bashmovie-goat-pp-cli queue --limit 20 --providers netflix,max --region US --json
-
— 本地SQLite收藏列表;标记出你的流媒体服务上可观看的条目。
watchlist list每周使用一次,从收藏列表中筛选出可流媒体观看的内容;无需逐个在JustWatch上查询。bashmovie-goat-pp-cli watchlist list --available --providers netflix,max --region US --json -
— 根据收藏列表的推荐和相似内容,生成后续观看建议。
queue当需要基于已保存的兴趣生成新的观影队列时使用;结合本地状态与API推荐。bashmovie-goat-pp-cli queue --limit 20 --providers netflix,max --region US --json
Command Reference
命令参考
discover — Discover movies and TV shows with rich filters
- — Discover movies by genre, year, rating, certification, cast, crew, streaming provider, and more
movie-goat-pp-cli discover movies - — Discover TV shows by genre, year, rating, network, and streaming provider
movie-goat-pp-cli discover tv
genres — Get genre lists for movies and TV
- — Get the list of movie genres
movie-goat-pp-cli genres movies - — Get the list of TV genres
movie-goat-pp-cli genres tv
movies — Search and browse movies
- — Get detailed info about a movie including cast, ratings, and streaming availability
movie-goat-pp-cli movies get - — Get movies currently in theaters
movie-goat-pp-cli movies now-playing - — Get current popular movies
movie-goat-pp-cli movies popular - — Search for movies by title
movie-goat-pp-cli movies search - — Get the highest rated movies
movie-goat-pp-cli movies top-rated - — Get movies coming soon to theaters
movie-goat-pp-cli movies upcoming
multi — Multi-search across movies, TV shows, and people
- — Search for movies, TV shows, and people in a single query
movie-goat-pp-cli multi <query>
people — Search and browse people (actors, directors, crew)
- — Get detailed info about a person including their filmography
movie-goat-pp-cli people get - — Get popular people in entertainment
movie-goat-pp-cli people popular - — Search for people by name
movie-goat-pp-cli people search
trending — Get trending movies, TV shows, and people
- — Get trending movies, TV, and people
movie-goat-pp-cli trending all - — Get trending movies
movie-goat-pp-cli trending movies - — Get trending people
movie-goat-pp-cli trending people - — Get trending TV shows
movie-goat-pp-cli trending tv
tv — Search and browse TV shows
- — Get TV shows with episodes airing today
movie-goat-pp-cli tv airing-today - — Get detailed info about a TV show
movie-goat-pp-cli tv get - — Get TV shows currently on the air
movie-goat-pp-cli tv on-the-air - — Get current popular TV shows
movie-goat-pp-cli tv popular - — Search for TV shows by title
movie-goat-pp-cli tv search - — Get the highest rated TV shows
movie-goat-pp-cli tv top-rated
discover — 通过丰富的筛选条件发现电影和剧集
- — 按类型、年份、评分、分级、演员、制作团队、流媒体平台等条件发现电影
movie-goat-pp-cli discover movies - — 按类型、年份、评分、网络平台、流媒体平台等条件发现剧集
movie-goat-pp-cli discover tv
genres — 获取电影和剧集的类型列表
- — 获取电影类型列表
movie-goat-pp-cli genres movies - — 获取剧集类型列表
movie-goat-pp-cli genres tv
movies — 搜索和浏览电影
- — 获取电影的详细信息,包括演员、评分和流媒体可用性
movie-goat-pp-cli movies get - — 获取当前在映的电影
movie-goat-pp-cli movies now-playing - — 获取当前热门电影
movie-goat-pp-cli movies popular - — 按标题搜索电影
movie-goat-pp-cli movies search - — 获取最高评分电影
movie-goat-pp-cli movies top-rated - — 获取即将上映的电影
movie-goat-pp-cli movies upcoming
multi — 跨电影、剧集和影人进行多维度搜索
- — 通过单一查询搜索电影、剧集和影人
movie-goat-pp-cli multi <query>
people — 搜索和浏览影人(演员、导演、制作团队)
- — 获取影人的详细信息,包括其作品列表
movie-goat-pp-cli people get - — 获取娱乐行业热门影人
movie-goat-pp-cli people popular - — 按姓名搜索影人
movie-goat-pp-cli people search
trending — 获取热门电影、剧集和影人
- — 获取热门电影、剧集和影人
movie-goat-pp-cli trending all - — 获取热门电影
movie-goat-pp-cli trending movies - — 获取热门影人
movie-goat-pp-cli trending people - — 获取热门剧集
movie-goat-pp-cli trending tv
tv — 搜索和浏览剧集
- — 获取今日有剧集播出的节目
movie-goat-pp-cli tv airing-today - — 获取剧集的详细信息
movie-goat-pp-cli tv get - — 获取当前正在播出的剧集
movie-goat-pp-cli tv on-the-air - — 获取当前热门剧集
movie-goat-pp-cli tv popular - — 按标题搜索剧集
movie-goat-pp-cli tv search - — 获取最高评分剧集
movie-goat-pp-cli tv top-rated
Finding the right command
查找合适的命令
When you know what you want to do but not which command does it, ask the CLI directly:
bash
movie-goat-pp-cli which "<capability in your own words>"which02--help当你知道要做什么但不确定对应命令时,可直接询问CLI:
bash
movie-goat-pp-cli which "<用你自己的话描述需求>"which02--helpRecipes
使用示例
Tonight, well-rated, on my services
今晚观看:高评分、我的流媒体服务可看
bash
movie-goat-pp-cli tonight --mood drama --max-runtime 130 --providers netflix,max,prime --region US --agent --select "results.title,results.year,results.rating,results.providers"Streaming-filtered shortlist with only the high-gravity fields an agent needs to decide.
bash
movie-goat-pp-cli tonight --mood drama --max-runtime 130 --providers netflix,max,prime --region US --agent --select "results.title,results.year,results.rating,results.providers"筛选出可流媒体观看的候选列表,仅保留决策所需的关键字段。
Watchlist sweep
收藏列表扫描
bash
movie-goat-pp-cli watchlist list --available --providers netflix,max --region US --agentWeekly check: which saved titles became streamable on services I have.
bash
movie-goat-pp-cli watchlist list --available --providers netflix,max --region US --agent每周检查:收藏列表中的哪些影片已可在我的流媒体服务上观看。
Rated career deep dive
评分化职业深度分析
bash
movie-goat-pp-cli career "Lynne Ramsay" --role director --agent --select "credits.title,credits.year,credits.rating_imdb,credits.rating_rt"Agent-bounded chronological filmography with the cross-source rating columns that matter.
bash
movie-goat-pp-cli career "Lynne Ramsay" --role director --agent --select "credits.title,credits.year,credits.rating_imdb,credits.rating_rt"按时间顺序展示影人作品,并保留关键的跨源评分字段。
Pick between two finalists
在两部候选作品中做选择
bash
movie-goat-pp-cli versus 27205 87108 --region US --agentAligned compare card for Inception vs. Tenet; ratings, runtime, cast overlap, providers.
bash
movie-goat-pp-cli versus 27205 87108 --region US --agent对比《盗梦空间》和《信条》的评分、时长、演员重叠度、流媒体平台等信息。
Plan a franchise night
规划系列电影之夜
bash
movie-goat-pp-cli marathon "Mission: Impossible" --order release --breaks-every 240 --agentOrdered watchlist with total runtime and break suggestions.
bash
movie-goat-pp-cli marathon "Mission: Impossible" --order release --breaks-every 240 --agent生成按上映顺序排列的观看列表,包含总时长和休息建议。
Auth Setup
认证设置
TMDb v3 API key (free, https://www.themoviedb.org/settings/api) is required and goes in — used as a query parameter, not a Bearer header. OMDb key (free, http://www.omdbapi.com/apikey.aspx) is optional and goes in ; without it, and show TMDb-only and gracefully omit the IMDb/RT/Metacritic columns.
TMDB_API_KEYOMDB_API_KEYratingsversusRun to verify setup.
movie-goat-pp-cli doctor执行验证设置是否正确。
movie-goat-pp-cli doctorAgent Mode
Agent模式
Add to any command. Expands to: .
--agent--json --compact --no-input --no-color --yes-
Pipeable — JSON on stdout, errors on stderr
-
Filterable —keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:
--selectbashmovie-goat-pp-cli movies get mock-value --agent --select id,name,status -
Previewable —shows the request without sending
--dry-run -
Offline-friendly — sync/search commands can use the local SQLite store when available
-
Non-interactive — never prompts, every input is a flag
-
Read-only — do not use this CLI for create, update, delete, publish, comment, upvote, invite, order, send, or other mutating requests
在任何命令后添加参数,等效于:。
--agent--json --compact --no-input --no-color --yes-
可管道传输 — 标准输出为JSON格式,错误信息输出到标准错误
-
可筛选 —参数可保留指定字段。点路径可深入嵌套结构;数组可遍历元素。在处理冗长的API响应时,这对于精简上下文至关重要:
--selectbashmovie-goat-pp-cli movies get mock-value --agent --select id,name,status -
可预览 —参数可显示请求内容但不实际发送
--dry-run -
离线友好 — 同步/搜索命令在可用时可使用本地SQLite存储
-
非交互式 — 从不弹出提示,所有输入均通过参数传递
-
只读 — 请勿使用本CLI执行创建、更新、删除、发布、评论、点赞、邀请、订购、发送或其他会修改状态的请求
Response envelope
响应包
Commands that read from the local store or the API wrap output in a provenance envelope:
json
{
"meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
"results": <data>
}Parse for data and to know whether it's live or local. A human-readable summary is printed to stderr only when stdout is a terminal — piped/agent consumers get pure JSON on stdout.
.results.meta.sourceN results (live)读取本地存储或API的命令会将输出包装在溯源包中:
json
{
"meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
"results": <data>
}解析字段获取数据,通过字段判断数据来自实时API还是本地存储。当标准输出为终端时,会在标准错误输出中打印人类可读的摘要;当通过管道传输给Agent时,标准输出仅为纯JSON格式。
.results.meta.sourceN results (live)Agent Feedback
Agent反馈
When you (or the agent) notice something off about this CLI, record it:
movie-goat-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
movie-goat-pp-cli feedback --stdin < notes.txt
movie-goat-pp-cli feedback list --json --limit 10Entries are stored locally at . They are never POSTed unless is set AND either is passed or . Default behavior is local-only.
~/.movie-goat-pp-cli/feedback.jsonlMOVIE_GOAT_FEEDBACK_ENDPOINT--sendMOVIE_GOAT_FEEDBACK_AUTO_SEND=trueWrite what surprised you, not a bug report. Short, specific, one line: that is the part that compounds.
当你(或Agent)发现本CLI存在问题时,可记录反馈:
movie-goat-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
movie-goat-pp-cli feedback --stdin < notes.txt
movie-goat-pp-cli feedback list --json --limit 10反馈条目存储在本地文件中。除非设置了且传递了参数或设置了,否则反馈不会被自动发送。默认行为仅存储在本地。
~/.movie-goat-pp-cli/feedback.jsonlMOVIE_GOAT_FEEDBACK_ENDPOINT--sendMOVIE_GOAT_FEEDBACK_AUTO_SEND=true请记录让你感到意外的内容,而非正式的错误报告。简短、具体、单条记录:这样的反馈才更有价值。
Output Delivery
输出交付
Every command accepts . The output goes to the named sink in addition to (or instead of) stdout, so agents can route command results without hand-piping. Three sinks are supported:
--deliver <sink>| Sink | Effect |
|---|---|
| Default; write to stdout only |
| Atomically write output to |
| POST the output body to the URL ( |
Unknown schemes are refused with a structured error naming the supported set. Webhook failures return non-zero and log the URL + HTTP status on stderr.
所有命令均支持参数。输出会发送到指定的目标,同时(或替代)输出到标准输出,因此Agent无需手动管道即可路由命令结果。支持以下三种目标:
--deliver <sink>| 目标 | 效果 |
|---|---|
| 默认值;仅输出到标准输出 |
| 原子性地将输出写入 |
| 将输出内容POST到指定URL(当使用 |
不支持的协议会返回结构化错误,并列出支持的协议类型。Webhook失败时会返回非零退出码,并在标准错误输出中记录URL和HTTP状态码。
Named Profiles
命名配置文件
A profile is a saved set of flag values, reused across invocations. Use it when a scheduled agent calls the same command every run with the same configuration - HeyGen's "Beacon" pattern.
movie-goat-pp-cli profile save briefing --json
movie-goat-pp-cli --profile briefing movies get mock-value
movie-goat-pp-cli profile list --json
movie-goat-pp-cli profile show briefing
movie-goat-pp-cli profile delete briefing --yesExplicit flags always win over profile values; profile values win over defaults. lists all available profiles under so introspecting agents discover them at runtime.
agent-contextavailable_profiles配置文件是一组保存的参数值,可在多次调用中复用。适用于定时Agent每次调用相同命令且使用相同配置的场景——即HeyGen的“Beacon”模式。
movie-goat-pp-cli profile save briefing --json
movie-goat-pp-cli --profile briefing movies get mock-value
movie-goat-pp-cli profile list --json
movie-goat-pp-cli profile show briefing
movie-goat-pp-cli profile delete briefing --yes显式参数优先级高于配置文件中的值;配置文件中的值优先级高于默认值。命令会在字段下列出所有可用配置文件,以便Agent在运行时发现它们。
agent-contextavailable_profilesExit Codes
退出码
| Code | Meaning |
|---|---|
| 0 | Success |
| 2 | Usage error (wrong arguments) |
| 3 | Resource not found |
| 4 | Authentication required |
| 5 | API error (upstream issue) |
| 7 | Rate limited (wait and retry) |
| 10 | Config error |
| 代码 | 含义 |
|---|---|
| 0 | 成功 |
| 2 | 使用错误(参数错误) |
| 3 | 资源未找到 |
| 4 | 需要认证 |
| 5 | API错误(上游问题) |
| 7 | 请求受限(请等待后重试) |
| 10 | 配置错误 |
Argument Parsing
参数解析
Parse :
$ARGUMENTS- Empty, , or
help→ show--helpoutputmovie-goat-pp-cli --help - Starts with → ends with
install→ MCP installation; otherwise → see Prerequisites abovemcp - Anything else → Direct Use (execute as CLI command with )
--agent
解析的规则:
$ARGUMENTS- 为空、或
help→ 显示--help的输出movie-goat-pp-cli --help - 以开头 → 如果结尾为
install→ 安装MCP服务器;否则 → 参考上方的前提条件部分mcp - 其他情况 → 直接使用(添加参数执行CLI命令)
--agent
MCP Server Installation
MCP服务器安装
- Install the MCP server:
bash
go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/movie-goat/cmd/movie-goat-pp-mcp@latest - Register with Claude Code:
bash
claude mcp add -e TMDB_API_KEY=<your-tmdb-key> -e OMDB_API_KEY=<your-omdb-key> movie-goat-pp-mcp -- movie-goat-pp-mcpis optional, but it enables IMDb, Rotten Tomatoes, and Metacritic enrichment inOMDB_API_KEY,ratings, andversus.career - Verify:
claude mcp list
- 安装MCP服务器:
bash
go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/movie-goat/cmd/movie-goat-pp-mcp@latest - 在Claude Code中注册:
bash
claude mcp add -e TMDB_API_KEY=<your-tmdb-key> -e OMDB_API_KEY=<your-omdb-key> movie-goat-pp-mcp -- movie-goat-pp-mcp为可选参数,但设置后可在OMDB_API_KEY、ratings和versus命令中启用IMDb、烂番茄和Metacritic的评分增强功能。career - 验证安装:
claude mcp list
Direct Use
直接使用
- Check if installed: If not found, offer to install (see Prerequisites at the top of this skill).
which movie-goat-pp-cli - Match the user query to the best command from the Unique Capabilities and Command Reference above.
- Execute with the flag:
--agentbashmovie-goat-pp-cli <command> [subcommand] [args] --agent - If ambiguous, drill into subcommand help: .
movie-goat-pp-cli <command> --help
- 检查是否已安装:如果未找到,提供安装选项(参考顶部的前提条件部分)。
which movie-goat-pp-cli - 将用户查询匹配到上方“独特功能”和“命令参考”中最合适的命令。
- 添加参数执行命令:
--agentbashmovie-goat-pp-cli <command> [subcommand] [args] --agent - 如果存在歧义,查看子命令帮助:。
movie-goat-pp-cli <command> --help