# 만다라케 Mandarake 일본 중고 피규어·만화 시세 — 판매가·품절가 (`jpmarketdata/mandarake-market-kr`) Actor

키워드를 입력하면 일본 최대 중고 서브컬처 매장 만다라케(Mandarake)에서 피규어·만화·완구·카드가 얼마인지 알려줍니다. 검색 전체의 판매중/품절 건수와, 매장이 돌려주는 앞쪽 120건 기준으로 계산한 판매중 대표가·범위·품절 대표가(실제 팔린 가격에 가까움)를 돌려줍니다. 키워드당 $0.02, 결과 없음 = 과금 없음. Mandarake Japan in-stock and sold-out prices. Unofficial.

- **URL**: https://apify.com/jpmarketdata/mandarake-market-kr.md
- **Developed by:** [h ichi](https://apify.com/jpmarketdata) (community)
- **Categories:** E-commerce, Automation, Developer tools
- **Stats:** 2 total users, 1 monthly users, 86.2% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $20.00 / 1,000 keyword 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/actors/running/actors-in-store.md#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

## 만다라케 Mandarake 일본 중고 피규어·만화 시세 — 판매가·품절가

**하는 일:** 키워드를 입력하면 일본 최대 중고 서브컬처 매장 만다라케(Mandarake)에서 피규어·만화·완구·카드가 얼마인지 알려줍니다.

**입력:** 키워드 1개 이상, 일본어가 가장 정확, 예: `ガンダム`; 선택으로 카테고리(완구, 카드, 만화 등).

**결과:** 검색 전체의 판매중/품절 건수; 판매중 가격의 대표값과 범위, 품절 대표가(만다라케는 정찰제라 품절가는 실제 판매가에 가깝습니다) — 가격은 매장이 돌려주는 앞쪽 120건 기준; 그 120건이 있는 점포 순위; 달러 환산. 선택: 상품 1건당 1행.

**가격:** 키워드당 $0.02, 목록에 넣은 키워드마다 각각 과금됩니다. 상품 목록까지 원하면 상품당 +$0.002. 결과가 없는 키워드는 과금되지 않습니다.

**예시:** `ガンダム` 입력 → 72,464건 검색(판매중 23,157 / 품절 49,307) · 앞쪽 120건 기준 판매중 대표가 ¥4,000(범위 ¥200–48,000), 품절 대표가 ¥5,000(그 표본에서 품절은 5건뿐) · 최다 보유 점포 나카노점·교토점(2026-08-17 실측)

**In English:** Type a keyword and get what anime figures, manga, toys and cards cost on Mandarake, Japan's biggest secondhand collectibles store. You get in-stock and sold-out counts for the whole search, plus typical in-stock and sold-out prices measured on the first 120 listings the store returns, and the shops they sit in.

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

### 한국어

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

**일본 서브컬처 — 애니·만화·피규어·동인지·카드 — 의 한국 시장은 크고, 그리고 중화권 시장과는 완전히 별개의 시장입니다.** 구매대행으로 일본에서 사 오는 쪽도, 국내에서 리셀하는 쪽도, 가격을 매기는 기준은 결국 하나입니다: 이 물건이 일본 내수 시세로 얼마인가. 그리고 그 기준점이 **만다라케**(まんだらけ / Mandarake — 30개가 넘는 실물 점포가 하나의 웹 카탈로그를 공유하는, 일본 최대의 중고 서브컬처 체인)입니다. 전 세계 일본 컬렉터블의 참조 가격이면서, 공개 API가 없습니다.

이 Actor 는 그것을 견적서에 바로 넣을 수 있는 시세 레코드로 바꿔 줍니다:

- **판매중(호가) 시세** —— 표본으로 잡은 상품 중 판매중인 것들의 중앙값, 중간 50% 구간, 최저가, 최고가.
- **품절(실거래) 시세** —— **만다라케는 정찰제 판매**이므로, 품절된 상품의 표시 가격이 곧 실제로 팔린 가격입니다. 일본 컬렉터블 소매에서 공개적으로 얻을 수 있는 것 중 **실거래가(sold comps)** 에 가장 가까운 데이터입니다.
- **재고 구성** —— 판매중과 품절이 각각 몇 건인지 (시장 깊이와 소진 속도의 신호).
- **점포 순위** —— 물건이 어느 점포에 있는지 (나카노, 시부야, Sahra, Grandchaos…).
- 선택: 표본으로 잡은 상품 각각(제목, 가격, 점포, 재고 상태, 상품 링크).

가격은 엔화로 제공되며, 선택적으로 달러 환산이 붙습니다. 데이터는 만다라케의 공개 통신판매 페이지에서 요청 시점에 가져오며, 로그인이 필요 없고 실행 사이에 아무것도 저장하지 않습니다.

이 Actor 는 영문판 [Mandarake Japan Collectibles — Prices In Stock & Sold Out](https://apify.com/jpmarketdata/mandarake-market-checker) 의 **한국어 언어 패키지**입니다. 읽는 페이지와 통계 산출 기준은 완전히 동일하고, 제목·스토어 설명·문서·입력 항목 라벨만 한국어로 다시 썼습니다.

#### 개요 Overview

키워드마다 **`market_summary` 요약 레코드 1건**을 반환합니다: 판매중 가격 통계, 품절 가격 통계, 총 검색 건수, 판매중 총수, 품절 총수, 표본 건수, 재고 보유 점포 Top 5, 환율. 개별 상품 출력을 켜면 표본으로 잡은 상품마다 레코드를 추가로 반환합니다.

#### 입력 Input

| 필드 | 예시 | 설명 |
|---|---|---|
| `keywords` | `["ガンダム"]` | 일본어 키워드가 가장 잘 맞고, 영어도 대개 통합니다(실측 2026-08-18: `gundam` 72,482건 / `ガンダム` 72,447건). **넓은 단어는 이종 혼합 중앙값**을 돌려줍니다(`ガンダム` = 피규어·프라모델·만화·카드). 상품명이나 품번(`MG サザビー` 6건, `RG νガンダム`, `HGUC 1/144`)과 `categoryCode` 로 좁히세요. 키워드당 $0.02 |
| `categoryCode` | `"02"` | 선택 카테고리 필터: 11=만화/라이트노벨, 12=굿즈, 02=완구/피규어, 05=카드/스티커, 04=애니메이션, 03=동인, 01=서적, 10=잡지, 06=영상/게임, 07=아이돌/성우… 비워 두면 전체 |
| `maxItemsPerKeyword` | `120` | 키워드당 최신 상품을 몇 건 표본으로 삼을지 (30–360, 120 = 결과 1페이지) |
| `includeIndividualItems` | `false` | 켜면 상품마다 레코드를 출력합니다 (+$0.002/건) |
| `convertToUsd` | `true` | 현재 환율로 달러 통계를 함께 표시 |

```json
{
    "keywords": ["ガンダム", "ポケモンカード"],
    "categoryCode": null,
    "maxItemsPerKeyword": 120,
    "includeIndividualItems": false,
    "convertToUsd": true
}
```

카탈로그가 일본어이므로 자주 쓰는 키워드 대조표: 건담 = `ガンダム` / 포켓몬 카드 = `ポケモンカード` / 세일러문 = `セーラームーン` / 에반게리온 = `エヴァンゲリオン` / 피규어 = `フィギュア` / 동인지 = `同人誌` / 셀화 = `セル画`.

#### 출력 Output

필드명은 영어 그대로입니다. API 인터페이스이기 때문입니다. 2026-08-17 실측(실제 실행, `ガンダム`, 기본 입력). 표본 120건 중 품절은 5건뿐이라 `soldPriceJpy` 는 그 5건 기준입니다:

```json
{
  "type": "market_summary",
  "keyword": "ガンダム",
  "totalListingsFound": 72464,
  "inStockTotal": 23157,
  "soldOutTotal": 49307,
  "countMismatch": false,
  "keywordStatus": "ok",
  "hint": null,
  "sampledListings": 120,
  "sampledInStock": 115,
  "sampledSoldOut": 5,
  "askPriceJpy": {
    "min": 200,
    "p25": 2000,
    "median": 4000,
    "p75": 9500,
    "max": 48000,
    "average": 10622
  },
  "soldPriceJpy": {
    "min": 1800,
    "p25": 3800,
    "median": 5000,
    "p75": 5300,
    "max": 5500,
    "average": 4280
  },
  "shopTop": [
    [
      "Nakano + 1 others",
      7
    ],
    [
      "Kyoto",
      7
    ],
    [
      "Sahra + 3 others",
      6
    ],
    [
      "Complex",
      6
    ],
    [
      "Nakano",
      5
    ]
  ],
  "checkedAt": "2026-08-17T17:40:45.818696+00:00",
  "askPriceUsd": {
    "min": 1.26,
    "p25": 12.56,
    "median": 25.12,
    "p75": 59.67,
    "max": 301.49,
    "average": 66.72
  },
  "soldPriceUsd": {
    "min": 11.31,
    "p25": 23.87,
    "median": 31.41,
    "p75": 33.29,
    "max": 34.55,
    "average": 26.88
  },
  "exchangeRateJpyUsd": 0.006281
}
```

읽는 법: `askPriceJpy.median` 은 **지금 그것을 사려면 얼마가 드는지**이고, `soldPriceJpy.median` 은 **그것이 실제로 팔렸을 때의 가격**입니다(만다라케는 정찰제이므로 품절가가 곧 실거래가). 이 둘 사이의 간격이 일본 쪽에서의 매입 여지입니다. `inStockTotal` 과 `soldOutTotal` 의 비율은 소진 신호입니다. 품절 비중이 높은데 판매중 물량이 얇다면 그 장르는 지금 잘 팔리고 있다는 뜻입니다.

#### 각 통계의 산출 근거 (basis)

- **넓은 키워드는 이종 혼합 중앙값을 줍니다.** `ガンダム`(72,447건)은 피규어·프라모델·만화·카드를 한꺼번에 섞으므로, 중앙값은 그 전부의 한가운데입니다. 바로 쓸 수 있는 가격이 필요하면 실제 팔리는 상품명으로 검색하거나(`MG サザビー`, 6건) `categoryCode` 를 함께 지정하세요.
- **`totalListingsFound` 은 품절 상품을 포함합니다.** 지금 실제로 살 수 있는 수량은 `inStockTotal`(별도의 필터 카운트에서 가져오는 정확한 값)입니다.
- **좁은 키워드에서는 스토어의 두 카운트가 서로 어긋날 수 있습니다.** 서로 다른 인덱스에서 만들어지기 때문입니다: 실측 2026-08-18, `MG Sazabi` 는 전체 검색에서 1건, 재고만 보기 검색에서 2건입니다. 그럴 때 이 행에는 `countMismatch: true` 와 `soldOutTotal: null` 이 붙고, 두 원본 카운트는 그대로 남습니다 — 숫자를 맞추려고 반올림하지 않습니다.
- **0건 키워드도 한 행을 돌려줍니다**: `keywordStatus: "not_found"` 와 다음에 무엇을 시도할지 알려주는 `hint` 한 줄이 붙고, 과금은 없습니다. 적중했을 때는 `keywordStatus: "ok"`, `hint: null` 입니다.
- **`askPriceJpy` / `soldPriceJpy` 는 표본 통계입니다.** 모수는 `sampledListings`(그리고 그중 `sampledInStock` / `sampledSoldOut`)이며, 최신 등록 순으로 표본을 잡습니다. 분포를 더 안정적으로 만들려면 `maxItemsPerKeyword` 를 올리세요.
- **`shopTop` 도 표본 통계입니다.** 표본으로 잡은 상품들의 점포 분포이지, 사이트 전체 재고의 점포 분포가 아닙니다.

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

- **거래 일시를 제공하지 않으므로 시계열 분석을 할 수 없습니다.** 품절 상품에는 판매 날짜가 없습니다. 제공할 수 있는 신호는 「판매중/품절 구성」과 「두 개의 가격 분포」이지, 가격 추이 곡선이 아닙니다.
- **전체 카탈로그 크롤러가 아닙니다.** 키워드 단위로 표본을 잡아 통계를 돌려줄 뿐, 카탈로그 전체를 덤프하지 않습니다.
- **구매대행·주문·배송을 하지 않습니다.** 공개 페이지를 읽기만 합니다.
- **개인정보를 다루지 않습니다.** 만다라케는 자사 판매(퍼스트파티) 소매점이라 판매자 개인정보가 존재하지 않습니다.
- **실물 점포 재고와 일치한다고 보장하지 않습니다.** 웹 카탈로그와 점포 현물이 항상 같지는 않습니다.

#### 가격 Pricing — 키워드당 $0.02

| 과금 이벤트 | 가격 | 발생 시점 |
|---|---|---|
| 키워드 시세 요약 (`keyword-analyzed`) | **$0.02** | 키워드 1건을 분석할 때마다 |
| 개별 상품 레코드 (`item-scraped`) | **$0.002** | 「개별 상품 출력」을 켠 경우에만 |

기본 실행(키워드 1건, 요약만)은 **$0.02** 입니다. **결과가 0건인 키워드에는 절대 과금되지 않습니다.** 개별 상품 출력은 기본값이 꺼짐입니다. 요청한 키워드 수만큼만 과금되며, 월 정액 요금은 없습니다.

#### 주의사항 Notes & limits

- 성인 지정 상품도 건수에 포함되며, 개별 레코드에서는 `isAdult` 로 표시됩니다.
- 읽기 전용이며 속도 제한이 있습니다(약 1요청 / 1.5초). 로그인 불필요, 개인정보 없음, 실행 사이 저장 없음.
- 주식회사 만다라케와는 아무런 제휴 관계가 없습니다. 데이터는 시장 조사용이며, 큰 금액의 거래 전에는 직접 확인하세요.
- 페이지 구조가 바뀌면 정상인 척 빈 결과를 돌려주지 않고 **명시적으로 오류를 냅니다.**

#### 활용 사례 Use cases

- **소싱과 차익거래** —— 구매대행으로 주문하기 전에 만다라케의 판매중 가격과 eBay / 메루카리의 실거래가를 맞대어 봅니다.
- **내 재고 가격 매기기** —— 품절 가격 분포는 판매자의 희망가가 아니라 일본 시장이 실제로 지불한 가격입니다.
- **컬렉션과 장르 추적** —— 특정 시리즈나 캐릭터의 시장 깊이와 가격 수위를 한 번의 조회로 파악합니다.

***

### English

#### Overview

Price and availability statistics for any keyword on Mandarake — Japan's biggest secondhand store for anime, manga, figures, doujinshi, toys and trading cards (30+ physical shops, one web catalog). Each keyword returns in-stock ask prices, sold-out (realized) prices, the stock split and the top shops, plus optionally every sampled item.

This listing is the **Korean-language package** of our English Actor [Mandarake Japan Collectibles — Prices In Stock & Sold Out](https://apify.com/jpmarketdata/mandarake-market-checker). It reads the same pages and computes the same numbers; the documentation, store copy and input labels are written for Korean-speaking collectors, proxy buyers (구매대행) and resellers (리셀).

#### Input

| Field | Example | Notes |
|---|---|---|
| `keywords` | `["ガンダム"]` | Japanese works best, English usually works too. A broad word returns a mixed-category middle price — narrow it with a product name (`MG サザビー`) and a `categoryCode`. $0.02 per keyword |
| `categoryCode` | `"02"` | Optional category filter (11=Comics, 12=Goods, 02=Toys, 05=Cards, 04=Anime, 03=Doujins…) |
| `maxItemsPerKeyword` | `120` | Newest listings sampled per keyword (30–360) |
| `includeIndividualItems` | `false` | Enable to get each item as a record (+$0.002 each) |
| `convertToUsd` | `true` | Adds USD stats at the current exchange rate |

#### Output

One `type: "market_summary"` record per keyword (`askPriceJpy`, `soldPriceJpy`, `totalListingsFound`, `inStockTotal`, `soldOutTotal`, `sampledListings`, `shopTop`, USD conversion) — see the JSON example in the Korean section — plus optionally one `item` record per sampled listing. Mandarake sells at fixed prices, so a sold-out item's listed price is close to the price it actually sold at.

#### Pricing

| Event | Price |
|---|---|
| Keyword market summary (`keyword-analyzed`) | **$0.02** |
| Individual item record (`item-scraped`) | **$0.002** each |

Individual items are OFF by default, so a default run is a flat **$0.02** per keyword. Keywords with zero listings are never charged. You pay per keyword you ask for; there is no monthly fee.

#### Notes & limits

- `totalListingsFound` includes sold-out items; `inStockTotal` (exact, from a separate filtered count) is what you can buy now. When the shop's two counts contradict each other (measured 2026-08-18: `MG Sazabi` = 1 all-items, 2 in-stock-only) the row carries `countMismatch: true` and `soldOutTotal: null`, and nothing is rounded to hide it.
- Sold-out listings carry no sale date, so no time series is possible — the split and the two price distributions are the signal.
- `askPriceJpy`, `soldPriceJpy` and `shopTop` are **sample** statistics over `sampledListings`.
- It does not read the whole catalog; no proxy buying, ordering or shipping; no personal data; and no guarantee that the web catalog matches physical shop stock.
- Adult-flagged items are included in counts and marked `isAdult` on individual records.
- Read-only and throttled (~1 request / 1.5 s). No login, no personal data, nothing stored between runs. Not affiliated with Mandarake Inc.

***

### 日本語

#### 概要 Overview

まんだらけ通販の相場をキーワード単位で1コールで返します。販売中商品の価格統計、**売切商品の価格統計**（まんだらけは定価販売のため売切価格≒実売価格）、在庫/売切の件数内訳、在庫を持つ店舗トップ5。韓国語圏の利用者（구매대행 / 리셀 / 피규어 시세）向けに韓国語で書き直したパッケージで、英語版は [Mandarake Japan Collectibles — Prices In Stock & Sold Out](https://apify.com/jpmarketdata/mandarake-market-checker)（取得・統計処理は同一）。

#### 入力 Input

`keywords`（日本語推奨）／`categoryCode`（任意、02=おもちゃ・05=カード類 など）／`maxItemsPerKeyword`（既定 120、30〜360）／`includeIndividualItems`（既定 OFF）／`convertToUsd`（既定 ON）。

#### 出力 Output

キーワードごとに `market_summary` を1件（`askPriceJpy` / `soldPriceJpy` / `totalListingsFound` / `inStockTotal` / `soldOutTotal` / `sampledListings` / `shopTop` / USD換算）。`includeIndividualItems` が ON のときは、取得した各商品の明細（タイトル・価格・店舗・在庫状況・商品URL）も出力します。

#### 料金 Pricing

キーワードサマリー（`keyword-analyzed`）**$0.02**／個別商品レコード（`item-scraped`）**$0.002 / 件**。個別明細は**既定 OFF** なので既定実行はキーワードあたり $0.02 固定です。**0件のキーワードには課金されません。** 従量課金です。

#### 注意 Notes

売切商品には販売日時が無いため**時系列分析はできません**（在庫/売切の構成と2本の価格分布が信号です）。`totalListingsFound` は売切を含み、いま買えるのは `inStockTotal` です。価格統計・店舗内訳は**サンプル基準**（母数は `sampledListings`）。全件クロールではなく、代理購入・注文・配送は行わず、個人情報も扱いません。通販カタログと実店舗の在庫が一致する保証はありません。アダルト商品は件数に含まれ、個別レコードでは `isAdult` で示します。リクエストは約1.5秒間隔、ログイン不要・実行間の保存なし。株式会社まんだらけとは無関係です。

### 문제가 생기면

- **숫자가 이상하거나 실행이 실패했나요?** **Issues** 탭에 남겨 주세요. 모두 읽고 2 영업일 안에 답합니다(일본 시간).
- **가짜 「빈 결과」는 돌려주지 않습니다.** 사이트를 읽을 수 없으면 실행이 실패하고 그렇게 알려줍니다.
- **결과가 없으면 요금이 없습니다.** 실제로 받은 결과에만 요금이 붙습니다.
- **매주 점검합니다.** 자동 테스트가 매주 돌아가고, 사이트가 바뀌면 고칩니다.
- **공개 페이지만 봅니다.** 로그인하지 않고 개인정보도 다루지 않으며, 사이트에 부담을 주지 않습니다.

### 같은 제작자의 다른 도구

- [북오프 BookOff 일본 중고책·만화·CD·게임 시세 — 중고가·재고](https://apify.com/jpmarketdata/bookoff-market-kr)
- [일본 화장품 랭킹 앳코스메 @cosme Top 50 평점·가격](https://apify.com/jpmarketdata/cosme-beauty-market-kr)
- [유유테이 Yuyu-tei 일본 카드 싱글 시세 — 판매가·매입가](https://apify.com/jpmarketdata/yuyutei-tcg-price-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)

이 도구의 다른 언어판: [English](https://apify.com/jpmarketdata/mandarake-market-checker) · [中文](https://apify.com/jpmarketdata/mandarake-market-cn)

모든 도구(일본 마켓플레이스, 부동산, 채용, 경정·경륜·경마, 예측시장): <https://apify.com/jpmarketdata>

### 면책 조항

비공식 독립 도구입니다 — **Mandarake와 제휴·보증·후원 관계가 없습니다**. 상품명과 로고는 각 소유자의 것이며 여기서는 데이터 출처를 나타낼 뿐입니다. 공개 페이지에서 읽은 데이터이며 시장 조사용입니다. 행동하기 전에 직접 확인하세요.

# Actor input Schema

## `keywords` (type: `array`):

하나 이상의 검색 키워드(일본어가 가장 잘 맞고 영어도 대개 통합니다 — 실측 2026-08-18: 'gundam' 72,482건, 'ガンダム' 72,447건). 넓은 단어는 이종 혼합 중앙값을 돌려줍니다: 'ガンダム' 은 피규어·프라모델·만화·카드를 한꺼번에 포함합니다. 바로 쓸 수 있는 가격이 필요하면 실제 팔리는 상품명으로 검색하고 카테고리를 함께 지정하세요: 'MG サザビー'(6건), 'RG νガンダム', 'HGUC 1/144'. 0건 키워드는 keywordStatus 'not\_found' 로 돌아오며 과금되지 않습니다.

## `categoryCode` (type: `string`):

검색을 만다라케의 특정 카테고리로 한정합니다. 자주 쓰는 코드: 00=전체, 11=만화/라이트노벨, 12=굿즈, 01=서적, 10=잡지, 02=완구/피규어, 03=동인, 06=영상/게임, 07=아이돌/성우, 05=카드/스티커, 04=애니메이션. 비워 두면 전체 카테고리입니다.

## `maxItemsPerKeyword` (type: `integer`):

키워드마다 최신 상품을 몇 건 표본으로 삼을지 정합니다. 120 = 결과 1페이지. 표본이 많을수록 통계가 안정적입니다. '개별 상품 출력'을 켠 경우에만 비용에 영향을 줍니다(+$0.002/건).

## `includeIndividualItems` (type: `boolean`):

기본값 꺼짐: 실행 1회당 키워드 요약이 $0.02 정액입니다. 켜면 표본으로 잡은 상품마다(제목, 가격, 점포, 재고/품절, 상품 링크) 레코드를 추가로 출력하며 건당 +$0.002가 부과됩니다.

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

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

## Actor input object example

```json
{
  "keywords": [
    "ガンダム"
  ],
  "maxItemsPerKeyword": 120,
  "includeIndividualItems": false,
  "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 = {
    "keywords": [
        "ガンダム"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("jpmarketdata/mandarake-market-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 = { "keywords": ["ガンダム"] }

# Run the Actor and wait for it to finish
run = client.actor("jpmarketdata/mandarake-market-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 '{
  "keywords": [
    "ガンダム"
  ]
}' |
apify call jpmarketdata/mandarake-market-kr --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,jpmarketdata/mandarake-market-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/aV6rF59qrcFbulWE7/builds/qpgLZrJ8PkLobL6e1/openapi.json