pp-eventbrite

Eventbrite — Printing Press CLI

前提条件：CLI をインストールする

このスキルは eventbrite-pp-cli バイナリを使用します。**このスキルのコマンドを実行する前に、CLI がインストールされていることを必ず確認してください。**見つからない場合は、先にインストールしてください。

1. Printing Press インストーラーを使用してインストールします。デフォルトでは、macOS/Linux では $HOME/.local/bin に、Windows では %LOCALAPPDATA%\Programs\PrintingPress\bin にバイナリがインストールされます。

   npx -y @mvanhorn/printing-press-library install eventbrite --cli-only
   

2. 確認します：eventbrite-pp-cli --version
3. スキルを実行するエージェント／ランタイムの $PATH に、表示されたインストールディレクトリが含まれていることを確認します。

npx によるインストールに失敗した場合（Node がない、オフラインなど）は、Go から直接インストールしてください（Go 1.26.6 以降が必要です）。

go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/eventbrite/cmd/eventbrite-pp-cli@latest

インストール後に --version が「command not found」と表示する場合、ランタイムからバイナリディレクトリを $PATH 経由で参照できません。確認が成功するまでは、スキルのコマンドを実行しないでください。

この CLI を使用する場面

エージェントが主催者の Eventbrite 上での活動を管理するときに、この CLI を使用します。イベントの作成や公開、注文と参加者の履歴の取得、イベントをまたいだ質問（販売ペースが最も遅いイベント、リピーターのファン、上位購入者、割引コードの実績など）への回答が可能です。こうした質問には、イベントごとのダッシュボードや既存の単一組織向け MCP サーバーでは答えられません。単一のライブ API 照会ではなく、注文と参加者の履歴全体を一か所で扱う必要があるタスクに適しています。同じプロモーターが DICE でも販売している場合、両方の CLI は JSON とローカル SQLite ストアを出力するため、エージェントはイベント（名前と日付）や購入者のメールアドレスを基準に両方のデータセットを結合し、プラットフォームをまたいだ実績とロイヤルティを把握できます。

独自の機能

この API 用の他のツールでは、以下の機能を利用できません。

イベントをまたいだ販売分析

• sales-velocity — 販売開始からの1日あたりのチケット販売数に基づいて、開催中のすべてのイベントをランキングし、完売日を予測します。

  開催中のイベントのうち、現在販売不振なのはどれかを知りたい場合に使用します。現在の販売総数だけでは分からない状況を把握できます。

  eventbrite-pp-cli sales-velocity --json
  

• discount-performance — 割引コードごとの利用回数、種類、および利用率（割当数のうち利用された割合）を表示します。

  プロモーションコードの更新または廃止を決める前に、実際に販売を促進したかどうかを測定する場合に使用します。

  eventbrite-pp-cli discount-performance --json
  

• capacity — 開催中のすべてのイベントについて、販売済み数と総定員数、および残りの割合を一度に表示します。

  完売間近、または販売数が大きく定員を下回っているイベントを、1回の呼び出しで見つける場合に使用します。

  eventbrite-pp-cli capacity --json
  

• refund-rate — 返金・キャンセルされた注文数、返金額、およびイベントごとまたは組織全体の返金率を表示します。

  異常な返金率を示すイベントを見つけ、価格設定、日程、または提供上の問題を特定する場合に使用します。

  eventbrite-pp-cli refund-rate --json
  

• top-buyers — 参加したイベント数ではなく、すべてのイベントでの合計支出額に基づいてチケット購入者をランキングします。

  VIP や先行販売の案内先となる、主催者にとって最も価値の高い顧客を見つける場合に使用します。

  eventbrite-pp-cli top-buyers --limit 25 --json
  

オフラインで自分のデータを検索

• repeat-attendees — 同期済みの全履歴を対象に、2つ以上のイベントのチケットを購入したファンを見つけます。

  いずれか1つのイベントの参加者リストだけではエージェントが回答できない、ロイヤルティや再マーケティングに関する質問に使用します。

  eventbrite-pp-cli repeat-attendees --min 2 --json
  

• roster — 1つのイベントについて、チェックイン済みと未チェックイン、VIP、招待枠のフラグを含む、ドア順に並べ替えたオフライン参加者名簿を表示します。

  ライブ API を呼び出さずに、未チェックインの人をすばやく確認したい場合、入場口で使用します。

  eventbrite-pp-cli roster 1234567890 --csv
  

• fan-export — イベントをまたいで重複を除いた一意の参加者連絡先（メールアドレス、名前、参加イベント、チェックイン状況）をエクスポートします。イベントで絞り込めます。

  主催者の全参加者を対象にしたメールキャンペーン向けに、重複のない整理された連絡先リストを作成する場合に使用します。

  eventbrite-pp-cli fan-export --csv
  

代理店向け複数組織ビュー

• org-rollup — トークンから参照できるすべての組織を1つの画面にまとめ、イベント数、販売済みチケット数、総売上、および組織ごとの上位イベントを表示します。

  各組織にログインする代わりに、クライアント全体の集計を一目で確認したい代理店や複数ブランドの運営者に適しています。

  eventbrite-pp-cli org-rollup --json
  

コマンドリファレンス

balance — 残高を管理します

categories —

カテゴリーオブジェクト

イベントが属する大分類（分野）です。例として「音楽」や「持久競技」があります。

• eventbrite-pp-cli categories category-by-id — ID で category を取得し、category として返します。
• eventbrite-pp-cli categories list-of — サブカテゴリーを含むカテゴリーのリストを返します。ページネーションされたレスポンスを返します。

discounts —

割引オブジェクト

割引オブジェクトは、注文者が イベント のチケットを購入する際に利用できる割引を表します。

割引は、単一の チケットクラス に適用することも、複数のイベントの複数のチケットクラスに同時に適用することもできます（クロスイベント割引と呼ばれます）。

割引には次の4種類があります。

• 公開割引。 イベントの掲載ページとチェックアウトページで、注文者に割引を表示します。単一のイベントでのみ使用できます。

• コード割引。 割引を利用するには、注文者が秘密のコードを入力する必要があります。

• アクセスコード。 非公開チケットにアクセスするには、注文者が秘密のコードを入力する必要があります。アクセスコードには、任意で割引額を設定することもできます。

• ホールド割引。 注文者が保留中の座席に割引を適用する、または割引を利用できるようにします。

チケットの表示価格は次の式で計算されます。
price_before_discount - discount_amount = display_price

注記：

• 公開割引とコード割引では、割引額または割引率のどちらかを指定できますが、両方を指定することはできません。

• 公開割引には、アポストロフィや英数字以外の文字（「-���, 「_」、「 」、「(」、「)」、「/」、および「」を除く）を含めないでください。

• コード割引とアクセスコードには、スペース、アポストロフィ、英数字以外の文字（「-」、「_」、「(」、「)」、「/」、および「」を除く）を含めないでください。

フィールド

割引に関する情報を指定するには、次のフィールドを使用します。

Field	Type	Description
code	string	パブリック割引の割引名、またはコード割引およびアクセスコードのコードです。
type	string	割引の種類です。access、coded、public、hold のいずれかです。
end_date	datetime	割引コードを使用できる期限です。日時にタイムゾーン情報はなく、イベントのタイムゾーンに基づくものとみなされます。null または空の場合、イベントの end_date まで割引を使用できます。ISO 8601 形式：YYYY-MM-DDThh:mm:ss。
end_date_relative	integer	割引コードを使用できる期限を、イベント開始前の秒数で指定します。null または空の場合、イベントの end_date まで割引を使用できます。
amount_off	decimal	割引として適用される固定金額です。通貨単位では指定せず、イベントの通貨を使用します。範囲は 0.01～99999.99 で、小数点以下は 2 桁まで指定できます。アクセスコードのデフォルト値は null です。
percent_off	decimal	割引として適用される割合です。チェックアウト時にチケット価格に表示され、範囲は 1.00～100.00 です。小数点以下は 2 桁まで指定できます。アクセスコードのデフォルト値は null です。
quantity_available	integer	この割引を使用できる回数です。0 は無制限を示します。
quantity_sold	integer	この割引が使用された回数です。このフィールドは読み取り専用です。
start_date	local datetime	割引コードを使用できる開始日時です。null または空の場合、割引は直ちに有効になります。
start_date_relative	integer	割引コードを使用できる開始時刻を、イベント開始前の秒数で指定します。null または空の場合、割引は直ちに有効になります。
ticket_class_ids	list	1 つのイベントで割引対象となるチケットクラス ID のリストです。イベントのすべてのチケットを表示する場合は、空のままにしてください。
event_id	string	割引を使用できる 1 つのイベント ID です。割引の場合は空のままにしてください。
ticket_group_id	string	割引を使用できるチケットグループ ID です。
hold_ids	list	この割引で解除できるホールド ID のリストです。この割引でホールドを解除できない場合は null です。
以下の条件によって、割引の適用範囲が決まります。

• event_id が指定され、ticket_class_ids が指定されていない場合、すべてのイベントチケットに適用されるイベント割引が1つ作成されます。

• event_id と ticket_class_ids の両方が指定されている場合、特定のイベントチケットに適用されるイベント割引が1つ作成されます。

• ticket_group_id が指定されている場合、チケットグループに適用される割引が作成されます。

• event_id と ticket_group_id のどちらも指定されていない場合、組織のイベントのすべてのチケット（今後開催されるイベントを含む）に適用される割引が作成されます。

展開フィールド

展開フィールドの情報は、情報をリクエストしても通常は返されません。この情報をリクエストで受け取るには、リクエストを展開してください。

展開フィールド	ソース	説明
event	event_id	割引を使用できる単一のイベントです。
ticket_group	ticket_group_id	割引を使用できるチケットグループです。
reserved_seating	ticket-reserved-seating-settings	チケットクラスの指定席設定です。指定席に対応していないチケットクラスでは、この展開フィールドは返されません。

• eventbrite-pp-cli discounts delete-a — 割引を削除します。未使用の割引のみ削除できます。
• eventbrite-pp-cli discounts retrieve-a — 割引IDで割引を取得します。
• eventbrite-pp-cli discounts update-a — 割引IDで割引を更新します。

イベント —

イベントオブジェクト

イベントオブジェクトは、Eventbriteのイベントを表します。イベントは1つの組織が所有します。

公開フィールド

イベントに関する情報を指定するには、以下のフィールドを使用します。一般公開されているイベントでは、この情報をすべての Eventbrite ユーザーおよび Eventbrite アプリケーションから取得できます。

フィールド	型	説明
name	multipart-text	イベント名。
summary	string	（任意）イベントの概要。イベントとその目的を説明する短い要約です。
description	multipart-text	（非推奨）（任意）イベントの説明。説明は長文にしたり、複雑な書式を含めたりできます。
url	string	eventbrite.com のイベント掲載ページの URL。
start	datetime-tz	イベントの開始日時。
end	datetime-tz	イベントの終了日時。
created	datetime	イベントの作成日時。
changed	datetime	イベントが最後に変更された日時。
published	datetime	イベントの公開日時。
status	string	イベントのステータス。draft、live、started、ended、completed、canceled のいずれかです。
currency	string	イベントのISO 4217通貨コード。
online_event	boolean	true = イベントがオンラインのみで開催されることを指定します（つまり、イベントに会場がありません）。
hide_start_date	boolean	true の場合、イベントの開始日は参加者に表示されません。
hide_end_date	boolean	true の場合、イベントの終了日は参加者に表示されません。

プライベートフィールド

これらのフィールドは、ユーザーのみが利用できるイベントのプロパティを指定するために使用します。

フィールド	型	説明
listed	boolean	true = イベントを Eventbrite ウェブサイト上で公開検索可能にします。
shareable	boolean	true = Eventbrite アプリケーションにイベントのソーシャル共有ボタンを含めることで、イベントを共有可能にします。
invite_only	boolean	true = イベントへの招待メールを受け取った招待者のみが Eventbrite アプリケーションを閲覧できます。
show_remaining	boolean	true = Eventbrite アプリケーションに、イベントの残りチケット総数を提供します。
password	string	訪問者がイベントの詳細にアクセスするために使用するイベントパスワード。
capacity	integer	参加者に販売できるイベントの最大チケット数。総キャパシティはTicket Classの quantity_total の合計で計算されます。
capacity_is_custom	boolean	true = カスタムキャパシティ値を使用して、イベントの最大参加者数を指定します。False = すべての Ticket Class キャパシティの合計からイベントの最大参加者数を計算します。

Music プロパティ

Music プロパティオブジェクトには、Music クライアント向けのイベントのいくつかの属性が含まれます。イベント ID で Music プロパティを取得するには、music_properties 展開を使用します。

フィールド	型	説明
age_restriction	enum	イベント参加者の最低年齢要件。
presented_by	string	メインの音楽イベントスポンサー。
door_time	string	イベント当日に人が入場できるようにドアが開く時刻を UTC からの相対時刻で表します。設定されていない場合、イベントにはドアタイムが設定されません。 2019-05-12T-19:00:00Z

展開

展開フィールドからの情報は、通常、情報をリクエストしても返されません。この情報をリクエストで受け取るには、リクエストを展開します。

展開	ソース	説明
logo	logo_id	イベントの画像ロゴです。
venue	venue_id	イベントの会場です。
organizer	organizer_id	イベントの主催者です。
format	format_id	イベントの形式です。
category	category_id	イベントのカテゴリです。
subcategory	subcategory_id	イベントのサブカテゴリです。
bookmark_info	bookmark_info	ユーザーがイベントをブックマークに保存しているかどうかを示します。ブックマークがない場合は false を返します。ブックマークがある場合は、イベントをブックマークしたエンドユーザーの数を {count:3} のようなカウントオブジェクトとして指定する辞書を返します。
refund_policy	refund_policy	イベントの返金ポリシーです。
ticket_availability	ticket_availability	すべてのチケットクラスの販売状況の概要です。
external_ticketing	external_ticketing	イベントの外部チケット販売データです。
music_properties	music_properties	イベントの音楽プロパティです。
publish_settings	publish_settings	イベントの公開設定です。
basic_inventory_info	basic_inventory_info	イベントにチケットクラス、在庫ティア、寄付チケットクラス、チケットルール、在庫アドオン、および／または入場在庫ティアがあるかどうかを示します。
event_sales_status	event_sales_status	イベントの販売状況の詳細です。
checkout_settings	checkout_settings	イベントのチェックアウトおよび支払い設定です。
listing_properties	listing_properties	イベントの表示／掲載の詳細です。
has_digital_content	has_digital_content	イベントにデジタルコンテンツがあるかどうかを示します。
events —

イベントオブジェクト

Event オブジェクトは Eventbrite のイベントを表します。イベントは 1 つの組織に所有されています。

公開フィールド

イベントに関する情報を指定するには、これらのフィールドを使用します。一般公開されているイベントの場合、この情報はすべての Eventbrite のユーザーおよび Eventbrite アプリケーションが取得できます。

フィールド	型	説明
name	multipart-text	イベント名。
summary	string	（任意）イベントの概要。イベントとその目的を説明する短い概要です。
description	multipart-text	（非推奨）（任意）イベントの説明。説明は長文にでき、書式を細かく設定できます。
url	string	eventbrite.com にあるイベントの掲載ページの URL。
start	datetime-tz	イベントの開始日時。
end	datetime-tz	イベントの終了日時。
created	datetime	イベントの作成日時。
changed	datetime	イベントが最後に変更された日時。
published	datetime	イベントの公開日時。
status	string	イベントのステータス。draft、live、started、ended、completed、canceled のいずれかです。
currency	string	イベントのISO 4217通貨コード。
online_event	boolean	true = イベントがオンラインのみで開催されることを指定します（つまり、イベントに会場がありません）。
hide_start_date	boolean	true の場合、イベントの開始日は参加者に表示されません。
hide_end_date	boolean	true の場合、イベントの終了日は参加者に表示されません。

プライベートフィールド

これらのフィールドは、ユーザーのみが利用できるイベントのプロパティを指定するために使用します。

フィールド	型	説明
listed	boolean	true = イベントを Eventbrite ウェブサイト上で公開検索可能にします。
shareable	boolean	true = Eventbrite アプリケーションにイベントのソーシャル共有ボタンを含めることで、イベントを共有可能にします。
invite_only	boolean	true = イベントへの招待メールを受け取った招待者のみが Eventbrite アプリケーションを閲覧できます。
show_remaining	boolean	true = Eventbrite アプリケーションに、イベントの残りチケット総数を提供します。
password	string	訪問者がイベントの詳細にアクセスするために使用するイベントパスワード。
capacity	integer	参加者に販売できるイベントの最大チケット数。総キャパシティはTicket Classの quantity_total の合計で計算されます。
capacity_is_custom	boolean	true = カスタムキャパシティ値を使用して、イベントの最大参加者数を指定します。False = すべての Ticket Class キャパシティの合計からイベントの最大参加者数を計算します。

Music プロパティ

Music プロパティオブジェクトには、Music クライアント向けのイベントのいくつかの属性が含まれます。イベント ID で Music プロパティを取得するには、music_properties 展開を使用します。

フィールド	型	説明
age_restriction	enum	イベント参加者の最低年齢要件。
presented_by	string	メインの音楽イベントスポンサー。
door_time	string	イベント当日に人が入場できるようにドアが開く時刻を UTC からの相対時刻で表します。設定されていない場合、イベントにはドアタイムが設定されません。 2019-05-12T-19:00:00Z

展開

展開フィールドからの情報は、通常、情報をリクエストしても返されません。この情報をリクエストで受け取るには、リクエストを展開します。

展開	ソース	説明
logo	logo_id	イベントの画像ロゴです。
venue	venue_id	イベントの会場です。
organizer	organizer_id	イベントの主催者です。
format	format_id	イベントの形式です。
category	category_id	イベントのカテゴリです。
subcategory	subcategory_id	イベントのサブカテゴリです。
bookmark_info	bookmark_info	ユーザーがイベントをブックマークに保存しているかどうかを示します。ブックマークがない場合は false を返します。ブックマークがある場合は、イベントをブックマークしたエンドユーザーの数を {count:3} のようなカウントオブジェクトとして指定する辞書を返します。
refund_policy	refund_policy	イベントの返金ポリシーです。
ticket_availability	ticket_availability	すべてのチケットクラスの販売状況の概要です。
external_ticketing	external_ticketing	イベントの外部チケット販売データです。
music_properties	music_properties	イベントの音楽プロパティです。
publish_settings	publish_settings	イベントの公開設定です。
basic_inventory_info	basic_inventory_info	イベントにチケットクラス、在庫ティア、寄付チケットクラス、チケットルール、在庫アドオン、および／または入場在庫ティアがあるかどうかを示します。
event_sales_status	event_sales_status	イベントの販売状況の詳細です。
checkout_settings	checkout_settings	イベントのチェックアウトおよび支払い設定です。
listing_properties	listing_properties	イベントの表示／掲載の詳細です。
has_digital_content	has_digital_content	イベントにデジタルコンテンツがあるかどうかを示します。

• eventbrite-pp-cli events delete-an — 削除が許可されている場合にイベントを削除します。削除アクションの成功または失敗を示すブール値を返します。
• eventbrite-pp-cli events retrieve-an — イベント ID でイベントを取得します。
• eventbrite-pp-cli events update-an — イベント ID でイベントを更新します。

formats —

Format オブジェクト

Format オブジェクトは、セミナー、ワークショップ、コンサートなど、Event の種類を表します。Format を指定すると、ウェブサイトの訪問者が特定の種類の Event を見つけやすくなります。

• eventbrite-pp-cli formats list — 利用可能なすべての Format を一覧表示します。ページ分割されたレスポンスを返します。
• eventbrite-pp-cli formats retrieve-a — Format ID で Format を取得します。

media —

Media オブジェクト

Media オブジェクトは、Event のリスティングに含めることができる画像を表します。たとえば、ブランディングや Event に関する詳細情報を提供するために使用します。

• eventbrite-pp-cli media retrieve — Media ID で Media を取得します。
• eventbrite-pp-cli media retrieve-a-upload — Media 画像のアップロードに関する情報を取得します。
• eventbrite-pp-cli media upload-a-file — Media 画像ファイルをアップロードします。

orders —

Order オブジェクト

Order オブジェクトは、1 つ以上の Ticket Classes に対して Eventbrite で行われた注文を表します。つまり、1 つの Order は複数のチケットで構成される場合があります。このオブジェクトには、Order の財務情報および取引情報が含まれます。参加者に関する情報を取得するには、Attendee オブジェクトを使用してください。

Order オブジェクトはプライベートと見なされます。つまり、すべての Order 情報は Eventbrite の User および Order の所有者のみが利用できます。

Order フィールド

フィールド	型	説明
created	datetime	Order が作成され、Attendee が登録された日時です。
changed	datetime	Attendee が最後に変更された日時です。
name	string	Order 所有者の名前です。非西洋圏の名前との将来的な互換性を確保するため、first_name／last_name ではなくこのフィールドを使用してください。
first_name	string	Order 所有者の名です。代わりに name フィールドを使用してください。
last_name	string	Order 所有者の姓です。代わりに name フィールドを使用してください。
email	string	Order 所有者のメールアドレスです。
costs	order-costs	Order の費用の内訳です。
event_id	string	Order の Event ID です。
time_remaining	number	Order の完了までの残り時間（秒）です。
questions	order-questions	（任意）Order 所有者に表示されるカスタム質問です。
answers	order-answers	（任意）Order 所有者に表示されるカスタム質問への回答です。
promo_code	string	（任意）Order に適用された Discount コードです。
status	string	Order のステータスです。

Order 費用フィールド

Order の費用の内訳を含みます。

項目	型	説明
base_price	currency	手数料と税を含まない注文金額です。チケットクラスの include_fee フィールドが使用されている場合は、代わりに display_price フィールドを使用してください。そうしないと、注文者に誤った値が表示されます。
display_price	currency	手数料と税を含まない注文金額です。チケットクラスの include_fee フィールドが使用されている場合、このフィールドには注文者に表示される正しい値が格納されます。
display_fee	currency	表示価格に手数料と税を含めた（吸収した）注文金額です。
gross	currency	注文の合計金額です。
eventbrite_fee	currency	注文の gross 金額に占める Eventbrite の手数料です。このフィールドを注文者に表示しないでください。
payment_fee	currency	注文の gross 金額に占める決済処理手数料です。
tax	currency	イベントの主催者に渡される、注文の gross 金額に占める税額です。
display_tax	order-display-tax	注文の税額です。tax フィールドと同じ値ですが、税名も含まれます。
price_before_discount	currency	割引コード適用前の注文価格です。割引コードが適用されていない場合、値は display_price と同じになります。
discount_amount	currency	注文の割引合計額です。割引コードが適用されていない場合、discount_amount は返されません。
discount_type	string	注文に適用された割引の種類です。null、coded、access、public、hold のいずれかです。割引コードが適用されていない場合、discount_type は返されません。
fee_components	Cost Component (list)	手数料表示グループに属する価格コストコンポーネントの一覧です。
tax_components	Cost Component (list)	税表示グループに属する価格コストコンポーネントの一覧です。
shipping_components	Cost Component (list)	配送料表示グループに属する価格コストコンポーネントの一覧です。
has_gts_tax	boolean	tax_components のいずれかが GTS 税であるかどうかを示します。
tax_name	string	該当する税の名前です。

税金表示フィールド

フィールド	型	説明
name	string	税金名。
tax	currency	税額。

返金リクエストフィールド

注文には返金リクエストが含まれます。

フィールド	型	説明
from_email	string	返金リクエストの作成に使用されたメールアドレス。
from_name	string	返金リクエストの名前。
status	string	返金リクエストのステータス。
message	string	返金リクエストに関連付けられたメッセージ。
reason	string	返金リクエストの理由コード。
last_message	string	返金リクエストの最後のステータスに関連付けられた最後のメッセージ。
last_reason	string	返金リクエストの最後の理由コード。
items	list of refund_item	返金リクエストで返金を求められているアイテム。

返金アイテムフィールド

返金リクエストには返金アイテムが含まれます。

フィールド	型	説明
event_id	string	返金項目のイベントです。
order_id	string	返金項目の注文です。フィールドの値は null の場合があります。
processed_date	datetime	（任意）この返金項目が処理済みの場合、処理された日時です。
item_type	string	返金項目の注文タイプです。全額返金には order、参加者への一部返金には attendee、商品としての一部返金には merchandise を使用します。
amount_processed	currency	（任意）返金された金額です。返金が処理されていない場合、この項目は含まれません。
amount_requested	currency	（任意）返金を希望する金額です。参加者が開始した返金の場合にのみ表示されます。
quantity_processed	number	（任意）返金された数量です。item_type フィールドの値が order の場合、quantity_processed は常に 1 です。item_type フィールドの値が attendee または merchandise の場合、quantity_processed の値には処理された項目数が表示されます。返金が処理されていない場合、この項目は含まれません。
quantity_requested	number	（任意）返金を希望する数量です。item_type が order の場合、quantity_requested は常に 1 です。item_type が attendee または merchandise の場合、quantity_requested の値には返金を希望する項目数が表示されます。参加者が開始した返金項目の場合にのみ表示されます。
refund_reason_code	string	返金理由を示す説明的なコードです。
status	string	返金項目のステータスです。pending、processed、error のいずれかです。

注文の質問フィールド

参加者にカスタム質問を提示するために使用します。

フィールド	型	説明
id	string	カスタム質問 ID。
label	string	カスタム質問のラベル。
type	string	text、url、email、date、number、address、または dropdown を指定できます。
required	boolean	true = カスタム質問への回答が必須です。

注文の回答フィールド

参加者のカスタム質問への回答に関する情報を含みます。

フィールド	型	説明
question_id	string	カスタム質問 ID。
attendee_id	string	参加者 ID。
question	string	カスタム質問のテキスト。
type	string	text、url、email、date、number、address、または dropdown を指定できます。
answer	varies	回答の型です。通常は string の値を使用しますが、address または date の回答がより適切な場合は除きます。

注文メモのフィールド

注文メモは、注文に関連する自由形式のテキストです。

フィールド	型	説明
created	datetime	注文メモの作成日時。
text	string	注文メモの内容。最大 2000 文字です。
type	string	注文メモに関連付けられた注文の種類です。常に order のみです。
event_id	event	注文に関連付けられたイベントの ID。
order_id	order	注文メモに関連付けられた注文の ID。
author_name	string	注文メモに関連付けられた注文所有者の姓と名。

拡張項目

拡張項目の情報は、情報をリクエストした場合、通常は返されません。 リクエストでこの情報を受け取るには、拡張項目を指定してください。

拡張項目	ソース	説明
event	event_id	注文に関連付けられたイベントです。
attendees	attendee(list)	注文の参加者です。
merchandise	merchandise(list)	この注文に含まれる商品です。
concierge	concierge	注文のコンシェルジュです。
refund_requests	refund_request	注文の返金リクエストです。
survey	order-questions	（任意）注文のカスタム質問です。
survey_responses	order-survey-responses(object)	（任意）アンケートの質問に対する注文の回答です。
answers	order-answers	（任意）カスタム質問に対する注文の回答です。
ticket_buyer_settings	ticket_buyer_settings	（任意）確認メッセージなど、購入者に関連する情報を含めます。
contact_list_preferences	contact_list_preferences	（任意）注文に関連付けられたメールアドレスのオプトイン設定です。

• eventbrite-pp-cli orders <order_id> — 注文 ID で注文を取得します。

organizations —

Organization オブジェクト

イベントを作成、管理する事業体（マーケティング部門など）を表すオブジェクトです。組織は 1 人のユーザーが所有し、複数のメンバーを持つことができます。

Organization オブジェクトは、メンバー、ロール、会場、アソートメントをグループ化するために使用されます。

公開フィールド

Organization に関する情報を指定するには、以下のフィールドを使用します。

フィールド	型	説明
id	string	Organization ID。List your Organizations などの API リクエストで取得する必要があります。organization_id は organizer_id（Organizer Profile URL 内の文字列）とは異なります。
name	string	Organization 名。
image_id	string	（任意）Organization の画像 ID。
vertical	string	この Organization が事業を展開する業種の種類。現在指定できる値は default と music のみです。指定しない場合、値は default になります。

pricing —

Pricing オブジェクト

Pricing オブジェクトは、さまざまな通貨、国、Assortments、販売チャネルで利用できるすべての手数料率を表します。

• eventbrite-pp-cli pricing calculate-items — チケット作成画面に表示される価格に対して、Eventbrite が請求する手数料を計算します。
• eventbrite-pp-cli pricing list — 利用可能なすべての Pricing 料金を一覧表示します。ページネーションされたレスポンスを返します。

reports —

Report オブジェクト

Report オブジェクトは、API を使用して取得できるレポートを表します。以下のレポートが含まれます。

• 販売アクティビティ

• Event の Attendees。

• eventbrite-pp-cli reports retrieve-a-attendee — Event ID または Event のステータスで Attendee Report を取得します。
• eventbrite-pp-cli reports retrieve-a-sales — Event ID または Event のステータスで販売 Report を取得します。

series — シリーズを管理します

• eventbrite-pp-cli series <event_series_id> — Event Series ID で親 Event Series を取得します。

subcategories — サブカテゴリを管理します

• eventbrite-pp-cli subcategories list-of — 利用可能なすべてのサブカテゴリを一覧表示します。ページネーションされたレスポンスを返します。
• eventbrite-pp-cli subcategories subcategory-by-id — Subcategory ID でサブカテゴリを取得します。

ticket-groups —

Ticket Group オブジェクト

Ticket Group オブジェクトは、Ticket Classes をグループ化するために使用します。

最も一般的な用途は、複数の Ticket Classes に Cross-Event Discount を適用することです。

フィールド

フィールド	型	説明
name	string	チケットグループの名前です。20文字を超える名前は自動的に切り詰められます。
status	string	チケットグループのステータスです。transfer、live、deleted、archivedのいずれかを指定できます。デフォルトのステータスはliveです。
event_ticket_ids	dict	特定のイベント ID に関連付けられたチケットクラス ID を示す辞書です。
tickets	objectlist	チケットクラスのリストです。各チケットクラスには、id、event_id、sales_channels、variants、nameが含まれます。チケットクラスの拡張フィールドを使用しない場合、このフィールドはデフォルトで空です。

• eventbrite-pp-cli ticket-groups delete-a — チケットグループを削除します。チケットグループのステータスはdeletedに変更されます。
• eventbrite-pp-cli ticket-groups retrieve-a — チケットグループ ID でチケットグループを取得します。
• eventbrite-pp-cli ticket-groups update-a — チケットグループ ID でチケットグループを更新します。

ユーザー — >注： 注：これらの URL では、ユーザー ID の代わりに「me」を使用できます。たとえば、/users/me/orders/ は現在のユーザーが申し込んだ注文を返します。

ユーザーオブジェクト

ユーザーは Eventbrite アカウントを表すオブジェクトです。ユーザーは組織のメンバーです。

• eventbrite-pp-cli users list-your-organizations — メンバーである組織を一覧表示します。ページ分割されたレスポンスを返します。
• eventbrite-pp-cli users retrieve-information-about-a-account — 指定されたuserをユーザーとして返します。
• eventbrite-pp-cli users retrieve-information-about-your-account — ユーザーアカウント情報を取得します。

会場 —

会場オブジェクト

会場オブジェクトは、イベントの開催場所（つまり、イベントが行われる場所）を表します。

会場は組織オブジェクトごとにまとめられます。

会場フィールド

フィールド	型	説明
address	address	会場の住所です。
id	string	会場 ID です。
age_restriction	string	会場の年齢制限です。
capacity	number	会場で販売できるチケットの最大数です。
name	string	会場名です。
latitude	string	会場住所の緯度座標です。
longitude	string	会場住所の経度座標です。

• eventbrite-pp-cli venues retrieve-a — 会場 ID で会場を取得します。
• eventbrite-pp-cli venues update-a — 会場 ID で会場を更新します。

ウェブフック —

Webhook オブジェクト

Organization に関連付けられた Webhook を表すオブジェクトです。

• eventbrite-pp-cli webhooks create-deprecated — Webhook を作成します。 > 警告：この API は 2020 年 6 月 1 日以降、利用できなくなります。
• eventbrite-pp-cli webhooks delete-by-id — ID を指定して Webhook を削除します。
• eventbrite-pp-cli webhooks list-of-deprecation — Webhook の一覧を取得します。 > 警告：この API は 2020 年 6 月 1 日以降、利用できなくなります。

適切なコマンドを見つける

実行したいことは分かっていても、どのコマンドを使えばよいか分からない場合は、CLI に直接問い合わせてください。

eventbrite-pp-cli which "<capability in your own words>"

which は、この CLI の厳選された機能インデックスから、自然言語による機能の問い合わせに最も適したコマンドを特定します。終了コード 0 は 1 件以上の一致を意味し、終了コード 2 は確度の高い一致がないことを意味します。その場合は --help を使うか、より絞り込んだ問い合わせをしてください。

レシピ

販売ペースが最も遅い販売中イベントを見つける

eventbrite-pp-cli sales-velocity --json

販売開始後の1日あたりの販売チケット数で、販売中のすべてのイベントを、予測完売日とともに順位付けします。ローカルの注文ストアを使って計算します。

リマーケティング向けにリピーターファンを抽出する

eventbrite-pp-cli repeat-attendees --min 3 --agent --select email,name,events_count

複数イベントの参加者を横断して結合します。--agent は構造化された行を出力し、--select はメールツールに必要な連絡先フィールドだけに絞り込みます。

オフラインで使える入場チェックイン名簿

eventbrite-pp-cli roster 1234567890 --csv

同期済みの1イベント分の参加者名簿を、チェックイン状況とともに CSV 形式で出力します。窓口用名簿に使えます。ライブ API の呼び出しは不要です。

代理店向け金曜日のクライアント集計

eventbrite-pp-cli org-rollup --json

トークンからアクセスできるすべての Organization を一画面で確認できます。各クライアントの Organization のイベント、販売チケット数、総売上、最上位イベントを表示します。

プロモーションコードの ROI を測定する

eventbrite-pp-cli discount-performance --json

同期済みの割引オブジェクトから、割引コードを使用回数と使用率（各コードの割当数に対して使用された割合）で順位付けします。

Eventbrite と DICE を組み合わせてイベントの全体的な実績を把握する

eventbrite-pp-cli fan-export --json

Eventbrite の購入者／参加者リストを JSON としてエクスポートします。同じ公演を DICE でも販売しているプロモーターは、DICE 側のデータもエクスポートします。その後、エージェントがイベントを名前と日付で、購入者を正規化したメールアドレスで結合し、どちらか一方のプラットフォームだけでは把握できない、プラットフォーム横断の実績とロイヤルティの全体像を作成します。

認証の設定

Eventbrite は、Bearer ヘッダーで送信される OAuth2 プライベートトークンを使用します。自分のアカウントで使う場合、OAuth の一連の認証手順は必要ありません。eventbrite.com/platform/api-keys からプライベートトークンをコピーし、EVENTBRITE_API_KEY を設定してください。eventbrite-pp-cli doctor を実行して、トークンが認識されていることを確認します。

エージェントモード

任意のコマンドに --agent を追加してください。次のオプションが有効になります：--json --compact --no-input --no-color --yes。

• パイプ接続可能 — stdout に JSON、stderr にエラーを出力します

• フィルター可能 — --select でフィールドを絞り込めます。ドット区切りのパスはネストされた構造をたどり、配列では各要素に対して処理します。出力の多い API でコンテキストを小さく保つために重要です。

  eventbrite-pp-cli formats list --agent --select id,name,status
  

• プレビュー可能 — --dry-run でリクエストを送信せずに表示します

• オフラインに対応 — 同期／検索コマンドは、利用可能な場合、ローカルの SQLite ストアを使用できます

• 非対話型 — プロンプトは表示されず、すべての入力はフラグで指定します

• 明示的な再試行 — すでに存在するものを作成済みとして扱う場合に限り --idempotent を使用し、削除対象が存在しない場合に限り成功として扱うときは --ignore-missing を使用してください

レスポンスエンベロープ

ローカルストアまたは API から読み取るコマンドは、出力をデータの出所を示すエンベロープでラップします。

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

データには .results を解析し、ライブデータかローカルデータかを確認するには .meta.source を参照してください。人が読める N results (live) という概要は、stdout がターミナルであり、かつ機械処理向けのフォーマットフラグ（--json、--csv、--compact、--quiet、--plain、--select）が設定されていない場合に限り stderr に出力されます。パイプ接続された利用側やエージェントによる利用、および明示的にフォーマットを指定した実行では、stdout に純粋な JSON が出力されます。

エージェントからのフィードバック

あなた（またはエージェント）がこの CLI に気になる点を見つけたら、記録してください。

eventbrite-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
eventbrite-pp-cli feedback --stdin < notes.txt
eventbrite-pp-cli feedback list --json --limit 10

記録はローカルの ~/.eventbrite-pp-cli/feedback.jsonl に保存されます。EVENTBRITE_FEEDBACK_ENDPOINT が設定されており、さらに --send が渡されるか EVENTBRITE_FEEDBACK_AUTO_SEND=true が設定されていない限り、POST されることはありません。デフォルトの動作はローカルのみです。

バグ報告ではなく、意外だったことを書いてください。短く、具体的に、1 行で記述してください。積み重なるのはその部分です。

出力の送信先

すべてのコマンドで --deliver <sink> を指定できます。出力は標準出力に加えて（または標準出力の代わりに）、指定した送信先に出力されるため、エージェントはコマンドの結果を手作業でパイプ処理せずに振り分けられます。次の 3 つの送信先に対応しています。

送信先	動作
stdout	デフォルト。標準出力にのみ書き込みます
file:<path>	出力を <path> にアトミックに書き込みます（一時ファイル + rename）
webhook:<url>	出力本文を URL に POST します（--compact の場合は application/json または application/x-ndjson）

不明なスキームは、対応するスキームを示す構造化エラーとともに拒否されます。Webhook の失敗時にはゼロ以外の終了コードが返され、URL と HTTP ステータスが標準エラー出力に記録されます。

名前付きプロファイル

プロファイルは、保存したフラグ値のセットで、呼び出しをまたいで再利用できます。スケジュールされたエージェントが毎回同じ設定で同じコマンドを呼び出す場合に使用します。これは HeyGen の「Beacon」パターンです。

eventbrite-pp-cli profile save briefing --json
eventbrite-pp-cli --profile briefing formats list
eventbrite-pp-cli profile list --json
eventbrite-pp-cli profile show briefing
eventbrite-pp-cli profile delete briefing --yes

明示的に指定されたフラグは常にプロファイル値より優先され、プロファイル値はデフォルト値より優先されます。agent-context はすべての使用可能なプロファイルを available_profiles の下に一覧表示するため、情報を調べるエージェントは実行時にプロファイルを検出できます。

終了コード

コード	意味
0	成功
2	使用方法エラー（引数が不正）
3	リソースが見つかりません
4	認証が必要です
5	API エラー（上流の問題）
7	レート制限中（待ってから再試行してください）
10	設定エラー

引数の解析

$ARGUMENTS を解析します。

1. 空、help、または --help → eventbrite-pp-cli --help の出力を表示します
2. install で始まる場合 → mcp で終わる場合は MCP のインストール。それ以外の場合は上記の前提条件を参照してください
3. それ以外 → 直接利用（CLI コマンドとして --agent を付けて実行）

MCP サーバーのインストール

1. MCP サーバーをインストールします。

   go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/eventbrite/cmd/eventbrite-pp-mcp@latest
   

2. Claude Code に登録します。

   claude mcp add eventbrite-pp-mcp -- eventbrite-pp-mcp
   

3. 確認します：claude mcp list

直接利用

1. インストールされているか確認します：which eventbrite-pp-cli 見つからない場合は、インストールを提案してください（このスキルの冒頭にある前提条件を参照）。
2. ユーザーのクエリに最適なコマンドを、上記の独自機能とコマンドリファレンスから選びます。
3. --agent フラグを付けて実行します。

   eventbrite-pp-cli <command> [subcommand] [args] --agent
   

4. 曖昧な場合は、サブコマンドのヘルプを確認します：eventbrite-pp-cli <command> --help。