Japan → Korea Bridge

io.github.groove79Published by GitHub account groove79v0.1.1Updated Oct 29, 2026

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

VerifiedSTDIODesktop onlyWeb Search & ScrapingFinanceBusiness & Commerce

Overview

AI-generated overview

Local MCP server for Japan-to-Korea buying-agent sourcing: searches Rakuten and Yahoo! Japan, estimates KRW landed cost, and drafts a Naver Smart Store listing.

What you can do
  • Search Rakuten Ichiba and Yahoo! Japan Shopping products by keyword, with price, shop, image, reviews and stock
  • Fetch current JPY→KRW and USD→KRW mid-market rates
  • Calculate Korea landed cost and a suggested selling price, covering FX, forwarder shipping, customs and marketplace fees
  • Build a Naver Smart Store listing draft in JSON with Korean title/description slots and overseas buying-agent disclosures
When to use it
Useful if you run or plan a Japanese-goods buying-agent store on Naver Smart Store and want an assistant to compare Japanese prices, estimate landed cost and prepare listing drafts for review.
Requirements
Runs locally via npx (Node.js). Needs a free Rakuten Web Service app id and access key (RAKUTEN_APP_ID, RAKUTEN_ACCESS_KEY) and a free Yahoo! Japan Client ID (YAHOO_JP_APP_ID). Optional settings: BRIDGE_SHIPPING_BASE_JPY, BRIDGE_SHIPPING_PER_KG_JPY, BRIDGE_PLATFORM_FEE_RATE. Network access to the marketplaces and an FX rate service.
Before you install
Requires API credentials RAKUTEN_APP_ID, RAKUTEN_ACCESS_KEY and YAHOO_JP_APP_ID, which are sent to those providers. Default shipping and fee values are placeholders and should be replaced with your own. Cost and customs figures are estimates only; customs uses its own weekly rate. The listing draft is returned as JSON and nothing is posted, so publishing is a separate manual step.

Installation

In SourceWeft

  1. Open Japan → Korea Bridge in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

Source: packages/japan-bridge/README.md at commit 53af4ba

Tools

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.

ParametershitspagesortkeywordrequiredmaxPriceminPriceinStockOnly

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.

ParameterssortqueryrequiredstartpriceToresultsconditionpriceFrominStockOnly

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.

Takes no parameters.

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.

ParameterstaxModedutyRateextraKrwjpyToKrwrequiredpriceJpyrequiredquantityusdToKrwrequiredweightKgsimpleRatedutyFreeUsdshippingJpyplatformFeeRate+2 more

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.

ParametersitemrequiredtitleKorequiredcategoryHintleadTimeDayssellPriceKrwrequireddescriptionKorequiredstockQuantity

Version history

1
  1. v0.1.1LatestOct 23, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts