diff --git a/external_plugins/yuantoutao-commerce/.mcp.json b/external_plugins/yuantoutao-commerce/.mcp.json new file mode 100644 index 0000000..e23ab40 --- /dev/null +++ b/external_plugins/yuantoutao-commerce/.mcp.json @@ -0,0 +1,10 @@ +{ + "mcpServers": { + "yuantoutao": { + "type": "http", + "url": "https://mcp.yuantoutao.com/mcp", + "enabled": true, + "timeoutMs": 60000 + } + } +} diff --git a/external_plugins/yuantoutao-commerce/.zcode-plugin/plugin.json b/external_plugins/yuantoutao-commerce/.zcode-plugin/plugin.json new file mode 100644 index 0000000..67d6ced --- /dev/null +++ b/external_plugins/yuantoutao-commerce/.zcode-plugin/plugin.json @@ -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" + ] +} diff --git a/external_plugins/yuantoutao-commerce/README.md b/external_plugins/yuantoutao-commerce/README.md new file mode 100644 index 0000000..817d8f0 --- /dev/null +++ b/external_plugins/yuantoutao-commerce/README.md @@ -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. diff --git a/external_plugins/yuantoutao-commerce/README_CN.md b/external_plugins/yuantoutao-commerce/README_CN.md new file mode 100644 index 0000000..886e7f4 --- /dev/null +++ b/external_plugins/yuantoutao-commerce/README_CN.md @@ -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)。本市场封装按"现状"提供。 diff --git a/marketplace.json b/marketplace.json index bec6d4e..3a43b72 100644 --- a/marketplace.json +++ b/marketplace.json @@ -790,7 +790,9 @@ }, { "name": "blender", - "componentTypes": ["ui"], + "componentTypes": [ + "ui" + ], "displayName": "Blender", "displayName_i18n": { "en": "Blender", @@ -811,7 +813,9 @@ }, { "name": "excalidraw", - "componentTypes": ["ui"], + "componentTypes": [ + "ui" + ], "displayName": "Excalidraw", "displayName_i18n": { "en": "Excalidraw", @@ -832,7 +836,9 @@ }, { "name": "openpencil", - "componentTypes": ["ui"], + "componentTypes": [ + "ui" + ], "displayName": "OpenPencil", "displayName_i18n": { "en": "OpenPencil", @@ -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", @@ -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", @@ -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", @@ -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", @@ -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", @@ -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", @@ -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", @@ -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", @@ -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", @@ -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" + ] } ] }