Ticket Fairy CLI icon

Ticket Fairy CLI

Ticket Fairy CLI 是供活動主辦與團隊使用的命令列工具,可在終端機管理 Ticket Fairy 活動、匯出、報表及其他儀表板工作。可透過 npm 安裝,並能以 MCP 將相同的活動資料與操作提供給 AI 助理。

Ticket Fairy CLI

概覽

Ticket Fairy CLI 是 Ticket Fairy 活動作業的命令列介面。它讓活動主辦與團隊能從終端機處理核心儀表板工作,涵蓋從活動設定與品牌選擇到匯出、報表與帳戶作業。

此產品專為可重複執行的工作而設計:你可以將變更寫成腳本、排程工作,並將 CLI 連接至其他工具或 AI 助理。它可透過 npm 安裝,以你已擁有的 Ticket Fairy 使用者身分登入,並支援 macOS、Linux 與 Windows,需搭配 Node 20 或更新版本。

功能

以終端機為基礎的設定與登入

一次使用 npm 安裝套件,登入你既有的 Ticket Fairy 帳戶,並從終端機開始列出活動。

活動生命週期指令

建立、更新、發布、延期、取消、復原、複製與刪除活動,並可從同一組指令讀取活動統計資料。

營運型活動工具

可從 CLI 建立與管理票種、加購項目、桌位、促銷代碼、邀請、訊息活動,以及報到狀態。

匯出與報表

將訂單與顧客匯出為 CSV 或 JSON,供試算表、資料倉儲或排程報表使用,而無需從儀表板手動複製資料。

適合腳本的自動化控制

使用 --from-file 進行可重複的建立與更新操作、穩定的 JSON 輸出、已文件化的結束代碼、冪等性金鑰,以及更安全自動化所需的 dry-run 支援。

透過 MCP 存取 AI 助理

啟動內建的 Model Context Protocol 伺服器,讓 AI 助理可以透過相同的帳戶與權限模型讀取與變更活動。

使用情境

  • 可重複的活動設定

    當你需要在多場演出或多個季節之間重複相同設定時,可使用 CLI 透過檔案建立、複製或更新活動。

  • 自動化報表

    排程將訂單與顧客匯出為 CSV 或 JSON,讓報表可供試算表、資料倉儲或夜間工作使用,而無需手動複製。

  • 工具對工具工作流程

    當你需要活動資料在外部系統中觸發工作時,可將 Ticket Fairy 連接到 Slack、CRM、webhooks 或其他腳本。

  • AI 輔助營運

    讓 AI 助理檢視即時銷售、報到數與訂單資料,接著在符合你的權限與核准護欄下準備變更或報表。

  • 從終端機進行營運管理

    使用團隊、邀請、促銷、訊息與報到指令來處理日常活動營運,避免在儀表板畫面之間切換。

Pros and Cons

Pros

  • 涵蓋廣泛的票務工作流程,包括活動、訂單、顧客、訊息、報到、團隊、巡演、webhooks 與資產。
  • 專為自動化而設計,具備 JSON 輸出、結束代碼、冪等性金鑰、dry-run 支援與 --from-file 載荷。
  • 使用你既有的 Ticket Fairy 帳戶與權限,因此不需要額外管理整合帳戶。
  • 內建 MCP 伺服器,可供 Claude Code 等 AI 助理或其他 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