Japan → Korea Bridge

@appmonster/mcp-japan-bridge

エージェントを日本購入代行の仕入れアシスタントにする MCP サーバーです。日本のマーケットプレイスを検索し、韓国での実質的な着地原価と販売価格を計算して、スマートストアの商品掲載案を作成します。海外購入代行販売に関して韓国の消費者法で義務付けられている表示も含まれます。

Naver Smart Storeで実際に日本の購入代行ストアを運営した経験をもとに作成されています。@appmonster/mcp-naver-commerce（掲載案の投稿用）または@appmonster/mcp-coupangと組み合わせてください。

ツール

ツール	機能
jp_search_rakuten	楽天市場のキーワード検索 — 価格、ショップ、画像、レビュー、在庫、送料フラグ
jp_search_yahoo	Yahoo! JAPAN Shoppingの検索 — 同じ形式、1 req/sec
jp_fx_rate	JPY→KRW、USD→KRWの市場仲値（キー不要）
jp_landed_cost	着地原価全額＋推奨価格：為替 → 転送業者の送料 → 関税（USD 150 목록통관、간이세율 20%または関税＋付加価値税）→ マーケットプレイス手数料 → 目標利益率。各手順の説明付き
jp_listing_draft	原産国 일본、リードタイム、個人通関固有符号／関税・付加価値税／返品制限の注意事項、および公開前チェックリストを含むNaver originProductの掲載案

すべてのツールは読み取り専用です。どこにも投稿されません。

使用例（エージェント）

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. エージェントが韓国語の商品名／説明文を作成 → jp_listing_draft → 確認 → naver_create_product（naver-commerce サーバー、近日公開）またはスマートストアセンターに貼り付けます。

セットアップ

{
  "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"
      }
    }
  }
}

• 楽天： https://webservice.rakuten.co.jp で無料アプリを取得します（アプリ ID ＋アクセスキー）。
• Yahoo! JAPAN： https://e.developer.yahoo.co.jp で無料のClient IDを取得します。
• BRIDGE_SHIPPING_*：利用する転送業者（배대지）の料金表です。デフォルト値はおおまかな仮の値なので、ご自身の料金を設定してください。
• BRIDGE_PLATFORM_FEE_RATE：スマートストアの販売手数料＋PGは、チャネルによって約5.5～6.5％です。Coupangはより高くなります。

実装されている関税ルール（入力値で調整可能）

• 少額免税：1件の発送における商品価格がUSD 150以下の場合、関税／付加価値税はかかりません（목록통관）。dutyFreeUsdで調整できます。
• 上限を超える場合：simpleモードでは、課税価格＝商品＋送料に簡易税率（デフォルト20％）を適用します。generalモードでは、HSコードのdutyRateを適用した後、（課税価格＋関税）に10％の付加価値税を適用します。
• 数量を分割した場合の合算課税について、ツールが警告します。

価格決定のための推定値です。税関では独自の週間為替レートと最終的な品目分類が使用されます。

開発

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