ai

Tickets.dev AI

此仓库用于通过 AI Agent 使用 Tickets.dev。Tickets.dev 以统一的架构，提供来自 Ticketmaster、StubHub、SeatGeek、Vivid Seats、TickPick、Gametime、Viagogo 等平台的实时门票列表、含所有费用的价格和座位图。

Tickets.dev 是标准 HTTP API，因此任何能够发起 Web 请求的 Agent 都可以使用它。此仓库还提供 Agent 技能、热门 Agent 工具的插件，以及连接托管 MCP 服务的方法。

你可以询问的内容

我有 Eagles 在 Sphere 演出的 110 区 36 排的 2 个座位。各个市场上相同和附近座位的挂牌价格是多少？

显示这个 StubHub 演出的座位图，并列出每个区域含所有费用的最低价格。

下个月每场 Sphere 演出挂出了多少张门票？最低入场价格是多少？

编写一个脚本，每天早上保存这些演出的挂牌门票和最低入场价格。

通过任意 Agent 使用 API

向你的 Agent 提供 OpenAPI 规范、Agent 文档和 API 密钥。前往 tickets.dev 获取密钥，并将其放入 x-api-key 标头中。

大多数任务需要调用两次。先查找演出，然后获取一个市场的页面：

curl "https://api.tickets.dev/v1/events?query=eagles%20sphere" \
  -H "x-api-key: $TICKETS_DEV_KEY"

curl -G "https://api.tickets.dev/v1/capture" \
  --data-urlencode "url=https://www.ticketmaster.com/eagles-live-at-sphere-las-vegas-nevada-12-11-2026/event/17006483D6FAFC60" \
  -H "x-api-key: $TICKETS_DEV_KEY"

Agent 技能

tickets-dev 技能介绍了 Agent 经常弄错的门票数据细节，例如含所有费用的价格、可售数量，以及为什么某条挂牌信息消失并不能证明门票已售出。它采用纯 Markdown 编写，因此你可以将其添加到任意 Agent 的指令中。

插件

如果你使用以下任一 Agent 工具，我们建议安装 Tickets.dev 插件。插件包含技能和 Agent 可直接调用的工具。首次使用工具时，你需要登录 tickets.dev 并批准连接，因此无需复制 API 密钥。

Claude Code

在 Claude Code 中运行以下命令：

/plugin marketplace add Tickets-dot-dev/ai
/plugin install tickets-dev@tickets-dev

然后运行 /mcp，选择 tickets-dev，再选择 Authenticate 进行登录。

Codex

运行以下命令：

codex plugin marketplace add Tickets-dot-dev/ai

然后重启 Codex，从 Plugins 目录安装 Tickets.dev 并登录：

codex mcp login tickets-dev

Cursor

从 cursor.directory 安装插件，或使用 MCP 服务。

Gemini CLI

运行以下命令：

gemini extensions install https://github.com/Tickets-dot-dev/ai

然后在 Gemini CLI 中运行 /mcp auth tickets-dev 进行登录。

Grok Build

该插件即将登陆 Grok Build 市场。在此之前，请使用 MCP 服务。

MCP 服务

工具托管在 https://api.tickets.dev/mcp（Streamable HTTP）。

添加该 URL 并登录。系统会将你引导至 Tickets.dev 登录并批准连接，从而为该应用创建 API 密钥。你可以随时在账户设置中断开连接。

在 Claude Code 中：

claude mcp add --transport http tickets-dev https://api.tickets.dev/mcp

然后运行 /mcp，选择 tickets-dev，再选择 Authenticate。

在 Claude 或 ChatGPT 中，将其作为自定义连接器添加，并使用相同的 URL。

对于接受 URL 的客户端，例如 .cursor/mcp.json：

{
  "mcpServers": {
    "tickets-dev": {
      "url": "https://api.tickets.dev/mcp"
    }
  }
}

对于脚本和无法登录的客户端，请改为在请求头中发送 API 密钥，例如 "headers": { "Authorization": "Bearer tk_live_..." }；或者在 Claude Code 中使用 --header "Authorization: Bearer $TICKETS_DEV_KEY"。

对于只能启动本地服务的客户端，例如 Claude Desktop 的 claude_desktop_config.json，可以运行 tickets-dev-mcp 包。这是一个轻量级桥接程序，会将请求转发到同一个托管服务：

{
  "mcpServers": {
    "tickets-dev": {
      "command": "npx",
      "args": ["-y", "tickets-dev-mcp"],
      "env": { "TICKETS_DEV_KEY": "tk_live_..." }
    }
  }
}

工具	功能
find_events	查找即将举行的活动及其在各个交易平台上的 URL。免费。
get_listings	返回某个活动页面上的所有票单及其全包价格。
compare_prices	按全包价格对某个活动在各交易平台上的票单进行排名。
get_seat_map	返回分区图和座位图、各分区的最低价格，以及地图中提供的场馆容量。
list_marketplaces	列出受支持的交易平台。免费。

这些工具只能读取数据，不能购买、保留或发布票券。

API 密钥

只有使用 HTTP API、脚本和无法登录的客户端时才需要密钥。tickets-dev-mcp 包和技能中的直接 API 调用会从 TICKETS_DEV_KEY 环境变量读取密钥：

export TICKETS_DEV_KEY=tk_live_...

设置后请重启 Agent。不要将密钥粘贴到聊天中。如果未设置密钥，Agent 会告知你如何添加。

每次抓取一个交易平台上的一个活动都会计费，与直接调用 API 的费用相同。每次工具调用最多使用 15 次抓取，每个账户最多可同时运行 3 次工具调用。请参阅定价。

更多 Tickets.dev 资源

• API 文档
• 示例：价格比较应用、价格提醒、价格跟踪器

开发

npm install
node --test                                  # offline tests
TICKETS_DEV_E2E_KEY=<your key> node --test   # end-to-end through api.tickets.dev/mcp (uses a few captures)

许可证

MIT。与任何票务交易平台均无关联。