ai

Tickets.dev AI

このリポジトリは、AI エージェントで Tickets.dev を使用するためのものです。Tickets.dev は、Ticketmaster、StubHub、SeatGeek、Vivid Seats、TickPick、Gametime、Viagogo などのリアルタイムのチケット掲載情報、手数料込みの価格、座席マップを、統一されたスキーマで返します。

Tickets.dev は標準的な HTTP API なので、ウェブリクエストを送信できるエージェントならどれでも利用できます。このリポジトリには、エージェントスキル、人気のエージェントツール向けプラグイン、ホスト型 MCP サーバーへの接続方法が含まれています。

依頼できること

SphereでのEagles公演で、セクション110、36列目の席を2席持っています。各マーケットプレイスでは、同じ席や近くの席はいくらで掲載されていますか？

このStubHubのイベントの座席マップを、各セクションの手数料込み最安値とともに表示してください。

来月のSphereの各公演では、チケットが何枚掲載されていますか？また、入場可能な最安値はいくらですか？

これらのイベントの掲載チケットと入場可能な最安値を毎朝保存するスクリプトを書いてください。

任意のエージェントで API を使用する

エージェントにOpenAPI仕様、エージェント向けドキュメント、API キーを渡してください。tickets.devでキーを取得し、x-api-key ヘッダーに設定して送信します。

ほとんどのタスクは2回の呼び出しで完了します。イベントを見つけてから、マーケットプレイスのページを1つ取得します。

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"

エージェントスキル

tickets-devスキルでは、手数料込みの価格、販売可能枚数、掲載情報が消えても売却されたとは限らない理由など、エージェントが誤りやすいチケットデータの詳細を説明しています。プレーンな Markdown なので、どのエージェントの指示にも追加できます。

プラグイン

以下のエージェントツールを使用している場合は、Tickets.dev プラグインのインストールをおすすめします。プラグインにはスキルと、エージェントが直接呼び出せるツールが含まれています。初めてツールを使用するときに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 を使ってカスタムコネクターとして追加してください。

.cursor/mcp.json など、URL を指定するクライアントでは：

{
  "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	1 つのイベントページにあるすべての出品を、諸費用込みの価格で返します。
compare_prices	あるイベントの出品を、諸費用込みの価格でマーケットプレイス間で順位付けします。
get_seat_map	セクションマップと座席マップ、セクションごとの最安価格、およびマップに記載がある場合は会場の収容人数を返します。
list_marketplaces	対応しているマーケットプレイスを一覧表示します。無料です。

ツールはデータを読み取るだけです。チケットの購入、確保、出品はできません。

API キー

キーが必要なのは、HTTP API、スクリプト、およびサインインできないクライアントを使う場合のみです。tickets-dev-mcp パッケージとスキルの直接 API 呼び出しは、TICKETS_DEV_KEY 環境変数からキーを読み込みます：

export TICKETS_DEV_KEY=tk_live_...

設定後、エージェントを再起動してください。キーをチャットに貼り付けないでください。キーが見つからない場合、エージェントが追加方法を案内します。

1 つのマーケットプレイスにおける 1 イベントの取得ごとに、直接 API を呼び出した場合と同様に料金が発生します。1 回のツール呼び出しで使用する取得は最大 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。いずれのチケットマーケットプレイスとも提携していません。