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 分