pp-ticketmaster

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese
<!-- GENERATED FILE — DO NOT EDIT. This file is a verbatim mirror of library/media-and-entertainment/ticketmaster/SKILL.md, regenerated post-merge by tools/generate-skills/. Hand-edits here are silently overwritten on the next regen. Edit the library/ source instead. See AGENTS.md "Generated artifacts: registry.json, cli-skills/". -->
<!-- 生成文件 — 请勿编辑。 本文件是library/media-and-entertainment/ticketmaster/SKILL.md的完全镜像, 由tools/generate-skills/在合并后重新生成。此处的手动编辑会在下次生成时被自动覆盖。请改为编辑library/源文件。 请参阅AGENTS.md中的“生成产物:registry.json, cli-skills/”。 -->

Ticketmaster — Printing Press CLI

Ticketmaster — Printing Press CLI

Prerequisites: Install the CLI

前置条件:安装CLI

This skill drives the
ticketmaster-pp-cli
binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:
  1. Install via the Printing Press installer:
    bash
    npx -y @mvanhorn/printing-press install ticketmaster --cli-only
  2. Verify:
    ticketmaster-pp-cli --version
  3. Ensure
    $GOPATH/bin
    (or
    $HOME/go/bin
    ) is on
    $PATH
    .
If the
npx
install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.3 or newer):
bash
go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/ticketmaster/cmd/ticketmaster-pp-cli@latest
If
--version
reports "command not found" after install, the install step did not put the binary on
$PATH
. Do not proceed with skill commands until verification succeeds.
This CLI is the first single-binary tool for the Ticketmaster Discovery API. It absorbs the full read-only surface (events, venues, attractions, classifications, suggest) and adds a local SQLite store with FTS search, named watchlists, residency collapse, tour-view with on-sale flags, and markdown briefs — the workflows real users built scripts to handle.
本Skill驱动
ticketmaster-pp-cli
二进制文件。在调用本Skill的任何命令之前,您必须确认CLI已安装。如果未安装,请先执行以下步骤:
  1. 通过Printing Press安装程序安装:
    bash
    npx -y @mvanhorn/printing-press install ticketmaster --cli-only
  2. 验证安装:
    ticketmaster-pp-cli --version
  3. 确保
    $GOPATH/bin
    (或
    $HOME/go/bin
    )已添加到
    $PATH
    环境变量中。
如果
npx
安装失败(无Node环境、离线等情况),可以回退到直接使用Go安装(需要Go 1.26.3或更高版本):
bash
go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/ticketmaster/cmd/ticketmaster-pp-cli@latest
如果安装后执行
--version
提示“command not found”,说明安装步骤未将二进制文件添加到
$PATH
中。请在验证成功前不要执行Skill命令。
本CLI是首个基于Ticketmaster Discovery API的单二进制工具。它涵盖了所有只读接口(活动、场馆、演出项目、分类、推荐),并添加了本地SQLite存储,支持FTS搜索、命名收藏列表、驻场演出合并、带开售标记的巡演视图和Markdown简报——这些都是真实用户曾编写脚本实现的工作流。

When to Use This CLI

何时使用本CLI

Reach for this CLI when a user asks 'what's on at <venue/metro>', 'where is <artist> playing', or 'what concerts this weekend'. Best for repeat queries against curated venue/artist watchlists (offline FTS shines here), residency-heavy venues (opera, Broadway, comedy), and agent contexts where compact JSON output keeps token usage low. Skip when checkout/purchase is needed — that requires the Commerce API, which this CLI does not cover.
当用户询问“<场馆/都会区>有什么演出”、“<艺人>在哪里演出”或“这周末有什么演唱会”时,可以使用本CLI。它最适合针对精选场馆/艺人收藏列表的重复查询(离线FTS在此场景下表现出色)、驻场演出密集的场馆(歌剧、百老汇、喜剧),以及需要紧凑JSON输出以降低Token消耗的Agent场景。当需要结账/购票时请勿使用——这需要Commerce API,而本CLI不支持该功能。

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的工具所不具备的。

Local-store aggregations

本地存储聚合

  • events upcoming
    — Fan out across a venue ID file or list and return one merged, deduplicated, date-sorted event list — the watchlist primitive behind any curated 'what's on at my venues' workflow.
    When the user has a curated list of venues they care about and wants one merged feed; replaces hand-rolled per-venue fan-out scripts.
    bash
    ticketmaster-pp-cli events upcoming --venue-ids KovZ917Ahkk,KovZpZAFkvEA --days 60 --json
  • events residency
    — Collapse runs of same-name + same-venue events into one row per residency with first_date, last_date, night_count, and id_list — so a 16-night opera season shows as one entry, not 16.
    When listing upcoming events would otherwise show many near-duplicate rows for Broadway tours, opera seasons, or comedy residencies.
    bash
    ticketmaster-pp-cli events residency --window 28 --json
  • events by-classification
    — Local join of events × classifications, grouped by segment and genre, with event count and three example events per leaf — the bucketed view newsletter authors and local-scene trackers reach for.
    When summarizing 'what's on this month' broken down by music vs theatre vs comedy vs sports.
    bash
    ticketmaster-pp-cli events by-classification --dma 383 --window 60 --json
  • events watchlist
    — Save, list, run, and remove named filter sets (venue IDs, attraction IDs, segments, DMA IDs) that persist across runs in the local SQLite store — the generic primitive any curated 'my venues' workflow composes from.
    When the same curated venue/artist/genre filter recurs across many queries.
    bash
    ticketmaster-pp-cli events watchlist save seattle --venue-ids KovZ917Ahkk,KovZpZAFkvEA,KovZpZA1klkA
  • events price-bands
    — Bucket events by priceRanges.min into <$50 / $50-100 / $100-200 / $200+ bands and report count + sample events per band, grouped by classification.
    When the user wants to know where the affordable shows are this month, or how a venue's pricing skews.
    bash
    ticketmaster-pp-cli events price-bands --dma 383 --window 30 --json
  • events upcoming
    — 遍历场馆ID文件或列表,返回一个合并、去重、按日期排序的活动列表——这是任何“我关注的场馆有什么演出”工作流的核心基础。
    适用于用户有自己关注的场馆列表,并希望获得合并后的演出动态;替代手动编写的逐场馆遍历脚本。
    bash
    ticketmaster-pp-cli events upcoming --venue-ids KovZ917Ahkk,KovZpZAFkvEA --days 60 --json
  • events residency
    — 将同名同场馆的多场演出合并为一条驻场记录,包含first_date、last_date、night_count和id_list——例如16场的歌剧季将显示为一条记录,而非16条。
    适用于列出即将举办的活动时,避免百老汇巡演、歌剧季或喜剧驻场出现大量近似重复的记录。
    bash
    ticketmaster-pp-cli events residency --window 28 --json
  • events by-classification
    — 本地关联活动×分类数据,按板块和流派分组,每个分类下显示活动数量和三个示例活动——这是通讯作者和本地场景追踪者常用的分类视图。
    适用于按音乐、戏剧、喜剧、体育等类别汇总“本月演出动态”。
    bash
    ticketmaster-pp-cli events by-classification --dma 383 --window 60 --json
  • events watchlist
    — 保存、列出、运行和删除命名过滤集(场馆ID、演出项目ID、板块、DMA ID),这些过滤集会持久化存储在本地SQLite中——这是任何“我的关注场馆”工作流的通用基础组件。
    适用于同一精选场馆/艺人/流派过滤条件在多个查询中重复使用的场景。
    bash
    ticketmaster-pp-cli events watchlist save seattle --venue-ids KovZ917Ahkk,KovZpZAFkvEA,KovZpZA1klkA
  • events price-bands
    — 按priceRanges.min将活动分为<$50 / $50-100 / $100-200 / $200+四个价格区间,按分类统计每个区间的活动数量和示例活动。
    适用于用户想了解本月平价演出的位置,或场馆的定价分布情况。
    bash
    ticketmaster-pp-cli events price-bands --dma 383 --window 30 --json

Tour & on-sale tracking

巡演与开售跟踪

  • events tour
    — For a given attraction (artist/team/touring show), return every upcoming event sorted by date, with city, venue, on-sale status, and a flag for events going on-sale within 7 days.
    When tracking an artist across cities or watching for presale windows.
    bash
    ticketmaster-pp-cli events tour KovZ917Ahkk --on-sale-window 7 --json
  • events on-sale-soon
    — Local query for events whose public on-sale falls in the next N days, sorted ascending — the canonical 'presale watch' view that no API endpoint provides.
    When the user wants to be alerted to upcoming on-sale dates without polling each artist manually.
    bash
    ticketmaster-pp-cli events on-sale-soon --window 7 --classification rock --json
  • events tour
    — 针对指定演出项目(艺人/团队/巡演剧目),返回所有即将举办的活动,按日期排序,包含城市、场馆、开售状态,以及未来7天内即将开售的活动标记。
    适用于追踪艺人在各地的演出,或关注预售窗口期。
    bash
    ticketmaster-pp-cli events tour KovZ917Ahkk --on-sale-window 7 --json
  • events on-sale-soon
    — 本地查询未来N天内公开开售的活动,按升序排序——这是API端点未提供的标准“预售提醒”视图。
    适用于用户希望收到即将开售的演出提醒,而无需手动轮询每个艺人的信息。
    bash
    ticketmaster-pp-cli events on-sale-soon --window 7 --classification rock --json

Agent-native plumbing

Agent原生适配

  • events dedup
    — Read an event JSON array from stdin or the local store, apply a deduplication strategy (name+venue+date, or tour-leg), and write the deduped stream to stdout — composes with any upstream command.
    When merging results from multiple queries or sources and the duplicates need to be removed before agent processing.
    bash
    ticketmaster-pp-cli events list --keyword phish --json | ticketmaster-pp-cli events dedup --strategy tour-leg
  • events brief
    — Render a markdown 'what's on' report grouped by night → venue → events with classification labels and price bands, suitable for newsletter, Obsidian, iMessage, or agent context.
    When the user needs a paste-ready event summary for a chat thread, newsletter, or LLM context.
    bash
    ticketmaster-pp-cli events brief --dma 383 --window 7
  • events dedup
    — 从标准输入或本地存储读取活动JSON数组,应用去重策略(名称+场馆+日期,或巡演段),并将去重后的流写入标准输出——可与任何上游命令组合使用。
    适用于合并多个查询或来源的结果,并在Agent处理前去除重复项。
    bash
    ticketmaster-pp-cli events list --keyword phish --json | ticketmaster-pp-cli events dedup --strategy tour-leg
  • events brief
    — 生成按夜晚→场馆→活动分组的Markdown格式“演出动态”简报,包含分类标签和价格区间,适合用于通讯、Obsidian、iMessage或Agent场景。
    适用于用户需要可直接粘贴的活动摘要,用于聊天线程、通讯或LLM上下文。
    bash
    ticketmaster-pp-cli events brief --dma 383 --window 7

Command Reference

命令参考

attractions — Manage attractions
  • ticketmaster-pp-cli attractions find
    — Find attractions (artists, sports, packages, plays and so on) and filter your search by name, and much more.
  • ticketmaster-pp-cli attractions get
    — Get details for a specific attraction using the unique identifier for the attraction.
classifications — Manage classifications
  • ticketmaster-pp-cli classifications get
    — Get details for a specific segment, genre, or sub-genre using its unique identifier.
  • ticketmaster-pp-cli classifications get-genre
    — Get details for a specific genre using its unique identifier.
  • ticketmaster-pp-cli classifications get-segment
    — Get details for a specific segment using its unique identifier.
  • ticketmaster-pp-cli classifications get-subgenre
    — Get details for a specific sub-genre using its unique identifier.
  • ticketmaster-pp-cli classifications list
    — Find classifications and filter your search by name, and much more. Classifications help define the nature of...
events — Manage events
  • ticketmaster-pp-cli events get
    — Get details for a specific event using the unique identifier for the event. This includes the venue and location,...
  • ticketmaster-pp-cli events list
    — Find events and filter your search by location, date, availability, and much more.
suggest — Manage suggest
  • ticketmaster-pp-cli suggest
    — Find search suggestions and filter your suggestions by location, source, etc.
venues — Manage venues
  • ticketmaster-pp-cli venues get
    — Get details for a specific venue using the unique identifier for the venue.
  • ticketmaster-pp-cli venues list
    — Find venues and filter your search by name, and much more.
attractions — 管理演出项目
  • ticketmaster-pp-cli attractions find
    — 查找演出项目(艺人、体育赛事、套餐、戏剧等),可按名称等条件过滤搜索。
  • ticketmaster-pp-cli attractions get
    — 使用演出项目的唯一ID获取其详细信息。
classifications — 管理分类
  • ticketmaster-pp-cli classifications get
    — 使用唯一ID获取特定板块、流派或子流派的详细信息。
  • ticketmaster-pp-cli classifications get-genre
    — 使用唯一ID获取特定流派的详细信息。
  • ticketmaster-pp-cli classifications get-segment
    — 使用唯一ID获取特定板块的详细信息。
  • ticketmaster-pp-cli classifications get-subgenre
    — 使用唯一ID获取特定子流派的详细信息。
  • ticketmaster-pp-cli classifications list
    — 查找分类,可按名称等条件过滤搜索。分类用于定义活动的性质...
events — 管理活动
  • ticketmaster-pp-cli events get
    — 使用活动的唯一ID获取其详细信息,包括场馆和位置...
  • ticketmaster-pp-cli events list
    — 查找活动,可按地点、日期、可购性等条件过滤搜索。
suggest — 管理推荐
  • ticketmaster-pp-cli suggest
    — 查找搜索推荐,可按地点、来源等条件过滤。
venues — 管理场馆
  • ticketmaster-pp-cli venues get
    — 使用场馆的唯一ID获取其详细信息。
  • ticketmaster-pp-cli venues list
    — 查找场馆,可按名称等条件过滤搜索。

Finding the right command

查找合适的命令

When you know what you want to do but not which command does it, ask the CLI directly:
bash
ticketmaster-pp-cli which "<capability in your own words>"
which
resolves a natural-language capability query to the best matching command from this CLI's curated feature index. Exit code
0
means at least one match; exit code
2
means no confident match — fall back to
--help
or use a narrower query.
当您知道要做什么但不知道对应的命令时,可以直接询问CLI:
bash
ticketmaster-pp-cli which "<用您自己的话描述功能>"
which
会将自然语言的功能查询解析为CLI精选功能索引中最匹配的命令。退出码
0
表示至少找到一个匹配项;退出码
2
表示没有找到明确匹配项——请回退到
--help
或使用更具体的查询。

Recipes

使用示例

Seattle watchlist (composes the generic primitives, no Seattle-specific code)

西雅图收藏列表(组合通用基础组件,无西雅图特定代码)

bash
ticketmaster-pp-cli events watchlist save seattle --venue-ids KovZ917Ahkk,KovZpZAFkvEA,KovZpZA1klkA,KovZpZAFEdeA,KovZpZAFkv1A
ticketmaster-pp-cli events watchlist run seattle --days 60 --json | ticketmaster-pp-cli events dedup --strategy name-venue-date --json
Save a named watchlist of Seattle venue IDs (Climate Pledge Arena, Paramount, Moore, etc.), run it across the next 60 days, and dedup any cross-venue duplicates — replaces a 595-line bash script that hand-rolled the same loop.
bash
ticketmaster-pp-cli events watchlist save seattle --venue-ids KovZ917Ahkk,KovZpZAFkvEA,KovZpZA1klkA,KovZpZAFEdeA,KovZpZAFkv1A
ticketmaster-pp-cli events watchlist run seattle --days 60 --json | ticketmaster-pp-cli events dedup --strategy name-venue-date --json
保存包含西雅图场馆ID(Climate Pledge Arena、Paramount、Moore等)的命名收藏列表,查询未来60天的演出,并去除跨场馆的重复项——替代了一个595行的bash脚本实现的相同循环逻辑。

Track an artist across all upcoming dates with on-sale flags

跟踪艺人所有即将举办的演出及开售标记

bash
ticketmaster-pp-cli events tour 'Florence + The Machine' --on-sale-window 7 --json --select 'name,dates.start.localDate,_embedded.venues[0].name,_embedded.venues[0].city.name,sales.public.startDateTime'
Returns every upcoming tour stop with city, venue, and a flag for stops going on-sale within a week; the --select narrows the deeply-nested Discovery payload to just what an agent needs.
bash
ticketmaster-pp-cli events tour 'Florence + The Machine' --on-sale-window 7 --json --select 'name,dates.start.localDate,_embedded.venues[0].name,_embedded.venues[0].city.name,sales.public.startDateTime'
返回所有即将举办的巡演站点,包含城市、场馆,以及一周内即将开售的标记;
--select
将深度嵌套的Discovery响应数据精简为Agent所需的内容。

Weekend brief for a metro

都会区周末简报

bash
ticketmaster-pp-cli events brief --dma 383 --window 3 --classification music
Render a markdown brief of the next 3 days of music events in Seattle-Tacoma — paste-ready for Obsidian or an iMessage thread.
bash
ticketmaster-pp-cli events brief --dma 383 --window 3 --classification music
生成西雅图-塔科马地区未来3天音乐活动的Markdown简报——可直接粘贴到Obsidian或iMessage线程中。

On-sale watch for rock shows

摇滚演出开售提醒

bash
ticketmaster-pp-cli events on-sale-soon --window 14 --classification rock --json
Two-week-out scan for rock events going on public sale; pipe to your alerting script.
bash
ticketmaster-pp-cli events on-sale-soon --window 14 --classification rock --json
扫描未来两周内即将公开开售的摇滚演出;可将结果管道到您的提醒脚本中。

Auth Setup

认证设置

Authentication is a single Ticketmaster Discovery API consumer key, passed as the
apikey
query parameter on every request. Register at https://developer-acct.ticketmaster.com and copy the Consumer Key from your My Apps dashboard. Set TICKETMASTER_API_KEY in your shell environment. The free tier allows 5000 requests/day at 5/second.
Run
ticketmaster-pp-cli doctor
to verify setup.
执行
ticketmaster-pp-cli doctor
验证设置是否正确。

Agent Mode

Agent模式

Add
--agent
to any command. Expands to:
--json --compact --no-input --no-color --yes
.
  • Pipeable — JSON on stdout, errors on stderr
  • Filterable
    --select
    keeps a subset of fields. Dotted paths descend into nested structures; arrays traverse element-wise. Critical for keeping context small on verbose APIs:
    bash
    ticketmaster-pp-cli attractions get mock-value --agent --select id,name,status
  • Previewable
    --dry-run
    shows the request without sending
  • 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,错误信息输出到标准错误
  • 可过滤
    --select
    保留字段子集。点路径可深入嵌套结构;数组会遍历每个元素。这对于在冗长的API响应中缩小上下文范围至关重要:
    bash
    ticketmaster-pp-cli attractions 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
.results
for data and
.meta.source
to know whether it's live or local. A human-readable
N results (live)
summary is printed to stderr only when stdout is a terminal — piped/agent consumers get pure JSON on stdout.
从本地存储或API读取数据的命令会将输出包装在来源信封中:
json
{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}
解析
.results
获取数据,
.meta.source
表示数据来自实时API还是本地存储。仅当标准输出为终端时,才会向标准错误输出人类可读的
N results (live)
摘要——管道/Agent消费者仅会在标准输出获得纯JSON。

Agent Feedback

Agent反馈

When you (or the agent) notice something off about this CLI, record it:
ticketmaster-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
ticketmaster-pp-cli feedback --stdin < notes.txt
ticketmaster-pp-cli feedback list --json --limit 10
Entries are stored locally at
~/.ticketmaster-pp-cli/feedback.jsonl
. They are never POSTed unless
TICKETMASTER_FEEDBACK_ENDPOINT
is set AND either
--send
is passed or
TICKETMASTER_FEEDBACK_AUTO_SEND=true
. Default behavior is local-only.
Write what surprised you, not a bug report. Short, specific, one line: that is the part that compounds.
当您(或Agent)发现本CLI存在问题时,请记录反馈:
ticketmaster-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
ticketmaster-pp-cli feedback --stdin < notes.txt
ticketmaster-pp-cli feedback list --json --limit 10
反馈条目会本地存储在
~/.ticketmaster-pp-cli/feedback.jsonl
中。除非设置了
TICKETMASTER_FEEDBACK_ENDPOINT
且传递了
--send
参数或设置了
TICKETMASTER_FEEDBACK_AUTO_SEND=true
,否则反馈不会被POST到远程服务器。默认行为仅本地存储。
请记录让您感到意外的内容,而非正式的错误报告。简短、具体、单行描述:这样的反馈最有价值。

Output Delivery

输出交付

Every command accepts
--deliver <sink>
. 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:
SinkEffect
stdout
Default; write to stdout only
file:<path>
Atomically write output to
<path>
(tmp + rename)
webhook:<url>
POST the output body to the URL (
application/json
or
application/x-ndjson
when
--compact
)
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.
每个命令都接受
--deliver <sink>
参数。输出会发送到指定的接收端,同时(或替代)输出到标准输出,因此Agent无需手动管道即可路由命令结果。支持三种接收端:
接收端效果
stdout
默认;仅输出到标准输出
file:<path>
原子性地将输出写入
<path>
(先写入临时文件再重命名)
webhook:<url>
将输出体POST到指定URL(当使用
--compact
时为
application/json
application/x-ndjson
格式)
不支持的协议会返回结构化错误,并列出支持的协议集。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.
ticketmaster-pp-cli profile save briefing --json
ticketmaster-pp-cli --profile briefing attractions get mock-value
ticketmaster-pp-cli profile list --json
ticketmaster-pp-cli profile show briefing
ticketmaster-pp-cli profile delete briefing --yes
Explicit flags always win over profile values; profile values win over defaults.
agent-context
lists all available profiles under
available_profiles
so introspecting agents discover them at runtime.
配置文件是一组保存的参数值,可在多次调用中复用。适用于定时Agent每次运行都使用相同配置调用同一命令的场景——即HeyGen的“Beacon”模式。
ticketmaster-pp-cli profile save briefing --json
ticketmaster-pp-cli --profile briefing attractions get mock-value
ticketmaster-pp-cli profile list --json
ticketmaster-pp-cli profile show briefing
ticketmaster-pp-cli profile delete briefing --yes
显式参数始终优先于配置文件值;配置文件值优先于默认值。
agent-context
会在
available_profiles
下列出所有可用配置文件,以便自省Agent在运行时发现它们。

Exit Codes

退出码

CodeMeaning
0Success
2Usage error (wrong arguments)
3Resource not found
4Authentication required
5API error (upstream issue)
7Rate limited (wait and retry)
10Config error
代码含义
0成功
2使用错误(参数错误)
3资源未找到
4需要认证
5API错误(上游问题)
7速率限制(请等待后重试)
10配置错误

Argument Parsing

参数解析

Parse
$ARGUMENTS
:
  1. Empty,
    help
    , or
    --help
    → show
    ticketmaster-pp-cli --help
    output
  2. Starts with
    install
    → ends with
    mcp
    → MCP installation; otherwise → see Prerequisites above
  3. Anything else → Direct Use (execute as CLI command with
    --agent
    )
解析
$ARGUMENTS
的逻辑:
  1. 为空、
    help
    --help
    → 显示
    ticketmaster-pp-cli --help
    输出
  2. install
    开头
    → 如果结尾为
    mcp
    → 安装MCP;否则 → 请参阅顶部的前置条件部分
  3. 其他情况 → 直接使用(添加
    --agent
    参数执行CLI命令)

MCP Server Installation

MCP服务器安装

Install the MCP binary from this CLI's published public-library entry or pre-built release, then register it:
bash
claude mcp add ticketmaster-pp-mcp -- ticketmaster-pp-mcp
Verify:
claude mcp list
从本CLI的公开库条目或预构建版本安装MCP二进制文件,然后注册:
bash
claude mcp add ticketmaster-pp-mcp -- ticketmaster-pp-mcp
验证安装:
claude mcp list

Direct Use

直接使用

  1. Check if installed:
    which ticketmaster-pp-cli
    If not found, offer to install (see Prerequisites at the top of this skill).
  2. Match the user query to the best command from the Unique Capabilities and Command Reference above.
  3. Execute with the
    --agent
    flag:
    bash
    ticketmaster-pp-cli <command> [subcommand] [args] --agent
  4. If ambiguous, drill into subcommand help:
    ticketmaster-pp-cli <command> --help
    .
  1. 检查是否已安装:
    which ticketmaster-pp-cli
    如果未找到,提供安装选项(请参阅顶部的前置条件部分)。
  2. 将用户查询匹配到上述独特功能和命令参考中最合适的命令。
  3. 添加
    --agent
    参数执行命令:
    bash
    ticketmaster-pp-cli <command> [subcommand] [args] --agent
  4. 如果存在歧义,查看子命令帮助:
    ticketmaster-pp-cli <command> --help