# 유유테이 Yuyu-tei 일본 카드 싱글 시세 — 판매가·매입가 (`jpmarketdata/yuyutei-tcg-price-kr`) Actor

카드 이름이나 세트 코드를 입력하면 일본 대형 카드샵 유유테이(遊々亭)가 그 카드를 얼마에 팔고 얼마에 매입하는지 알려줍니다. 판매가 대표값과 범위, 매입가 대표값, 둘의 차이, 레어도별 가격, 재고 비율, 상처 카드 할인율을 돌려줍니다. 검색당 $0.02. Yuyu-tei Japan sell and buy-back prices per search. Unofficial.

- **URL**: https://apify.com/jpmarketdata/yuyutei-tcg-price-kr.md
- **Developed by:** [h ichi](https://apify.com/jpmarketdata) (community)
- **Categories:** E-commerce, Automation, Developer tools
- **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

## 유유테이 Yuyu-tei 일본 카드 싱글 시세 — 판매가·매입가

**하는 일:** 카드 이름이나 세트 코드를 입력하면 일본 대형 카드샵 유유테이(遊々亭)가 그 카드를 얼마에 팔고 얼마에 매입하는지 알려줍니다.

**입력:** 게임(포켓몬, 유희왕, 원피스 등) + 일본어 카드 이름, 예: `ピカチュウ`, 또는 세트 코드 예: `m05`.

**결과:** 샵 판매가(대표값 + 범위); 매입가(대표값 + 범위); 판매가와 매입가의 차이 %; 레어도별 수량과 가격; 재고 비율; 상처 카드가 얼마나 싼지; 달러 환산. 선택: 카드 1장당 1행.

**가격:** 검색당 $0.02, 목록까지 원하면 카드당 +$0.002. 결과 없음 = 과금 없음.

**예시:** `ピカチュウ`(포켓몬) 입력 → 312장 검색 · 판매가 대표값 ¥9,980(범위 ¥30–998,000) · 판매가·매입가 차이 약 40% · 43% 재고 있음 · 상처 카드는 약 40% 저렴.

**In English:** Type a card name or set code and get what Yuyu-tei, a major Japanese trading-card shop, sells the card for and pays to buy it back. You get typical sell price and range, buy-back price, the gap between the two, prices by rarity, share in stock and damaged-copy discount.

> 비공식 도구 / Unofficial — Yuyu-tei와 무관하며 공개 페이지만 읽습니다. Not affiliated with Yuyu-tei; reads public pages only.

### 한국어

#### 누구를 위한 Actor 인가 (Who this is for)

**일본 카드 구매대행, 해외 직구 카드샵, 일본판 싱글을 사고파는 개인 트레이더**를 위한 것입니다. 일본에서 싱글을 매입해 번개장터 / 중고나라 / 네이버 카페 / eBay 로 되팔거나, 그저 지금 가지고 있는 카드가 일본에서 얼마인지 알고 싶은 경우입니다.

이 Actor 가 읽는 곳은 [유유테이 Yuyu-tei](https://yuyu-tei.jp/)(遊々亭, 일본의 대형 카드 전문 소매점)입니다. 특별한 점은 **같은 카탈로그 위에 판매가(販売価格)와 매입가(買取価格)를 동시에 공개한다**는 것입니다. 한국의 TCG 구매자는 포켓몬 카드 / 유희왕을 비롯한 일본어판 싱글을 일본 시세와 견주어 차익 거래를 하는데, 매입가는 **일본 시장이 현금을 주고 그 카드를 되사 주는 객관적인 바닥값**입니다. 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 키 없음, 실행과 실행 사이에 아무것도 저장하지 않습니다. 실행당 요청 2~3회.

#### 가격 Pricing — 호출당 $0.02 부터, 구독 없음

| 과금 이벤트 | 가격 | 언제 |
|---|---|---|
| 시세 요약(`market-summary`) | **$0.02** | 실행 1회(분석한 쿼리 1개)당 한 번 |
| 개별 카드 레코드(`card-record`) | **$0.002** | '개별 카드 출력'을 켰을 때만 |

기본 실행은 **$0.02**, 약 6초가 걸립니다. **0장이 나온 쿼리에는 과금하지 않습니다.**

#### 입력 Input

| 필드 | 예시 | 설명 |
|---|---|---|
| `game` | `"poc"` | 게임 코드(유유테이 섹션): `poc` 포켓몬 카드 / `ygo` 유희왕 / `opc` 원피스 / `dm` 듀얼마스터즈 / `ws` 바이스 슈발츠 / `ua` 유니온 아레나 / `vg` 뱅가드 / `digi` 디지몬 / `bs` 배틀 스피리츠 / `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` 는 상처 있음 카드가 일본에서 얼마나 깎이는지를 알려 줍니다.

#### 이 Actor 가 하지 않는 것

- **이미지와 상품 설명문은 수집하지도, 반환하지도 않습니다.** 유유테이의 이용약관이 이미지와 문장의 무단 전재를 금지하므로, 이 Actor 는 의도적으로 **카드 이름, 카드 번호, 레어도, 가격, 재고라는 사실 데이터와 집계 통계만** 읽습니다. 이미지 URL 조차 반환하지 않습니다
- **여러 상점을 가로지르는 시장 지수가 아닙니다.** 한 상점(유유테이)이 게시한 가격이며, 일본 전체의 평균가가 아닙니다
- **성사된 거래 이력이 아닙니다.** 판매 이력도, 카드별 체결 시각도 제공하지 않습니다

#### 주의사항 Notes & limits

- 가격은 **상점이 내건 판매가와 매입가**이지 체결 기록이 아닙니다. 판매 이력도 카드별 시각도 없으므로 이것은 시계열이 아니라 스냅샷입니다(시계열이 필요하면 스케줄 실행을 쓰세요)
- `buyPriceJpy` 는 상점이 현재 매입 중인 카드에만 존재합니다. 매입하지 않는 카드는 `cardsFound` 에는 포함되지만 매입·스프레드 통계에서는 제외됩니다(`buyPriceJpy.n` / `spreadPct.n` 이 실제 결합된 장수를 알려 줍니다). 두 집합이 다르기 때문에 **`buyPriceJpy.median` 이 `sellPriceJpy.median` 보다 높게 나올 수 있습니다** —— 상점이 가장 싼 카드들은 아예 매입하지 않기 때문입니다
- `buyPriceUpCount` 는 상점 자신의 「買取強化」 표식으로, 꽤 넉넉하게 붙습니다(실측 ピカチュウ 의 272장 중 251장). 절대적인 희소성 신호가 아니라 스케줄 실행 사이의 추세로 읽으세요
- **확장팩(収録弾) 페이지는 `?kizu=1` 상처 있음 플래그를 무시합니다.** 그래서 `setCode` 모드의 상처 있음 카드는 검색 엔드포인트(`vers[]=<확장팩>&kizu=1`)를 통해 가져옵니다. 결과는 같은 확장팩이고 상처 있음 품목만 담깁니다
- 레어도는 상점의 **섹션 제목에서 가져오며, 그 아래에 놓인 카드들이 이를 물려받습니다.** 표기는 게임마다 다릅니다(포켓몬은 `SR`/`SAR`/`AR`, 그 밖에 `PROMO`, 미분류인 `-` 등)
- **0장이 나오는 것은 정상적인 빈 결과이지 실패가 아닙니다**(그리고 과금되지 않습니다)
- 카탈로그가 **일본어**라 영어 카드 이름은 대개 매칭되지 않습니다. 일본어로 넣으세요(`ピカチュウ`, `青眼の白龍`, `モンキー・D・ルフィ`)
- 읽기 전용이며 요청을 조절합니다(1.5초에 1요청), 실행당 요청 2~3회
- **개인정보를 다루지 않습니다**: 소매점이 직접 운영하는 카탈로그이므로 판매자도, 사용자 생성 콘텐츠도 없습니다

#### 활용 사례 Use cases

- **수출·차익 거래 소싱** —— 일본 판매가 구간을 eBay / TCGplayer / CardMarket 과 비교하면서, `buyPriceJpy` 를 그 카드가 일본 안에서 현금으로 갖는 객관적인 바닥값으로 씁니다
- **자체 매입 시세표 만들기** —— `spreadPct` 는 실제 일본 상점의 카드당 마진율이므로, 내 매입가를 정하는 기준으로 삼을 수 있습니다
- **신규 확장팩 정찰** —— 발매 직후 `setCode` 모드로 한 번 돌려 `rarityBreakdown` 에서 어떤 레어도가 그 확장팩의 가치를 떠받치는지 봅니다
- **수요 모니터링** —— 스케줄 실행으로 `buyPriceUpCount` 와 매입가 중앙값을 관찰합니다. **상점이 매입 제안가를 올리는 것은 그 카드가 움직이기 시작했다는 가장 이른 공개 신호입니다**
- **상태별 가격 산정** —— `damaged.medianDiscountPct` 가 일본 시장이 상처 있음 카드에 매기는 할인 폭을 수치로 알려 줍니다

***

### 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 **Korean-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 Korean-speaking card buyers, proxy 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 `cart_ver` / `cart_cid`, 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 Korean 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
- This is one shop's posted prices, not a market index across shops
- 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 `?kizu=1` damaged flag, so `setCode` mode fetches damaged copies through the search endpoint
- The rarity comes from the shop's section headings and is inherited by the cards listed under them
- Zero hits are a normal empty result, not a failure
- 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も返しません）。これは1店舗の掲示価格であり、複数店舗を横断した市場指数ではありません。価格は店頭掲示の販売価格／買取価格であり成約履歴ではありません。買取対象外のカードは `cardsFound` には含まれますが買取・スプレッド統計からは除外されます（`buyPriceJpy.n` / `spreadPct.n` で結合件数が分かります）。レアリティはセクション見出しに由来し、その下に並ぶカードが継承します。収録弾ページは `?kizu=1` の傷有りフラグを無視するため、`setCode` モードの傷有りは検索エンドポイント経由で取得しています。0件は失敗ではなく正常な空結果です。カタログは日本語のため、キーワードは日本語でご指定ください。読み取り専用・1.5秒に1リクエスト・1回の実行で2〜3リクエストです。

### If something goes wrong

- **Wrong number or a failed run?** Open a ticket on the **Issues** tab. I read every one and reply within 2 business days (Japan time).
- **You never get a fake "empty" result.** If the site can't be read, the run fails and says so.
- **No results = no charge.** You only pay for results you actually get.
- **Checked every week.** An automatic test runs this tool weekly; if the site changes, I fix it.
- **Public pages only.** No login, no personal data, and it goes easy on the site.

### More tools by the same author

- [북오프 BookOff 일본 중고책·만화·CD·게임 시세 — 중고가·재고](https://apify.com/jpmarketdata/bookoff-market-kr)
- [일본 화장품 랭킹 앳코스메 @cosme Top 50 평점·가격](https://apify.com/jpmarketdata/cosme-beauty-market-kr)
- [만다라케 Mandarake 일본 중고 피규어·만화 시세 — 판매가·품절가](https://apify.com/jpmarketdata/mandarake-market-kr)
- [BookOff Japan Used Manga, Books, CDs — Price & Stock](https://apify.com/jpmarketdata/bookoff-market-checker)
- [@cosme Japan Beauty Ranking — Top 50 Ratings & Prices](https://apify.com/jpmarketdata/cosme-beauty-market-checker)
- [Digimart Japan Used Guitar & Instrument Prices](https://apify.com/jpmarketdata/digimart-instrument-market-checker)
- [Fujiya Camera Japan Used Camera Prices by Condition](https://apify.com/jpmarketdata/fujiya-camera-market-checker)
- [HobbyLink Japan Gunpla & Figure Prices + Stock Status](https://apify.com/jpmarketdata/hlj-hobby-market-checker)

Other language editions of this tool: [English](https://apify.com/jpmarketdata/yuyutei-tcg-price-checker) · [中文](https://apify.com/jpmarketdata/yuyutei-tcg-price-cn)

All tools (Japan marketplaces, real estate, jobs, racing, prediction markets): <https://apify.com/jpmarketdata>

### Disclaimer

Unofficial, independent tool — **not affiliated with, endorsed by, or sponsored by Yuyu-tei**. Product names and logos belong to their owners and only say where the data comes from. Data is read from public pages, for market research; check before you act on it.

# Actor input Schema

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

어떤 카드 게임을 검색할지 정합니다. 주요 코드: poc = 포켓몬 카드(ポケモンカードゲーム), ygo = 유희왕(遊戯王), opc = 원피스, dm = 듀얼마스터즈, ws = 바이스 슈발츠, ua = 유니온 아레나, vg = 뱅가드, digi = 디지몬, bs = 배틀 스피리츠, gcg = 건담 카드 게임. 상점이 쓰는 다른 코드도 그대로 동작합니다 — https://yuyu-tei.jp/sell/<code>/s/... 의 경로 조각입니다.

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

cardName = 게임 카탈로그 전체에서 카드 이름을 검색합니다. setCode = 확장팩 하나에 수록된 모든 카드를 나열합니다.

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

'검색 방식'이 cardName일 때 사용합니다. 카탈로그가 일본어 전용이라 일본어가 가장 잘 맞습니다(ピカチュウ, 青眼の白龍, ルフィ). 호출 1회당 $0.02.

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

'검색 방식'이 setCode일 때 사용합니다. 세트 페이지 URL에 들어 있는 코드로, 예를 들어 https://yuyu-tei.jp/sell/poc/s/m05 이면 m05 입니다. 해당 세트의 모든 카드를 한 페이지로 반환합니다(페이징 없음).

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

상점의 섹션 제목에 인쇄된 표기 그대로 한 가지 레어도만 남깁니다: SR, SAR, AR, RR, R, U, C, UR, CHR, PROMO ...(게임마다 다릅니다). 비워 두면 모든 레어도를 포함합니다.

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

기본값 켜짐. 요청을 하나 더 보내 傷有り(상처 있음) 카탈로그를 읽고, 같은 카드의 정상 상태 대비 얼마나 싼지(중앙값 할인율)를 함께 알려 줍니다. 끄면 요청 3회 대신 2회로 실행됩니다.

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

기본값 꺼짐: 품절 카드도 게시된 가격을 유지하므로 시세의 일부입니다. 켜면 상점이 오늘 실제로 발송할 수 있는 카드로만 모든 통계를 한정합니다.

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

기본값 꺼짐: 실행 1회당 시세 요약이 $0.02 정액입니다. 켜면 카드마다 레코드를(카드 번호, 이름, 레어도, 판매가, 매입가, 스프레드, 상처 있음 가격, 재고, 상세 URL) 추가로 출력하며 장당 +$0.002가 부과됩니다. 이미지와 상품 설명은 절대 반환하지 않습니다.

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

'개별 카드 출력'이 켜져 있을 때 반환·과금되는 개별 카드 레코드 수의 상한입니다. 이 값과 무관하게 시세 요약은 언제나 발견된 모든 카드를 대상으로 계산됩니다.

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

현재 환율(open.er-api.com)로 엔화 통계 옆에 달러 통계를 함께 표시합니다.

## 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-kr").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-kr").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).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-kr --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,jpmarketdata/yuyutei-tcg-price-kr"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/0e5kG7N8cKrIFa2DQ/builds/XECGkFaEGTJ9p1f1N/openapi.json