# 万代书店 Mandarake 日本二手手办·漫画价格 — 在售价与售罄价 (`jpmarketdata/mandarake-market-cn`) Actor

输入关键词，查看动漫手办、漫画、玩具、卡牌在日本最大二手收藏店 Mandarake（まんだらけ）卖多少钱。返回整个搜索结果的在售/售罄件数，以及基于店铺返回的前 120 条商品的在售典型价、区间与售罄典型价（接近实际卖出价）。每个关键词 $0.02，无结果不收费。Mandarake Japan in-stock and sold-out prices per keyword. Unofficial.

- **URL**: https://apify.com/jpmarketdata/mandarake-market-cn.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（まんだらけ）卖多少钱。

**你输入：** 一个或多个关键词，日文最准，如 `ガンダム`；可选分类（玩具、卡牌、漫画等）。

**你得到：** 整个搜索结果的在售与售罄件数；在售价的典型值与区间、售罄典型价（Mandarake 定价销售，售罄价接近实际卖出价）—— 价格统计基于店铺返回的前 120 条商品；这 120 条所在的门店排行；美元换算。可选：每件商品一行。

**价格：** 每个关键词 $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.

### 中文说明

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

**日本二次元、手办、同人与卡牌的跨境转卖，压倒性地是一门面向中文买家的生意**——从代购下单、日拍捡漏到国内出货，链路的每一环都在问同一个问题：这个东西在日本到底值多少钱。而**まんだらけ在中文圈本来就有一个通行的名字：万代书店**（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` 汇总记录**：在售价统计、售罄价统计、总命中数、在售总数、售罄总数、取样件数、持货门店 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=同人… 留空 = 全部 |
| `maxItemsPerKeyword` | `120` | 每个关键词取样多少件最新商品（30–360，120 = 一页） |
| `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`——两个原始计数都保留，不会为了让它们对得上而做任何取整。
- **零结果的关键词也会返回一行**：带 `keywordStatus: "not_found"` 与一行 `hint` 告诉你下一步该试什么，并且不收费。有命中时是 `keywordStatus: "ok"`、`hint: null`。
- **`askPriceJpy` / `soldPriceJpy` 是样本统计**，样本量为 `sampledListings`（以及其中的 `sampledInStock` / `sampledSoldOut`），按最新上架顺序取样。想要更稳的分布就调高 `maxItemsPerKeyword`。
- **`shopTop` 也是样本统计**，反映的是取样这批商品的门店分布，不是全站库存的门店分布。

#### 本 Actor 不做什么

- **不给出成交时间，因此做不了时间序列。** 售罄商品不带成交日期——能给的信号是「在售/售罄的构成」和「两条价格分布」，不是价格走势曲线。
- **不是全站爬虫。** 它按关键词取样并返回统计，不倾倒整个目录。
- **不代购、不下单、不查配送。** 只读公开页面。
- **不处理个人数据。** 万代书店是第一方零售商，没有卖家个人信息。
- **不保证与实体店同价。** 通贩目录与门店现货并不总是一致。

#### 价格 Pricing —— 每个关键词 $0.02

| 计费事件 | 价格 | 何时发生 |
|---|---|---|
| 关键词行情汇总（`keyword-analyzed`） | **$0.02** | 每分析一个关键词 |
| 单件商品记录（`item-scraped`） | **$0.002** | 仅当开启「输出单件商品」时 |

默认运行（1 个关键词、只要汇总）花费 **$0.02**。**零结果的关键词绝不收费。** 按关键词计费，没有月费。

#### 注意事项 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. 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 **Chinese-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 Chinese-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 Chinese 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`.
- 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-cn)
- [日本化妆品排行榜 @cosme Top 50 评分与价格](https://apify.com/jpmarketdata/cosme-beauty-market-cn)
- [日本二手乐器 Digimart 吉他·乐器价格 — 二手价与成色](https://apify.com/jpmarketdata/digimart-instrument-market-cn)
- [藤屋相机 Fujiya Camera 日本二手相机·镜头价格 — 按成色分级](https://apify.com/jpmarketdata/fujiya-camera-market-cn)
- [日本高达模型·手办 HobbyLink Japan 价格 — 现货还是预订](https://apify.com/jpmarketdata/hlj-hobby-market-cn)
- [日本二手手机店 Iosys 二手 iPhone·手机价格 — 按成色分级](https://apify.com/jpmarketdata/iosys-phone-market-cn)
- [游游亭 Yuyu-tei 日本卡牌单卡价格 — 售价与回收价](https://apify.com/jpmarketdata/yuyutei-tcg-price-cn)
- [BookOff Japan Used Manga, Books, CDs — Price & Stock](https://apify.com/jpmarketdata/bookoff-market-checker)

本工具的其他语言版本：[English](https://apify.com/jpmarketdata/mandarake-market-checker) · [한국어](https://apify.com/jpmarketdata/mandarake-market-kr)

全部工具（日本二手交易平台、房产、招聘、赛事、预测市场）：<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'。零结果的关键词会带 keywordStatus 'not\_found' 返回，且不收费。

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

把搜索限定到某一个万代书店分类。常用代码：00=全部、11=漫画/轻小说、12=周边、01=书籍、10=杂志、02=玩具/手办、03=同人、06=影像/游戏、07=偶像/声优、05=卡牌/贴纸、04=动画。留空表示全部分类。

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

每个关键词取样多少件最新商品。120 = 一个结果页。件数越多统计越稳。仅在开启「输出单件商品」时才影响费用（+$0.002/件）。

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

默认关闭：一次运行每个关键词汇总固定 $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-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 = { "keywords": ["ガンダム"] }

# Run the Actor and wait for it to finish
run = client.actor("jpmarketdata/mandarake-market-cn").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-cn --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,jpmarketdata/mandarake-market-cn"
        }
    }
}

```

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/dpKFAWb3r6VqTSEWz/builds/bGqShFUqDucXH7eYM/openapi.json