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

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

---

中文说明

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

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

这个 Actor 读的是游游亭 Yuyu-tei（遊々亭，日本大型卡牌零售商）。它的特别之处在于：同一个卡池上同时公开销售价和回收价（買取価格）。回收价是日本市场愿意用现金买回这张卡的客观地板价——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	附上美元统计

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

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

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

{
  "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 后，还会逐张输出：

{
  "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 (遊々亭), 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. 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、取得・統計処理は同一）。

カード名または収録弾コードを指定すると、販売価格の分位点、買取価格の分位点、そしてカード単位で実測したスプレッド（(販売−買取)/販売）を返します。販売ページと買取ページはショップ自身の隠しフィールド（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リクエストです。