Japan → Korea Bridge

io.github.groove79由 GitHub 账号 groove79 发布v0.1.1更新于 Oct 29, 2026

Japan→Korea sourcing: Rakuten/Yahoo search, JPY→KRW landed cost, Smart Store draft. 일본구매대행 MCP.

已验证STDIO仅桌面网页搜索与抓取金融商业与电商

概览

AI 生成的概览

面向日韩代购采购的本地 MCP 服务器：搜索乐天与 Yahoo! Japan 商品、估算韩国到岸成本，并生成 Naver Smart Store 商品草稿。

可以做什么
  • 按关键词搜索乐天市场与 Yahoo! Japan 购物商品，返回价格、店铺、图片、评价与库存
  • 获取当前日元兑韩元、美元兑韩元的中间汇率
  • 计算韩国到岸成本与建议售价，涵盖汇率、转运运费、关税与平台费用
  • 生成 Naver Smart Store 商品上架草稿 JSON，含韩文标题与描述槽位及海外代购法定披露
适用场景
适合在 Naver Smart Store 经营或计划经营日本商品代购业务，并希望由助手比价、估算到岸成本、准备待审核上架草稿的场景。
运行要求
通过 npx 在本地运行（需 Node.js）。需要免费的乐天 Web Service 应用 ID 与访问密钥（RAKUTEN_APP_ID、RAKUTEN_ACCESS_KEY）以及免费的 Yahoo! Japan Client ID（YAHOO_JP_APP_ID）。可选配置 BRIDGE_SHIPPING_BASE_JPY、BRIDGE_SHIPPING_PER_KG_JPY、BRIDGE_PLATFORM_FEE_RATE。需联网访问各商城与汇率服务。
安装前请注意
需要 API 凭据 RAKUTEN_APP_ID、RAKUTEN_ACCESS_KEY 与 YAHOO_JP_APP_ID，这些信息会发送给相应服务商。默认运费与费率仅为占位值，应替换为自己的数据。成本与关税结果仅为估算，海关使用其自有周汇率。草稿仅以 JSON 返回，不会发布任何内容，上架需另行手动操作。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Japan → Korea Bridge，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

@appmonster/mcp-japan-bridge

MCP server that turns an agent into a 일본구매대행 sourcing assistant: search Japanese marketplaces, compute the real Korea landed cost and a selling price, and draft the Smart Store listing — including the disclosures Korean consumer law requires for overseas buying-agent sales.

Built from running an actual Japan buying-agent store on Naver Smart Store. Pair it with @appmonster/mcp-naver-commerce (post the draft) or @appmonster/mcp-coupang.

Tools

ToolWhat it does
jp_search_rakuten楽天市場 keyword search — price, shop, image, reviews, stock, 送料 flag
jp_search_yahooYahoo! JAPAN Shopping search — same shape, 1 req/sec
jp_fx_rateJPY→KRW, USD→KRW mid-market rates (no key)
jp_landed_costFull landed cost + suggested price: FX → forwarder shipping → customs (USD 150 목록통관, 간이세율 20% or 관세+부가세) → marketplace fee → target margin. Every step explained
jp_listing_draftNaver originProduct draft with origin 일본, lead time, 개인통관고유부호 / 관부가세 / 반품 제한 notices, and a pre-publish checklist

All tools are read-only; nothing is posted anywhere.

Example flow (agent)

  1. jp_search_rakuten {keyword: "ポケモン ぬいぐるみ", sort: "-reviewCount"}
  2. jp_fx_rate
  3. jp_landed_cost {priceJpy: 2980, weightKg: 0.4, jpyToKrw: 9.1, usdToKrw: 1380, targetMarginRate: 0.25} → landedCostKrw 47,000 · dutyFree true · suggestedPriceKrw 68,200 · marginKrw 17,100
  4. Agent writes the Korean title/description → jp_listing_draft → review → naver_create_product (naver-commerce server, coming) or paste into 스마트스토어센터.

Setup

json
{  "mcpServers": {    "japan-bridge": {      "command": "npx",      "args": ["-y", "@appmonster/mcp-japan-bridge"],      "env": {        "RAKUTEN_APP_ID": "…",         "RAKUTEN_ACCESS_KEY": "…",        "YAHOO_JP_APP_ID": "…",        "BRIDGE_SHIPPING_BASE_JPY": "700",        "BRIDGE_SHIPPING_PER_KG_JPY": "1500",        "BRIDGE_PLATFORM_FEE_RATE": "0.06"      }    }  }}
  • Rakuten: free app at https://webservice.rakuten.co.jp (app id + access key).
  • Yahoo! JAPAN: free Client ID at https://e.developer.yahoo.co.jp.
  • BRIDGE_SHIPPING_*: your forwarder's (배대지) tariff. The defaults are rough placeholders — set yours.
  • BRIDGE_PLATFORM_FEE_RATE: Smart Store commission + PG ≈ 5.5–6.5% depending on channel; Coupang is higher.

Customs rules encoded (adjust via inputs)

  • 소액면세: goods value ≤ USD 150 per shipment → no duty/VAT (목록통관). dutyFreeUsd adjustable.
  • Above: simple mode applies 간이세율 (default 20%) on 과세가격 = goods + shipping; general mode applies HS-code dutyRate then 10% VAT on (과세가격 + duty).
  • The tool warns about 합산과세 when splitting quantities.

These are estimates for pricing decisions; customs uses its own weekly exchange rate and final classification.

Development

bash
pnpm --filter @appmonster/mcp-japan-bridge test

来源：packages/japan-bridge/README.md，提交 53af4ba

工具

5

jp_search_rakuten

Search Rakuten Ichiba (楽天市場) products by keyword: name, JPY price, shop, image, review score, stock, postage flag, item URL. 라쿠텐 상품을 검색합니다. Use to source Japanese items for a Korean listing; pass results to jp_landed_cost. Needs a keyword; RAKUTEN_APP_ID + RAKUTEN_ACCESS_KEY env.

输入参数hitspagesortkeyword必填maxPriceminPriceinStockOnly

jp_search_yahoo

Search Yahoo! JAPAN Shopping products by keyword: name, JPY price, seller, image, reviews, stock, free-shipping flag, URL. 1 request/sec limit. 야후재팬 쇼핑 상품을 검색합니다. Use alongside jp_search_rakuten to compare Japanese prices. Needs a keyword; YAHOO_JP_APP_ID env.

输入参数sortquery必填startpriceToresultsconditionpriceFrominStockOnly

jp_fx_rate

Current JPY→KRW and USD→KRW mid-market rates (open.er-api.com, refreshed daily) for use in jp_landed_cost. Customs uses its own weekly rate; this is for estimates. 엔·달러 환율을 가져옵니다. Use before jp_landed_cost unless you already have rates. Needs nothing.

无需输入参数。

jp_landed_cost

Compute the full Korea landed cost of a Japanese item and a suggested Smart Store price: JPY→KRW, forwarder shipping, Korean customs (USD 150 de minimis, 간이세율 20% or duty+VAT), marketplace fees, target margin. Pure calculation, explains every step. 일본 상품의 한국 도착 원가와 권장 판매가를 계산합니다. Use after picking an item; give priceJpy and rates (from jp_fx_rate). Needs priceJpy, jpyToKrw, usdToKrw; optional weight, shipping, tax mode, margin.

输入参数taxModedutyRateextraKrwjpyToKrw必填priceJpy必填quantityusdToKrw必填weightKgsimpleRatedutyFreeUsdshippingJpyplatformFeeRate另有 2 个

jp_listing_draft

Build a Naver Smart Store listing draft for a Japanese item: Korean title/description slots, price from jp_landed_cost, images, origin 일본, plus the 해외구매대행 disclosures Korean law requires (shipping days, customs, no-return cases, 개인통관고유부호). Returns JSON for review — nothing is posted. 스마트스토어 등록 초안을 만듭니다. Use after jp_landed_cost; the agent writes the Korean title/description, this tool supplies structure and mandatory notices. Needs the item and the suggested price.

输入参数item必填titleKo必填categoryHintleadTimeDayssellPriceKrw必填descriptionKo必填stockQuantity

版本历史

1
  1. v0.1.1最新Oct 23, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分