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、webhook 或其他脚本。

  • AI 辅助运营

    让 AI 助手检查实时销售、检票数量和订单数据,然后在保持你的权限和审批护栏内准备变更或报表。

  • 从终端进行运营管理

    使用团队、邀请、推广、消息和检票命令,处理原本需要在不同控制台页面之间切换的日常活动运营。

Pros and Cons

Pros

  • 涵盖广泛的票务工作流,包括活动、订单、客户、消息、检票、团队、巡演、webhook 和素材。
  • 面向自动化设计,提供 JSON 输出、退出码、幂等键、dry-run 支持以及 --from-file 载荷。
  • 使用你已有的 Ticket Fairy 账户和权限,因此无需单独管理集成账户。
  • 内置 MCP 服务器,可供 Claude Code 或其他 MCP 客户端等 AI 助手使用。
  • 支持 macOS、Linux 和 Windows 等标准操作环境。

Cons

  • 需要 Node 20 或更高版本,因此无法在较旧的 Node 环境中使用。
  • Vault 银行功能仅限受邀使用,并且只会返回已加入 Ticket Fairy Card programme 的品牌的数据。
  • 页面上的某些功能仅有部分文档说明,因此读者可能需要查看完整命令帮助以获取详细信息。

FAQ

如何进行设置?

该 CLI 通过 npm 安装,并要求使用 Node 20 或更高版本。它会打开浏览器进行登录,在服务器或 CI 中可通过 TICKET_FAIRY_API_KEY 使用个人访问令牌。

这个 CLI 是给谁用的?

它面向希望将原本在控制台中完成的工作进行脚本化的推广方和活动运营人员,例如活动设置、导出、报告以及 AI 辅助工作流。

我可以把它用于自动化吗?

可以。CLI 在终端中可输出可读表格,在通过管道传递时会切换为 JSON,因此适合脚本、定时任务和流水线。

它的费用是多少?

页面说明该 CLI 可随 Ticket Fairy 账户免费使用,并采用 MIT 许可证。正常使用无需单独申请账号或 API 密钥。

团队可以使用现有权限来使用它吗?

该 CLI 使用你登录的 Ticket Fairy 账户和品牌,页面说明每条命令都会以你现有的权限运行。MCP 模式可根据你对客户端的配置,以只读或允许变更的方式启动。

Quick Facts

类别
开发者工具
平台
macOS、Linux、Windows
运行时
Node 20 或更高版本
分发方式
npm 包
许可证
MIT
源域名
ticketfairy.com