Ticket Fairy CLI icon

Ticket Fairy CLI

Ticket Fairy CLIは、イベント運営チーム向けのコマンドラインツール。イベント管理、エクスポート、レポート作成、MCP対応までターミナルから操作できます。

Ticket Fairy CLI

概要

Ticket Fairy CLI は、Ticket Fairy のイベント運用のためのコマンドラインインターフェースです。イベント設定やブランド選択から、エクスポート、レポート作成、アカウント作業まで、プロモーターやイベント運営チームがターミナルから主要なダッシュボード作業を処理できます。

この製品は、繰り返し行う作業向けに設計されています。変更のスクリプト化、ジョブのスケジュール設定、CLI と他のツールや AI アシスタントの接続が可能です。npm でインストールでき、既存の Ticket Fairy ユーザーとしてサインインし、Node 20 以上で macOS、Linux、Windows をサポートします。

機能

ターミナルベースのセットアップとログイン

npm でパッケージを一度インストールし、既存の Ticket Fairy アカウントでサインインして、ターミナルからイベント一覧の取得を開始できます。

イベントライフサイクルコマンド

イベントの作成、更新、公開、延期、キャンセル、再開、複製、削除ができ、同じコマンド समूहからイベント統計も確認できます。

運用向けイベントツール

チケット種別、追加オプション、テーブル、プロモコード、招待、メッセージキャンペーンを作成・管理し、CLI からチェックイン状況も確認できます。

エクスポートとレポート作成

CSV または JSON で注文や顧客をエクスポートできるため、ダッシュボードからデータを手作業でコピーせずに、スプレッドシート、データウェアハウス、定期レポートに利用できます。

スクリプト向けの自動化制御

--from-file を使うことで、繰り返し行う作成・更新操作、安定した JSON 出力、ドキュメント化された終了コード、冪等性キー、より安全な自動化のための dry-run 対応を利用できます。

MCP 経由の AI アシスタントアクセス

組み込みの Model Context Protocol サーバーを起動して、AI アシスタントが同じアカウントと権限モデルを通じてイベントを読み取り、変更できるようにします。

ユースケース

  • 繰り返し可能なイベント設定

    複数の公演やシーズンで同じ設定を繰り返す必要があるときに、CLI を使ってファイルからイベントを作成、複製、更新できます。

  • 自動レポート作成

    注文や顧客のエクスポートを CSV または JSON で定期実行するように設定し、手作業でコピーせずにスプレッドシート、データウェアハウス、夜間ジョブへレポートを流せます。

  • ツール間ワークフロー

    イベントデータを外部システムでの処理につなげたいときに、Ticket Fairy を Slack、CRM、webhook、または別のスクリプトに接続できます。

  • AI 支援の運用

    AI アシスタントにライブ売上、チェックイン数、注文データを確認させ、権限と承認のガードレール内で変更案やレポートを作成させることができます。

  • ターミナルからの運用管理

    チーム、招待、プロモーション、メッセージング、チェックインの各コマンドを使って、ダッシュボード画面を切り替えずに日々のイベント運営を行えます。

Pros and Cons

Pros

  • イベント、注文、顧客、メッセージング、チェックイン、チーム、ツアー、webhook、アセットを含む、幅広いチケット管理ワークフローをカバーします。
  • JSON 出力、終了コード、冪等性キー、dry-run 対応、--from-file ペイロードにより、自動化向けに設計されています。
  • すでに持っている Ticket Fairy アカウントと権限をそのまま使用するため、別の統合用アカウントを管理する必要がありません。
  • Claude Code などの AI アシスタントや他の MCP クライアント向けの組み込み MCP サーバーを備えています。
  • macOS、Linux、Windows の標準的な運用環境をサポートします。

Cons

  • Node 20 以上が必要なため、古い Node 環境では利用できません。
  • Vault banking コマンドは招待制で、Ticket Fairy Card プログラムに登録しているブランドのデータのみを返します。
  • ページ上では一部の機能のドキュメントが限定的なため、詳細は完全なコマンドヘルプを確認する必要がある場合があります。

FAQ

セットアップ方法は?

CLI は npm でインストールでき、Node 20 以上が必要です。サインイン時にはブラウザが開き、サーバー上や CI では TICKET_FAIRY_API_KEY を使った Personal Access Token を利用できます。

この CLI は誰向けですか?

ダッシュボードで行っていた作業をスクリプト化したいプロモーターやイベント運営者向けです。イベント設定、エクスポート、レポート作成、AI 支援ワークフローなどに使えます。

自動化で使えますか?

はい。CLI はターミナルでは読みやすい表形式で出力でき、パイプされると JSON に切り替わるため、スクリプト、定期実行ジョブ、パイプラインに適しています。

料金はいくらですか?

ページには、この CLI は Ticket Fairy アカウントで無料で、MIT ライセンスで提供されると記載されています。通常利用に追加のアカウントや API キーの申請は不要です。

チームは既存の権限のまま使えますか?

CLI は、サインインした Ticket Fairy アカウントとブランドで動作し、ページではすべてのコマンドが既存の権限で実行されると案内されています。MCP モードは、クライアントの設定に応じて読み取り専用でも、変更を許可した状態でも開始できます。

Quick Facts

カテゴリー
開発者向けツール
プラットフォーム
macOS、Linux、Windows
ランタイム
Node 20 以上
配布形態
npm パッケージ
ライセンス
MIT
ソースドメイン
ticketfairy.com