Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
10 changes: 10 additions & 0 deletions external_plugins/yuantoutao-commerce/.mcp.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,10 @@
{
"mcpServers": {
"yuantoutao": {
"type": "http",
"url": "https://mcp.yuantoutao.com/mcp",
"enabled": true,
"timeoutMs": 60000
}
}
}
24 changes: 24 additions & 0 deletions external_plugins/yuantoutao-commerce/.zcode-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
{
"name": "yuantoutao-commerce",
"description": "Yuantoutao Commerce MCP: product search, coupon-aware price comparison, affiliate buy links and order fulfillment across Taobao/Tmall, JD and Pinduoduo (2M+ curated SKUs).",
"description_i18n": {
"en": "Yuantoutao Commerce MCP: product search, coupon-aware price comparison, affiliate buy links and order fulfillment across Taobao/Tmall, JD and Pinduoduo (2M+ curated SKUs).",
"zh-CN": "源头淘电商 MCP:商品搜索、券后比价、带归因购买链接与订单履约,覆盖淘宝/天猫、京东、拼多多(200 万+ 精选商品)。"
},
"version": "0.1.0",
"author": {
"name": "MeshTok",
"url": "https://github.com/MeshTok"
},
"homepage": "https://github.com/MeshTok/dsh-plugin-yuantoutao",
"keywords": [
"yuantoutao",
"e-commerce",
"shopping",
"mcp",
"taobao",
"jd",
"pinduoduo",
"price-comparison"
]
}
39 changes: 39 additions & 0 deletions external_plugins/yuantoutao-commerce/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
# Yuantoutao Commerce (yuantoutao-commerce)

[简体中文](./README_CN.md)

A ZCode plugin that connects your agent to the **Yuantoutao Commerce MCP** — one remote MCP server that gives the agent real e-commerce ability: product search, coupon-aware price comparison, affiliate buy links and order fulfillment across **Taobao/Tmall, JD and Pinduoduo** (2M+ curated SKUs).

This plugin only registers a remote HTTP MCP server. It contains no commands, skills, agents, or hooks.

## What the agent can do

- **Conversational shopping** — natural-language product search with budget and preference ("gift under ¥500", "cheapest, must be genuine")
- **Explainable ranking** — every item ships a score plus per-factor reasons (price vs category average, shop tier, sales, coupon) that can be quoted directly
- **Coupon-aware comparison** — side-by-side matrix for 2–6 items with final-after-coupon prices
- **Affiliate buy links & fulfillment** — attributed buy links, idempotent orders, waybill tracking (requires a free developer key)
- Keyless read-only tier works out of the box: search/compare/buy-links need no signup

The server namespace is `plugin:yuantoutao-commerce:yuantoutao`; tools are discovered dynamically (e.g. `cps_smart_search`, `cps_compare`, `cps_jd_goods_search`, `cps_pdd_goods_search`, `search_goods`, `create_order`, `get_logistics`). Agents should follow the tool schemas returned in-session instead of guessing names.

## Usage

1. Install and enable **源头淘电商 / Yuantoutao Commerce** in the ZCode plugin manager.
2. Ask a natural-language shopping question, for example:

> 帮我在淘宝找 300 元以内的保温杯,按券后价比一比,给我买链接。

3. Optional: create a free developer key at [yuantoutao.com/console](https://yuantoutao.com/console/) to unlock live fan-out to Taobao/JD/Pinduoduo, orders and a 3% commission share on attributed purchases. Free keys never expire.

Full tool documentation: [llms.txt](https://yuantoutao.com/llms.txt) · upstream plugin source (MIT): [MeshTok/dsh-plugin-yuantoutao](https://github.com/MeshTok/dsh-plugin-yuantoutao)

## Network access and side effects

- **Network**: the plugin talks to the remote MCP endpoint `https://mcp.yuantoutao.com/mcp` (HTTP, Streamable HTTP transport). The service, in turn, queries Taobao/Tmall, JD and Pinduoduo open-platform APIs server-side.
- **Writes**: read-only tools work keylessly. Order-creation tools only work after a developer key is configured by the user on the service side; the plugin itself performs no local file writes, command execution, or hooks.
- **Credentials**: none are required or stored by this plugin. If the user chooses to use a developer key, it is configured in the Yuantoutao console, not in this repository.
- **Third-party content**: product data, prices and coupon info are provided by the Yuantoutao service (third-party, not affiliated with Z.ai). The upstream plugin code is MIT-licensed; product data remains subject to the respective platforms' terms.

## License

The upstream plugin source is [MIT](https://github.com/MeshTok/dsh-plugin-yuantoutao). This marketplace wrapper is provided as-is.
39 changes: 39 additions & 0 deletions external_plugins/yuantoutao-commerce/README_CN.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
# 源头淘电商(yuantoutao-commerce)

[English](./README.md)

把你的 Agent 接入**源头淘电商 MCP**——一个远程 MCP 服务,让 AI 具备真实的电商能力:商品搜索、券后比价、带归因购买链接与订单履约,覆盖**淘宝/天猫、京东、拼多多**(200 万+ 精选商品)。

本插件只注册一个远程 HTTP MCP 服务,不包含命令、技能、Agent 或 Hook。

## 能做什么

- **对话购物** — 自然语言搜商品,支持预算与偏好("500 元以内送女友的礼物"、"最便宜的正品")
- **可解释排序** — 每个商品带评分与逐项理由(价格 vs 品类均价、店铺层级、销量、优惠券),可直接引用
- **券后比价** — 2–6 个商品并排对比矩阵,统一按券后价
- **带归因购买链接与履约** — 归因购买链接、幂等下单、物流跟踪(需免费开发者 key)
- **免注册即用** — 只读能力(搜索/比价/购买链接)无需任何 key

服务的命名空间为 `plugin:yuantoutao-commerce:yuantoutao`;工具动态发现(如 `cps_smart_search`、`cps_compare`、`cps_jd_goods_search`、`cps_pdd_goods_search`、`search_goods`、`create_order`、`get_logistics`)。请以会话内返回的工具 schema 为准,不要猜测工具名。

## 使用方式

1. 在 ZCode 插件管理器中安装并启用**源头淘电商 / Yuantoutao Commerce**。
2. 直接用自然语言提问,例如:

> 帮我在淘宝找 300 元以内的保温杯,按券后价比一比,给我买链接。

3. 可选:在[源头淘开发者控制台](https://yuantoutao.com/console/)免费领取开发者 key,解锁淘宝/京东/拼多多实时扇出、下单与成交额 3% 开发者分成。免费 key 永不过期。

完整工具文档:[llms.txt](https://yuantoutao.com/llms.txt) · 上游插件源码(MIT):[MeshTok/dsh-plugin-yuantoutao](https://github.com/MeshTok/dsh-plugin-yuantoutao)

## 网络访问与副作用说明

- **网络**:插件连接远程 MCP 端点 `https://mcp.yuantoutao.com/mcp`(HTTP,Streamable HTTP 传输)。该服务在服务端查询淘宝/天猫、京东、拼多多开放平台接口。
- **写入**:只读工具免 key 可用。下单类工具需用户在服务侧配置开发者 key 后才可用;插件本身不做本地文件写入、命令执行,也没有 Hook。
- **凭据**:本插件不需要也不存储任何凭据。如用户选择使用开发者 key,请在源头淘控制台配置,不要提交到本仓库。
- **第三方内容**:商品数据、价格与券信息由源头淘服务提供(第三方服务,与 Z.ai 无关)。上游插件代码为 MIT 许可;商品数据遵循各平台相应条款。

## 许可证

上游插件源码为 [MIT](https://github.com/MeshTok/dsh-plugin-yuantoutao)。本市场封装按"现状"提供。
73 changes: 61 additions & 12 deletions marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -790,7 +790,9 @@
},
{
"name": "blender",
"componentTypes": ["ui"],
"componentTypes": [
"ui"
],
"displayName": "Blender",
"displayName_i18n": {
"en": "Blender",
Expand All @@ -811,7 +813,9 @@
},
{
"name": "excalidraw",
"componentTypes": ["ui"],
"componentTypes": [
"ui"
],
"displayName": "Excalidraw",
"displayName_i18n": {
"en": "Excalidraw",
Expand All @@ -832,7 +836,9 @@
},
{
"name": "openpencil",
"componentTypes": ["ui"],
"componentTypes": [
"ui"
],
"displayName": "OpenPencil",
"displayName_i18n": {
"en": "OpenPencil",
Expand All @@ -855,7 +861,9 @@
"name": "photocraft",
"icon": "https://cdn-zcode.z.ai/zcode/official-plugin/assets/photocraft/icon.png",
"source": "./external_plugins/photocraft",
"componentTypes": ["ui"],
"componentTypes": [
"ui"
],
"displayName": "PhotoCraft",
"displayName_i18n": {
"en": "PhotoCraft",
Expand All @@ -882,7 +890,9 @@
"name": "vectorcraft",
"icon": "https://cdn-zcode.z.ai/zcode/official-plugin/assets/vectorcraft/icon.png",
"source": "./external_plugins/vectorcraft",
"componentTypes": ["ui"],
"componentTypes": [
"ui"
],
"displayName": "VectorCraft",
"displayName_i18n": {
"en": "VectorCraft",
Expand All @@ -909,7 +919,9 @@
"name": "pdfcraft",
"icon": "https://cdn-zcode.z.ai/zcode/official-plugin/assets/pdfcraft/icon.png",
"source": "./external_plugins/pdfcraft",
"componentTypes": ["ui"],
"componentTypes": [
"ui"
],
"displayName": "PdfCraft",
"displayName_i18n": {
"en": "PdfCraft",
Expand All @@ -936,7 +948,9 @@
"name": "designcraft",
"icon": "https://cdn-zcode.z.ai/zcode/official-plugin/assets/designcraft/icon.png",
"source": "./external_plugins/designcraft",
"componentTypes": ["ui"],
"componentTypes": [
"ui"
],
"displayName": "DesignCraft",
"displayName_i18n": {
"en": "DesignCraft",
Expand All @@ -963,7 +977,9 @@
"name": "wordcraft",
"icon": "https://cdn-zcode.z.ai/zcode/official-plugin/assets/wordcraft/icon.png",
"source": "./external_plugins/wordcraft",
"componentTypes": ["ui"],
"componentTypes": [
"ui"
],
"displayName": "WordCraft",
"displayName_i18n": {
"en": "WordCraft",
Expand All @@ -990,7 +1006,9 @@
"name": "gridcraft",
"icon": "https://cdn-zcode.z.ai/zcode/official-plugin/assets/gridcraft/icon.png",
"source": "./external_plugins/gridcraft",
"componentTypes": ["ui"],
"componentTypes": [
"ui"
],
"displayName": "GridCraft",
"displayName_i18n": {
"en": "GridCraft",
Expand All @@ -1017,7 +1035,9 @@
"name": "deckcraft",
"icon": "https://cdn-zcode.z.ai/zcode/official-plugin/assets/deckcraft/icon.png",
"source": "./external_plugins/deckcraft",
"componentTypes": ["ui"],
"componentTypes": [
"ui"
],
"displayName": "DeckCraft",
"displayName_i18n": {
"en": "DeckCraft",
Expand All @@ -1044,7 +1064,9 @@
"name": "cadcraft",
"icon": "https://cdn-zcode.z.ai/zcode/official-plugin/assets/cadcraft/icon.png",
"source": "./external_plugins/cadcraft",
"componentTypes": ["ui"],
"componentTypes": [
"ui"
],
"displayName": "CADCraft",
"displayName_i18n": {
"en": "CADCraft",
Expand All @@ -1071,7 +1093,9 @@
"name": "soundcraft",
"icon": "https://cdn-zcode.z.ai/zcode/official-plugin/assets/soundcraft/icon.png",
"source": "./external_plugins/soundcraft",
"componentTypes": ["ui"],
"componentTypes": [
"ui"
],
"displayName": "SoundCraft",
"displayName_i18n": {
"en": "SoundCraft",
Expand Down Expand Up @@ -1283,6 +1307,31 @@
"x402",
"multi-agent"
]
},
{
"name": "yuantoutao-commerce",
"source": "./external_plugins/yuantoutao-commerce",
"description": "Yuantoutao Commerce MCP: product search, coupon-aware price comparison, affiliate buy links and order fulfillment across Taobao/Tmall, JD and Pinduoduo (2M+ curated SKUs).",
"description_i18n": {
"en": "Yuantoutao Commerce MCP: product search, coupon-aware price comparison, affiliate buy links and order fulfillment across Taobao/Tmall, JD and Pinduoduo (2M+ curated SKUs).",
"zh-CN": "源头淘电商 MCP:商品搜索、券后比价、带归因购买链接与订单履约,覆盖淘宝/天猫、京东、拼多多(200 万+ 精选商品)。"
},
"version": "0.1.0",
"author": {
"name": "MeshTok",
"url": "https://github.com/MeshTok"
},
"category": "productivity",
"keywords": [
"yuantoutao",
"e-commerce",
"shopping",
"mcp",
"taobao",
"jd",
"pinduoduo",
"price-comparison"
]
}
]
}