关于 Japan → Korea Bridge
Japan → Korea Bridge 是面向韩国代购业务的 MCP 服务,用于从日本市场选品。它整合商品搜索、到岸成本与售价估算,以及包含必要披露信息的 Naver Smart Store 商品草稿;工具不会发布商品。
主要功能
- 01搜索 Rakuten 和 Yahoo! JAPAN Shopping
- 02将 JPY、USD 换算为 KRW
- 03估算到岸成本和售价
- 04起草 Naver Smart Store 商品信息
- 05加入披露内容和发布前检查清单
适用场景
- 01寻找适合在韩国转售的日本商品
- 02采购前估算成本和利润
- 03准备 Smart Store 草稿以供审核
MCP 相关
该 MCP 服务提供只读工具,用于市场搜索、汇率查询、到岸成本估算和商品信息起草。它不会向任何市场发布内容。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
mcp.json · 通用配置
启动命令
npx -y @appmonster/mcp-japan-bridge需要配置的环境变量
RAKUTEN_APP_IDRakuten Web Service application id (free)RAKUTEN_ACCESS_KEY密钥Rakuten Web Service access key (paired with the app id)YAHOO_JP_APP_IDYahoo! JAPAN developer Client ID (free)BRIDGE_SHIPPING_BASE_JPYYour forwarder's base fee per parcel in JPY (default 700)BRIDGE_SHIPPING_PER_KG_JPYYour forwarder's rate per kg in JPY (default 1500)BRIDGE_PLATFORM_FEE_RATEMarketplace + payment fee rate (default 0.06)本地服务需要在你的电脑上安装运行环境(如 Node.js 18+)。各客户端的配置文件位置不同,请参考客户端文档。
工具
5收录的工具列表 · 更新于 1 周前
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| hits | integer | 否 | |
| page | integer | 否 | |
| sort | enum | 否 | standard | +itemPrice | -itemPrice | -reviewCount | -reviewAverage | -updateTimestamp |
| keyword | string | 是 | |
| maxPrice | integer | 否 | |
| minPrice | integer | 否 | |
| inStockOnly | boolean | 否 |
详细介绍
@appmonster/mcp-japan-bridge
MCP 服务可将 Agent 转变为日本代购选品助手:搜索日本购物平台,计算实际的韩国到岸成本和售价,并起草 Smart Store 商品刊登内容——包括韩国消费者法律对海外代购销售要求披露的信息。
本项目基于实际运营 Naver Smart Store 日本代购店铺的经验构建。可搭配 @appmonster/mcp-naver-commerce(发布草稿)或 @appmonster/mcp-coupang 使用。
工具
| 工具 | 功能 |
|---|---|
jp_search_rakuten | 楽天市場关键词搜索——价格、店铺、图片、评价、库存、运费标记 |
jp_search_yahoo | Yahoo! JAPAN Shopping 搜索——返回相同格式,每秒 1 次请求 |
jp_fx_rate | JPY→KRW、USD→KRW 中间市场汇率(无需密钥) |
jp_landed_cost | 完整到岸成本 + 建议售价:汇率换算 → 转运运费 → 关税(USD 150 以内适用目录通关,简易税率 20% 或关税 + 增值税)→ 平台费用 → 目标利润率。解释每个步骤 |
jp_listing_draft | Naver originProduct 草稿,包含原产地日本、备货时间、个人通关固有代码 / 关税与增值税 / 退货限制通知,以及发布前检查清单 |
所有工具均为只读;不会向任何平台发布内容。
示例流程(Agent)
jp_search_rakuten {keyword: "ポケモン ぬいぐるみ", sort: "-reviewCount"}jp_fx_ratejp_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- Agent 撰写韩文标题和描述 →
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"
}
}
}
}
- Rakuten:在 https://webservice.rakuten.co.jp 免费申请应用(获取 app id 和 access key)。
- Yahoo! JAPAN:在 https://e.developer.yahoo.co.jp 免费申请 Client ID。
BRIDGE_SHIPPING_*:设置转运公司的(배대지)运费标准。默认值只是粗略占位值,请设置为你自己的标准。BRIDGE_PLATFORM_FEE_RATE:Smart Store 佣金 + PG 费用,约为 5.5–6.5%,具体取决于渠道;Coupang 费用更高。
已编码的海关规则(可通过输入参数调整)
- 小额免税:每票货物价值 ≤ USD 150 → 免关税 / 增值税(目录通关)。可调整
dutyFreeUsd。 - 超出限额:
simple模式按完税价格 = 货物 + 运费,采用简易税率(默认 20%);general模式先按 HS 编码应用dutyRate,再对(完税价格 + 关税)征收 10% 增值税。 - 工具会在拆分数量时提示合并计税风险。
以上数值仅用于定价决策估算;海关使用自己的每周汇率,并会进行最终归类。
开发
pnpm --filter @appmonster/mcp-japan-bridge test
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。