# Yuyu-tei 游游亭 日本卡牌 Japan TCG — Sell, Buy-back & Spread (`jpmarketdata/yuyutei-tcg-price-cn`) Actor

日本卡牌代购与跨境卡商必备：一次调用即可拿到游游亭（遊々亭）日文单卡的销售价与回收价分位数、每张卡实测的买卖价差、稀有度分布、在库率与有瑕（傷有り）折价。支持宝可梦卡、游戏王、海贼王卡牌等日本卡牌。回收价是日本市场的客观地板价，TCGplayer 等海外数据源没有。不采集图片与商品说明。From $0.02 per call, no subscription.

- **URL**: https://apify.com/jpmarketdata/yuyutei-tcg-price-cn.md
- **Developed by:** [h ichi](https://apify.com/jpmarketdata) (community)
- **Categories:** E-commerce, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $20.00 / 1,000 market summaries

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Japan TCG Singles — Sell, Buy-back & Spread for Chinese Card Buyers

**中文 · English · 日本語** — 游游亭（遊々亭）日文单卡的销售价、回收价与实测价差，一次调用一条结论。宝可梦卡、游戏王、海贼王卡牌等。

***

### 中文说明

#### 这是给谁用的（Who this is for）

给**日本卡牌代购、跨境卡商、日淘玩家**用的。你从日本收单卡，再卖到闲鱼 / 淘宝 / 微店 / 蝦皮 / eBay，或者只是想知道手上这张卡在日本值多少钱。

这个 Actor 读的是[游游亭 Yuyu-tei](https://yuyu-tei.jp/)（遊々亭，日本大型卡牌零售商）。它的特别之处在于：**同一个卡池上同时公开销售价和回收价（買取価格）**。回收价是**日本市场愿意用现金买回这张卡的客观地板价**——TCGplayer、CardMarket 之类的海外数据源里根本没有这个数字。

一句话：**销售价告诉你卖多少，回收价告诉你能收多少，两者之差就是这一行的毛利。**

#### 概览 Overview

一次调用返回一条紧凑的行情记录：

- **`sellPriceJpy`** —— 日本**零售价**（販売価格）的最低 / p25 / 中位数 / p75 / 最高 / 平均
- **`buyPriceJpy`** —— 店铺**回收价**（買取価格）的同样分位数
- **`spreadPct`** —— 每张卡**实测**的买卖价差，`(销售 − 回收) / 销售`。两边是用店铺自己的隐藏购物车键（`cart_ver` / `cart_cid`）关联的，所以这是**同一张卡的真实对应**，不是按卡名做的模糊匹配
- **`rarityBreakdown`** —— 按稀有度（SR / SAR / AR / RR / …）分组的张数、销售中位数、回收中位数、价差中位数
- **`inStockRatio`**（在库率）、**`damaged.medianDiscountPct`**（有瑕卡便宜多少）、**`buyPriceUpCount`**（回收价刚被上调的张数，是需求信号）、**`topBySellPrice`** 与 **`tightestSpread`** 各前 5
- 美元换算（实时汇率）

这个店铺**没有分页**：一次检索会把全部结果渲染在一页上（实测 312 张），因此 `cardsFound` 是**母体实数**，不是样本数。

不登录、不需要 API key、两次运行之间不存任何东西。每次运行 2–3 个请求。

#### 价格 Pricing —— 每次调用 $0.02 起，无订阅

| 计费事件 | 价格 | 何时计费 |
|---|---|---|
| 行情汇总（`market-summary`） | **$0.02** | 每次运行（每个查询）一次 |
| 单卡记录（`card-record`） | **$0.002** | 仅在开启「输出单卡明细」时 |

默认运行 **$0.02**，约 6 秒完成。**0 张结果的查询不计费。**

#### 输入 Input

| 字段 | 示例 | 说明 |
|---|---|---|
| `game` | `"poc"` | 分区代码：`poc` 宝可梦卡 / `ygo` 游戏王 / `opc` 海贼王 / `dm` 决斗大师 / `ws` Weiss Schwarz / `ua` Union Arena / `vg` Vanguard / `digi` 数码宝贝 / `bs` Battle Spirits / `gcg` 高达。店铺使用的其他代码同样可用 |
| `searchMode` | `"cardName"` | `cardName` = 按卡名检索卡池，`setCode` = 列出整个收录弹 |
| `cardName` | `"ピカチュウ"` | 请用日文——卡池只有日文（皮卡丘 = `ピカチュウ`） |
| `setCode` | `"m05"` | 收录弹页面 URL 里的代码，如 `https://yuyu-tei.jp/sell/poc/s/m05` |
| `rarity` | `"SR"` | 可选：只保留一种稀有度，写法与分区标题一致 |
| `includeDamaged` | `true` | 多发 1 个请求，给出有瑕卡折价 |
| `inStockOnly` | `false` | 只统计今天能发货的卡 |
| `includeIndividualCards` | `false` | 开启后逐张输出（+$0.002/张） |
| `maxRecords` | `100` | 只限制单卡明细的条数——行情汇总始终覆盖全部检索结果 |
| `convertToUsd` | `true` | 附上美元统计 |

```json
{
    "game": "poc",
    "searchMode": "cardName",
    "cardName": "ピカチュウ",
    "includeDamaged": true,
    "inStockOnly": false,
    "includeIndividualCards": false,
    "convertToUsd": true
}
```

常用日文对照：宝可梦卡 = `ポケモンカード`（代码 `poc`）／皮卡丘 = `ピカチュウ`／喷火龙 = `リザードン`／游戏王 = `遊戯王`（代码 `ygo`）／青眼白龙 = `青眼の白龍`／海贼王 = `ワンピース`（代码 `opc`）／路飞 = `ルフィ`。

#### 输出 Output（`type: "market_summary"`，数值为 ピカチュウ 的实测值）

```json
{
  "type": "market_summary",
  "query": "ピカチュウ",
  "game": "poc",
  "gameName": "Pokemon Card Game (ポケモンカードゲーム)",
  "searchMode": "cardName",
  "rarityFilter": null,
  "cardsFound": 312,
  "inStockCount": 133,
  "inStockRatio": 0.4263,
  "sellPriceJpy": {"min": 30, "p25": 780, "median": 9980, "p75": 79800, "max": 998000, "average": 114065},
  "buyPriceJpy": {"n": 272, "min": 2, "p25": 1100, "median": 11000, "p75": 66250, "max": 800000, "average": 85612},
  "spreadPct": {"n": 272, "p25": 39.4, "median": 39.8, "p75": 55.6},
  "damaged": {"n": 111, "medianDiscountPct": 40.3},
  "rarityBreakdown": [
    {"rarity": "PROMO", "count": 145, "sellMedian": 79800, "buyMedian": 48000, "spreadMedianPct": 39.7},
    {"rarity": "TD", "count": 66, "sellMedian": 50, "buyMedian": 100, "spreadMedianPct": 70.6},
    {"rarity": "SR", "count": 5, "sellMedian": 34800, "buyMedian": 25000, "spreadMedianPct": 39.6}
  ],
  "buyPriceUpCount": 251,
  "topBySellPrice": [
    {"cardId": "smpromo-300-10088", "cardNumber": "288/SM-P", "name": "ピカチュウ", "rarity": "PROMO",
     "sellPriceJpy": 998000, "buyPriceJpy": 800000, "spreadPct": 19.8}
  ],
  "tightestSpread": [
    {"cardId": "sm09-10101", "cardNumber": "101/095", "name": "ピカチュウ＆ゼクロムGX", "rarity": "SR",
     "sellPriceJpy": 298000, "buyPriceJpy": 240000, "spreadPct": 19.5}
  ],
  "sellPriceUsd": {"min": 0.19, "p25": 4.99, "median": 63.87, "p75": 510.72, "max": 6387.2, "average": 730.02},
  "exchangeRateJpyUsd": 0.0064,
  "checkedAt": "2026-07-26T09:00:00+00:00",
  "sourceUrls": {
    "sell": "https://yuyu-tei.jp/sell/poc/s/search?search_word=%E3%83%94%E3%82%AB%E3%83%81%E3%83%A5%E3%82%A6&kizu=0",
    "buy": "https://yuyu-tei.jp/buy/poc/s/search?search_word=%E3%83%94%E3%82%AB%E3%83%81%E3%83%A5%E3%82%A6&kizu=0",
    "damaged": "https://yuyu-tei.jp/sell/poc/s/search?search_word=%E3%83%94%E3%82%AB%E3%83%81%E3%83%A5%E3%82%A6&kizu=1"
  }
}
```

开启 `includeIndividualCards: true` 后，还会逐张输出：

```json
{
  "type": "card",
  "query": "m05",
  "game": "poc",
  "cardId": "m05-10118",
  "cardNumber": "118/081",
  "name": "メガダークライex",
  "rarity": "MUR",
  "sellPriceJpy": 59800,
  "buyPriceJpy": 42000,
  "spreadPct": 29.8,
  "damagedPriceJpy": 35880,
  "stockStatus": "in_stock",
  "detailUrl": "https://yuyu-tei.jp/sell/poc/card/m05/10118"
}
```

怎么读：`buyPriceJpy.median` 是日本市场的**现金地板价**，收货报价以它为上限；`sellPriceJpy.median` 是日本零售价，判断海外售价空间以它为锚；`spreadPct.median` 就是日本卡商这一行的毛利率。`damaged.medianDiscountPct` 告诉你有瑕品在日本要打多少折。

#### 用途 Use cases

- **出口与套利选品** —— 把日本零售价带与 eBay / TCGplayer / CardMarket 对比，同时用 `buyPriceJpy` 作为这张卡在日本境内的现金客观底价
- **自建回收价目表** —— `spreadPct` 是一家真实日本店铺的每卡毛利率，可以拿来给自己的收卡价定标
- **新弹开包侦察** —— 新品发售后用 `setCode` 模式跑一遍，看 `rarityBreakdown` 里哪个稀有度扛住了整个补充包的价值
- **需求监控** —— 定时运行，观察 `buyPriceUpCount` 与回收价中位数：**店铺提高回收报价，是一张卡开始走货的最早公开信号**
- **品相定价** —— `damaged.medianDiscountPct` 量化了日本市场对有伤卡的折价幅度

#### 注意事项 Notes & limits

- **不采集、不返回任何图片与商品说明文。** 店铺的使用条款保留其图片与文案的著作权，因此本 Actor 刻意只读取卡名、卡号、稀有度、价格与库存这些事实数据，**连图片 URL 都不返回**。请不要期待图片字段
- 价格是**店铺的挂牌售价与挂牌收价**，不是成交记录。没有销售历史、没有每张卡的成交时间，所以这是一个快照而不是时间序列（要时间序列请用定时运行）
- `buyPriceJpy` 只对店铺目前正在收的卡存在；不收的卡计入 `cardsFound` 但排除在回收与价差统计之外（`buyPriceJpy.n` / `spreadPct.n` 告诉你实际关联上了多少张）。因为两个集合不同，**`buyPriceJpy.median` 有可能高于 `sellPriceJpy.median`** —— 店铺根本不收那些最便宜的卡
- `buyPriceUpCount` 是店铺自己的「買取強化」标记，用得很宽松（实测 ピカチュウ 的 272 张里有 251 张）。请把它当作定时运行之间的趋势看，而不是绝对的稀缺度信号
- **收录弹页面会忽略有瑕参数**，因此 `setCode` 模式下的有瑕卡是通过检索端点（`vers[]=<收录弹>&kizu=1`）取得的，结果仍是同一个收录弹、只含有瑕品
- 稀有度来自店铺的分区标题，各游戏写法不同（宝可梦是 `SR`/`SAR`/`AR`，还有 `PROMO`、未分类的 `-` 等）
- 卡池是**日文**的，英文卡名基本匹配不到。请用日文（`ピカチュウ`、`青眼の白龍`、`モンキー・D・ルフィ`）
- 只读、请求节流（1.5 秒 1 个请求），每次运行 2–3 个请求
- **不涉及个人信息**：这是一家零售商的自营目录，没有卖家、也没有用户生成内容

***

### English

#### Overview

**What does this card cost in Japan — and what will a Japanese shop pay for it?** One call answers both, for a card name or a whole expansion set, reading [Yuyu-tei](https://yuyu-tei.jp/) (遊々亭), which publishes its selling price and its buy-back price on the same catalog.

This listing is the **Chinese-language package** of our English Actor [Yuyu-tei Japan TCG Singles](https://apify.com/jpmarketdata/yuyutei-tcg-price-checker). The scraping and statistics are the same; the documentation, store copy and input labels are written for Chinese-speaking card buyers and cross-border dealers.

You get `sellPriceJpy` and `buyPriceJpy` quantiles, the **measured** per-card `spreadPct` (joined on the shop's own hidden cart keys, not on card names), `rarityBreakdown`, `inStockRatio`, the damaged-copy discount, `buyPriceUpCount`, and top-5 lists. There is **no paging** on this shop, so `cardsFound` is the exact population, not a sample.

#### Input

| Field | Example | Notes |
|---|---|---|
| `game` | `"poc"` | Section code: `poc` Pokemon / `ygo` Yu-Gi-Oh! / `opc` One Piece / `dm` / `ws` / `ua` / `vg` / `digi` / `bs` / `gcg`. Any other code the shop uses also works |
| `searchMode` | `"cardName"` | `cardName` = search the catalog, `setCode` = list a whole expansion |
| `cardName` | `"ピカチュウ"` | Japanese works best — the catalog is Japanese-only |
| `setCode` | `"m05"` | The code in the set URL |
| `rarity` | `"SR"` | Optional: keep only one rarity |
| `includeDamaged` | `true` | Adds 1 request and the damaged-copy discount |
| `inStockOnly` | `false` | Restrict every statistic to cards that can ship today |
| `includeIndividualCards` | `false` | Enable to also get one record per card (+$0.002 each) |
| `maxRecords` | `100` | Caps the individual records only |
| `convertToUsd` | `true` | Adds USD statistics |

#### Output

One `market_summary` record per run — see the JSON example in the Chinese section — plus, with `includeIndividualCards: true`, one `card` record per card (card number, name, rarity, sell price, buy-back price, spread, damaged price, stock, detail URL).

#### Pricing

| Event | Price | When |
|---|---|---|
| Market summary (`market-summary`) | **$0.02** | Once per run (per query analyzed) |
| Individual card record (`card-record`) | **$0.002** | Only if you enable **Include individual cards** |

A default run costs **$0.02** and takes about 6 seconds. **A query that finds zero cards is never charged.** No subscription.

#### Notes & limits

- **No images and no product descriptions are collected or returned** — the shop's terms reserve the copyright on them, so this Actor reads only card name, number, rarity, prices and stock
- Prices are shop asks and shop bids, not transaction records: a snapshot, not a time series
- `buyPriceJpy` only exists for cards the shop is currently buying, so `buyPriceJpy.median` can sit *above* `sellPriceJpy.median` (`buyPriceJpy.n` / `spreadPct.n` report the join size)
- `buyPriceUpCount` is the shop's own 買取強化 marker, applied liberally — read it as a trend across scheduled runs
- Set pages ignore the damaged flag, so `setCode` mode fetches damaged copies through the search endpoint
- Japanese-language catalog: English card names mostly do not match
- Read-only and throttled (1 request / 1.5 s), 2–3 requests per run. No personal data

***

### 日本語

#### 概要 Overview

**遊々亭（yuyu-tei.jp）の日本語TCGシングルについて、販売価格・買取価格・その差（スプレッド）を1コールで返す Actor です。** 中国語圏の**カード代購・輸出カードショップ**向けに、中国語で書き直したパッケージです（英語版は [Yuyu-tei Japan TCG Singles](https://apify.com/jpmarketdata/yuyutei-tcg-price-checker)、取得・統計処理は同一）。

カード名または収録弾コードを指定すると、**販売価格の分位点**、**買取価格の分位点**、そして**カード単位で実測したスプレッド**（`(販売−買取)/販売`）を返します。販売ページと買取ページはショップ自身の隠しフィールド（`cart_ver`/`cart_cid`）で突き合わせているため、カード名の文字列一致ではなく**同一カードの実測差**です。あわせてレアリティ別内訳、在庫あり率、**傷有り品の値引き率（中央値）**、**買取強化件数**、高額 Top5、スプレッド最小 Top5、USD換算を返します。**ページングが無い**ため `cardsFound` はサンプル数ではなく**母集団の実数**です（実測312件）。

#### 入力 Input

`game`（`poc`=ポケカ / `ygo`=遊戯王 / `opc`=ワンピース ほか）／`searchMode`（`cardName` か `setCode`）／`cardName`／`setCode`／`rarity`（任意）／`includeDamaged`（既定 ON）／`inStockOnly`（既定 OFF）／`includeIndividualCards`（**既定 OFF**）／`maxRecords`（既定 100）／`convertToUsd`（既定 ON）。

#### 出力 Output

`market_summary` を1件（`sellPriceJpy` / `buyPriceJpy` / `spreadPct` / `rarityBreakdown` / `damaged` / `buyPriceUpCount` / Top5 ほか）。`includeIndividualCards` が ON のときはカードごとの `card` レコード（型番・カード名・レアリティ・販売価格・買取価格・スプレッド・傷有り価格・在庫・詳細URL）も出力します。

#### 料金 Pricing

マーケットサマリー（`market-summary`）**$0.02** ／ 個別カードレコード（`card-record`）**$0.002 / 件**（既定 OFF なので既定実行は $0.02 固定）。**0件のクエリには課金されません。** サブスクリプション不要です。

#### 注意 Notes

**画像と商品説明文は一切収集・返却しません**（遊々亭の利用規約が画像・文章の無断転載を禁じているため。画像URLも返しません）。価格は店頭掲示の販売価格／買取価格であり成約履歴ではありません。買取対象外のカードは `cardsFound` には含まれますが買取・スプレッド統計からは除外されます（`buyPriceJpy.n` / `spreadPct.n` で結合件数が分かります）。収録弾ページは傷有りフラグを無視するため、`setCode` モードの傷有りは検索エンドポイント経由で取得しています。カタログは日本語のため、キーワードは日本語でご指定ください。読み取り専用・1.5秒に1リクエスト・1回の実行で2〜3リクエストです。

# Actor input Schema

## `game` (type: `string`):

要查询哪种卡牌游戏。常用代码：poc = 宝可梦卡（ポケモンカードゲーム）、ygo = 游戏王（遊戯王）、opc = 海贼王、dm = 决斗大师、ws = Weiss Schwarz、ua = Union Arena、vg = Vanguard、digi = 数码宝贝、bs = Battle Spirits、gcg = 高达卡牌。店铺使用的其他代码同样可用——它就是 https://yuyu-tei.jp/sell/<code>/s/... 里的那一段路径。Which card game to search.

## `searchMode` (type: `string`):

cardName = 在整个卡池里按卡名搜索；setCode = 列出某个收录弹（补充包）的全部卡。cardName searches the whole game catalog for a card name, setCode lists every card of one expansion set.

## `cardName` (type: `string`):

「检索方式」选 cardName 时使用。请用日文——店铺卡池只有日文（ピカチュウ = 皮卡丘、青眼の白龍 = 青眼白龙、ルフィ = 路飞）。一次调用计费 $0.02。Used when 'Search by' is cardName; Japanese works best, the catalog is Japanese-only.

## `setCode` (type: `string`):

「检索方式」选 setCode 时使用，即收录弹页面 URL 里的代码，例如 https://yuyu-tei.jp/sell/poc/s/m05 中的 m05。会返回该收录弹的全部卡（单页，无分页）。Used when 'Search by' is setCode; returns every card of that set.

## `rarity` (type: `string`):

只保留某一种稀有度，写法与店铺分区标题一致：SR、SAR、AR、RR、R、U、C、UR、CHR、PROMO……（每种游戏不同）。留空则包含全部稀有度。Keep only one rarity, as printed in the shop's section headings; leave empty for all rarities.

## `includeDamaged` (type: `boolean`):

默认开启。会多发一次请求读取「傷有り」（有瑕）卡池，并给出有瑕卡相对同一张正常卡便宜多少（折价中位数）。关掉后每次运行只发 2 个请求而不是 3 个。On by default; adds one request that reads the damaged catalog and reports the median discount.

## `inStockOnly` (type: `boolean`):

默认关闭：缺货的卡仍保留其挂牌价，属于行情的一部分。开启后所有统计只覆盖今天就能发货的卡。Off by default: out-of-stock cards keep their listed price and are part of the market picture.

## `includeIndividualCards` (type: `boolean`):

默认关闭：一次运行固定 $0.02，只返回行情汇总。开启后还会逐张输出（卡号、卡名、稀有度、销售价、回收价、价差、有瑕价、库存、详情链接），费用 +$0.002/张。**任何情况下都不会返回图片与商品说明文**。Off by default; images and product descriptions are never returned.

## `maxRecords` (type: `integer`):

开启「输出单卡明细」时，最多输出（并计费）多少张单卡记录。无论此值为多少，行情汇总始终覆盖检索到的全部卡。Caps how many individual card records are returned and billed; the market summary always covers every card found.

## `convertToUsd` (type: `boolean`):

在日元统计旁附上美元统计，使用实时汇率（open.er-api.com），方便和 eBay、TCGplayer、CardMarket 的行情对比。Adds USD statistics next to JPY using the current exchange rate.

## Actor input object example

```json
{
  "game": "poc",
  "searchMode": "cardName",
  "cardName": "ピカチュウ",
  "includeDamaged": true,
  "inStockOnly": false,
  "includeIndividualCards": false,
  "maxRecords": 100,
  "convertToUsd": true
}
```

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "game": "poc",
    "searchMode": "cardName",
    "cardName": "ピカチュウ"
};

// Run the Actor and wait for it to finish
const run = await client.actor("jpmarketdata/yuyutei-tcg-price-cn").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "game": "poc",
    "searchMode": "cardName",
    "cardName": "ピカチュウ",
}

# Run the Actor and wait for it to finish
run = client.actor("jpmarketdata/yuyutei-tcg-price-cn").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "game": "poc",
  "searchMode": "cardName",
  "cardName": "ピカチュウ"
}' |
apify call jpmarketdata/yuyutei-tcg-price-cn --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=jpmarketdata/yuyutei-tcg-price-cn",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/FoaTWTbMiRPRfI2KS/builds/e6cY1if0vBeHNm81X/openapi.json