jd-selection-mcp 0.1.0__tar.gz

jd_selection_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,6 @@
+Metadata-Version: 2.4
+Name: jd-selection-mcp
+Version: 0.1.0
+Summary: 京东精选MCP服务 - 频道式购物推荐，帮消费者找到京东好货
+Requires-Python: >=3.10
+Requires-Dist: mcp>=1.0.0

jd_selection_mcp-0.1.0/README.md

@@ -0,0 +1,71 @@
+# 京东精选 MCP
+
+帮消费者找到京东好货的MCP服务，频道式购物推荐。
+
+## 功能
+
+- **频道好货推荐** - 20+精选频道（9.9包邮、秒杀、数码、超市、母婴等）
+- **猜你喜欢** - 千人千面个性化推荐
+- **类目浏览** - 京东全品类分类导航
+- **促销活动** - 当前京东联盟促销活动
+
+## 工具列表
+
+| 工具 | 功能 | 接口 |
+|------|------|------|
+| `search_channel` | 频道好货推荐 | jingfen.query |
+| `recommend_goods` | 猜你喜欢/个性化推荐 | material.query |
+| `get_categories` | 商品类目浏览 | category.goods.get |
+| `get_activities` | 促销活动查询 | activity.query |
+
+## 频道列表
+
+| 频道名 | eliteId | 特点 |
+|--------|---------|------|
+| 好券商品 | 1 | 有最优券商品 |
+| 9.9包邮 | 10 | 低价爆品 |
+| 实时热销 | 22 | 2小时热销 |
+| 数码家电 | 24 | 3C数码 |
+| 超市 | 25 | 日用百货 |
+| 母婴玩具 | 26 | 品类丰富 |
+| 美妆穿搭 | 28 | 美妆服饰 |
+| 京东好物 | 32 | 高佣+好评 |
+| 京东秒杀 | 33 | 限时秒杀 |
+| 高收益榜 | 40 | 佣金>30% |
+| 自营热卖 | 41 | 京东自营 |
+| 自营 | 110 | 全自营商品 |
+
+## 安装
+
+```bash
+pip install jd-selection-mcp
+```
+
+## 使用
+
+```bash
+jd-selection-mcp
+```
+
+或在MCP客户端配置：
+
+```json
+{
+  "mcpServers": {
+    "jd-selection": {
+      "command": "jd-selection-mcp"
+    }
+  }
+}
+```
+
+## 技术架构
+
+- 直接调用京东联盟API（宙斯端点），密钥内置
+- MD5签名认证
+- 无需额外代理或配置
+
+## 版本规划
+
+- v0.1.0: 频道推荐+类目+活动（当前）
+- v0.2.0: +关键词搜索(goods.query) + 转链(bysubunionid.get)

jd_selection_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,18 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "jd-selection-mcp"
+version = "0.1.0"
+description = "京东精选MCP服务 - 频道式购物推荐，帮消费者找到京东好货"
+requires-python = ">=3.10"
+dependencies = [
+    "mcp>=1.0.0",
+]
+
+[project.scripts]
+jd-selection-mcp = "jd_selection_mcp:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]

jd_selection_mcp-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

jd_selection_mcp-0.1.0/src/jd_selection_mcp/__init__.py

@@ -0,0 +1,439 @@
+"""
+京东精选 MCP 服务 - 直接调用京东联盟API
+帮消费者找到京东好货，频道式购物推荐
+"""
+
+import hashlib
+import json
+import time
+import urllib.request
+import urllib.parse
+from typing import Optional
+from mcp.server.fastmcp import FastMCP
+
+# 京东联盟凭证（内置）
+APP_KEY = "8b9ebb96e4cc29965db18075a70f2a57"
+APP_SECRET = "4743932a6e434f228edc1873c39ae9db"
+SITE_ID = "4105317833"
+PID = "2018138106_4105317833_3105782773"
+
+API_URL = "https://api.jd.com/routerjson"
+
+# 频道ID映射
+CHANNEL_MAP = {
+    "好券商品": 1,
+    "精选卖场": 2,
+    "9.9包邮": 10,
+    "京东配送": 15,
+    "实时热销": 22,
+    "为你推荐": 23,
+    "数码家电": 24,
+    "超市": 25,
+    "母婴玩具": 26,
+    "家具日用": 27,
+    "美妆穿搭": 28,
+    "医药保健": 29,
+    "图书文具": 30,
+    "今日必推": 31,
+    "京东好物": 32,
+    "京东秒杀": 33,
+    "拼购商品": 34,
+    "高收益榜": 40,
+    "自营热卖": 41,
+    "新品首发": 109,
+    "自营": 110,
+    "京东爆品": 112,
+    "首购商品": 125,
+    "高佣榜单": 129,
+    "视频商品": 130,
+    "历史最低价": 153,
+}
+
+# material.query的频道ID（和jingfen不同）
+MATERIAL_CHANNEL_MAP = {
+    "猜你喜欢": 1,
+    "实时热销": 2,
+    "大额券": 3,
+    "9.9包邮": 4,
+}
+
+# 排序字段映射
+SORT_NAME_MAP = {
+    "价格": "price",
+    "佣金比例": "commissionShare",
+    "佣金": "commission",
+    "销量": "inOrderCount30DaysSku",
+    "评论数": "comments",
+    "好评数": "goodComments",
+}
+
+mcp = FastMCP("jd-selection")
+
+
+def md5_sign(params: dict, app_secret: str) -> str:
+    """京东联盟API签名: MD5(secret + key1value1key2value2... + secret)"""
+    sorted_keys = sorted(params.keys())
+    raw = app_secret
+    for k in sorted_keys:
+        raw += str(k) + str(params[k])
+    raw += app_secret
+    return hashlib.md5(raw.encode("utf-8")).hexdigest().upper()
+
+
+def call_jd_api(method: str, biz_params: dict) -> dict:
+    """调用京东联盟API"""
+    timestamp = time.strftime("%Y-%m-%d %H:%M:%S", time.localtime())
+    params = {
+        "method": method,
+        "app_key": APP_KEY,
+        "timestamp": timestamp,
+        "format": "json",
+        "v": "1.0",
+        "sign_method": "md5",
+        "360buy_param_json": json.dumps(biz_params, ensure_ascii=False, separators=(",", ":")),
+    }
+    params["sign"] = md5_sign(params, APP_SECRET)
+
+    # POST请求
+    post_data = urllib.parse.urlencode(params).encode("utf-8")
+    req = urllib.request.Request(
+        API_URL, data=post_data, method="POST",
+        headers={"Content-Type": "application/x-www-form-urlencoded"},
+    )
+    try:
+        with urllib.request.urlopen(req, timeout=30) as resp:
+            return json.loads(resp.read().decode("utf-8"))
+    except Exception as e:
+        return {"error": str(e)}
+
+
+def extract_biz_data(result: dict, method: str) -> dict:
+    """提取业务数据，兼容response/responce拼写"""
+    # 京东的response key有时拼成"responce"
+    response_key = method.replace(".", "_") + "_response"
+    response_key2 = method.replace(".", "_") + "_responce"
+    biz = result.get(response_key) or result.get(response_key2)
+
+    if not biz:
+        if "error_response" in result:
+            err = result["error_response"]
+            return {"code": -1, "message": f"API错误: {err.get('zh_desc', err.get('en_desc', ''))}"}
+        return {"code": -1, "message": f"未知返回格式"}
+
+    if biz.get("code") != "0":
+        return {"code": -1, "message": f"系统错误: {biz.get('errorMessage', '')}"}
+
+    # 提取业务结果
+    qr = biz.get("queryResult") or biz.get("getResult")
+    if qr and isinstance(qr, str):
+        try:
+            qr = json.loads(qr)
+        except:
+            return {"code": -1, "message": "JSON解析失败"}
+
+    if isinstance(qr, dict):
+        return qr
+
+    return {"code": -1, "message": "无业务数据"}
+
+
+def format_goods_list(data: dict, channel_name: str = "", page: int = 1) -> str:
+    """格式化商品列表为可读文本（不暴露佣金字段）"""
+    if data.get("code") == -1:
+        return f"查询失败：{data.get('message', '未知错误')}"
+
+    code = data.get("code")
+    if code == 403:
+        return "该接口暂无访问权限，请在京东联盟后台申请权限。"
+    if code == 400:
+        return "参数错误，请检查输入。"
+    if code != 200:
+        return f"查询失败(code={code}): {data.get('message', '')}"
+
+    items = data.get("data", [])
+    total = data.get("totalCount", 0)
+
+    if not items:
+        return "暂无商品数据。"
+
+    header = f"共 {total} 件好货（第{page}页）"
+    if channel_name:
+        header = f"【{channel_name}】{header}"
+
+    lines = [header + "\n"]
+
+    for i, item in enumerate(items[:10], 1):
+        # 基本信息
+        sku_name = item.get("skuName", "")
+        price_info = item.get("priceInfo", {})
+        coupon_info = item.get("couponInfo", {})
+        shop_info = item.get("shopInfo", {})
+        category_info = item.get("categoryInfo", {})
+        image_info = item.get("imageInfo", {})
+        is_hot = item.get("isHot", 0)
+        owner = item.get("owner", "")
+
+        # 自营标识
+        self_tag = "京东自营" if owner == "g" or (shop_info and shop_info.get("shopName", "").endswith("自营旗舰店")) else ""
+
+        # 价格
+        lowest_price = price_info.get("lowestPrice", "")
+        coupon_price = price_info.get("lowestCouponPrice", "")
+        if coupon_price and coupon_price != lowest_price:
+            price_str = f"到手¥{coupon_price}（原价¥{lowest_price}）"
+        elif lowest_price:
+            price_str = f"¥{lowest_price}"
+        else:
+            price_str = "价格未知"
+
+        # 最优优惠券
+        best_coupon = None
+        coupon_list = coupon_info.get("couponList", []) if coupon_info else []
+        for c in coupon_list:
+            if c.get("isBest") == 1:
+                best_coupon = c
+                break
+        coupon_str = ""
+        if best_coupon:
+            discount = best_coupon.get("discount", 0)
+            quota = best_coupon.get("quota", 0)
+            if discount:
+                coupon_str = f" | 券¥{discount}" + (f"(满{quota}可用)" if quota else "")
+
+        # 销量
+        sales = item.get("inOrderCount30Days", 0) or item.get("inOrderCount30DaysSku", 0)
+        sales_str = f" | 月销{sales}" if sales else ""
+
+        # 好评率
+        good_rate = item.get("goodCommentsShare", 0)
+        rate_str = f" | 好评{good_rate}%" if good_rate else ""
+
+        # 评论数
+        comments = item.get("comments", 0)
+        comments_str = f" | {comments}条评论" if comments else ""
+
+        # 店铺
+        shop_name = shop_info.get("shopName", "") if shop_info else ""
+
+        # 类目
+        cat = category_info.get("cid3Name", "") if category_info else ""
+
+        # 商品链接
+        material_url = item.get("materialUrl", "")
+        if material_url and not material_url.startswith("http"):
+            material_url = f"https://{material_url}"
+
+        # 热门标识
+        hot_tag = " 🔥" if is_hot else ""
+
+        line = f"{i}. {'[' + self_tag + '] ' if self_tag else ''}{sku_name}{hot_tag}\n   {price_str}{coupon_str}{sales_str}{rate_str}"
+        if shop_name:
+            line += f" | {shop_name}"
+        if cat:
+            line += f" | {cat}"
+        if material_url:
+            line += f"\n   🔗{material_url}"
+        lines.append(line)
+
+    return "\n\n".join(lines)
+
+
+def resolve_channel(channel: str) -> int:
+    """解析频道名或ID为eliteId"""
+    # 先尝试直接匹配频道名
+    if channel in CHANNEL_MAP:
+        return CHANNEL_MAP[channel]
+    # 尝试数字ID
+    try:
+        elite_id = int(channel)
+        return elite_id
+    except:
+        pass
+    # 模糊匹配
+    for name, eid in CHANNEL_MAP.items():
+        if channel in name or name in channel:
+            return eid
+    return None
+
+
+@mcp.tool()
+def search_channel(channel: str = "好券商品", sort: str = None,
+                   has_coupon: bool = None, page: int = 1) -> str:
+    """
+    京东频道好货推荐 - 按频道浏览京东精选商品，无需关键词
+
+    这是京东最核心的购物推荐能力，涵盖20+精选频道，由京东联盟运营团队维护商品池。
+    不知道买什么的时候，用这个工具逛一逛！
+
+    可选频道：
+    - 低价好货：9.9包邮、京东秒杀、历史最低价
+    - 热门榜单：实时热销、自营热卖、高收益榜、高佣榜单
+    - 品类精选：数码家电、超市、母婴玩具、美妆穿搭、家具日用、医药保健、图书文具
+    - 优惠推荐：好券商品、今日必推、京东好物、大额券
+    - 特色频道：自营、新品首发、京东爆品、视频商品
+
+    Args:
+        channel: 频道名称（如"9.9包邮"、"数码家电"、"实时热销"）或数字ID，默认"好券商品"
+        sort: 排序方式（可选）：价格、佣金比例、销量、评论数
+        has_coupon: 是否只看有券商品，默认不限
+        page: 页码，默认1
+    """
+    elite_id = resolve_channel(channel)
+    if elite_id is None:
+        available = "、".join(list(CHANNEL_MAP.keys())[:15])
+        return f"未找到频道「{channel}」，可选频道：{available}等"
+
+    # 构建参数
+    params = {
+        "eliteId": elite_id,
+        "pageIndex": page,
+        "pageSize": 10,
+    }
+
+    # 排序
+    if sort and sort in SORT_NAME_MAP:
+        params["sortName"] = SORT_NAME_MAP[sort]
+        params["sort"] = "desc"
+
+    # 只看有券
+    if has_coupon:
+        params["hasBestCoupon"] = 1
+
+    # 查找频道名
+    channel_name = channel
+    for name, eid in CHANNEL_MAP.items():
+        if eid == elite_id:
+            channel_name = name
+            break
+
+    result = call_jd_api("jd.union.open.goods.jingfen.query", {"goodsReq": params})
+    data = extract_biz_data(result, "jd.union.open.goods.jingfen.query")
+    return format_goods_list(data, channel_name, page)
+
+
+@mcp.tool()
+def recommend_goods(channel: str = "猜你喜欢", page: int = 1) -> str:
+    """
+    京东猜你喜欢/个性化推荐 - 获取千人千面的商品推荐
+
+    适合不知道买什么、想随便看看的场景。通过不同频道获取个性化推荐结果。
+
+    可选频道：
+    - 猜你喜欢：个性化推荐
+    - 实时热销：当前热卖商品
+    - 大额券：大额优惠券商品
+    - 9.9包邮：低价包邮好货
+
+    Args:
+        channel: 频道名称（猜你喜欢/实时热销/大额券/9.9包邮），默认"猜你喜欢"
+        page: 页码，默认1
+    """
+    # 解析material频道ID
+    elite_id = MATERIAL_CHANNEL_MAP.get(channel)
+    if elite_id is None:
+        # 尝试数字
+        try:
+            elite_id = int(channel)
+        except:
+            available = "、".join(MATERIAL_CHANNEL_MAP.keys())
+            return f"未找到频道「{channel}」，可选：{available}"
+
+    params = {
+        "eliteId": elite_id,
+        "pageIndex": page,
+        "pageSize": 10,
+    }
+
+    result = call_jd_api("jd.union.open.goods.material.query", {"goodsReq": params})
+    data = extract_biz_data(result, "jd.union.open.goods.material.query")
+    return format_goods_list(data, channel, page)
+
+
+@mcp.tool()
+def get_categories(parent_id: int = 0) -> str:
+    """
+    京东商品类目浏览 - 查看京东商品分类，可逐级浏览
+
+    传入0查看所有一级类目，传入一级类目ID查看其子类目，以此类推。
+    获取类目后可用类目信息配合频道推荐做精准筛选。
+
+    Args:
+        parent_id: 父类目ID，0表示查询一级类目，默认0
+    """
+    params = {"parentId": parent_id, "grade": 0}
+    if parent_id != 0:
+        params["grade"] = 1  # 非根节点查子类目
+
+    result = call_jd_api("jd.union.open.category.goods.get", {"req": params})
+    data = extract_biz_data(result, "jd.union.open.category.goods.get")
+
+    if data.get("code") != 200:
+        return f"查询失败：{data.get('message', '未知错误')}"
+
+    categories = data.get("data", [])
+    if not categories:
+        return "未找到子类目。"
+
+    lines = [f"共 {len(categories)} 个类目：\n"]
+    for cat in categories:
+        cat_id = cat.get("id", "")
+        name = cat.get("name", "")
+        grade = cat.get("grade", 0)
+        pid = cat.get("parentId", 0)
+        indent = "  " * grade
+        lines.append(f"{indent}- {name} (ID:{cat_id})")
+
+    return "\n".join(lines)
+
+
+@mcp.tool()
+def get_activities() -> str:
+    """
+    京东促销活动查询 - 查看当前京东联盟的促销活动
+
+    返回正在进行或即将开始的促销活动，包括活动名称、时间和活动页面链接。
+    适合推荐给用户参与限时优惠。
+    """
+    result = call_jd_api("jd.union.open.activity.query", {"activityReq": {}})
+    data = extract_biz_data(result, "jd.union.open.activity.query")
+
+    if data.get("code") != 200:
+        return f"查询失败：{data.get('message', '未知错误')}"
+
+    activities = data.get("data", [])
+    if not activities:
+        return "暂无促销活动。"
+
+    # 只展示前15个活跃活动
+    lines = [f"共 {len(activities)} 个活动，展示前15个：\n"]
+    for i, act in enumerate(activities[:15], 1):
+        name = act.get("name", "") or act.get("title", "")
+        status = act.get("actStatus", 0)
+        # status: 1=未开始, 2=进行中, 3=已结束
+        status_str = {1: "未开始", 2: "进行中", 3: "已结束"}.get(status, "未知")
+        advantage = act.get("advantage", "")
+        end_time = act.get("endTime", 0)
+
+        time_str = ""
+        if end_time:
+            try:
+                time_str = time.strftime("%Y-%m-%d", time.localtime(end_time / 1000))
+            except:
+                pass
+
+        line = f"{i}. {name} [{status_str}]"
+        if advantage:
+            line += f" | {advantage}"
+        if time_str:
+            line += f" | 截止{time_str}"
+        lines.append(line)
+
+    return "\n".join(lines)
+
+
+def main():
+    mcp.run()
+
+
+if __name__ == "__main__":
+    main()

jd_selection_mcp-0.1.0/src/jd_selection_mcp.egg-info/PKG-INFO

@@ -0,0 +1,6 @@
+Metadata-Version: 2.4
+Name: jd-selection-mcp
+Version: 0.1.0
+Summary: 京东精选MCP服务 - 频道式购物推荐，帮消费者找到京东好货
+Requires-Python: >=3.10
+Requires-Dist: mcp>=1.0.0

jd_selection_mcp-0.1.0/src/jd_selection_mcp.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+pyproject.toml
+src/jd_selection_mcp/__init__.py
+src/jd_selection_mcp.egg-info/PKG-INFO
+src/jd_selection_mcp.egg-info/SOURCES.txt
+src/jd_selection_mcp.egg-info/dependency_links.txt
+src/jd_selection_mcp.egg-info/entry_points.txt
+src/jd_selection_mcp.egg-info/requires.txt
+src/jd_selection_mcp.egg-info/top_level.txt

jd_selection_mcp-0.1.0/src/jd_selection_mcp.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

jd_selection_mcp-0.1.0/src/jd_selection_mcp.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+jd-selection-mcp = jd_selection_mcp:main

jd_selection_mcp-0.1.0/src/jd_selection_mcp.egg-info/requires.txt

@@ -0,0 +1 @@
+mcp>=1.0.0

jd_selection_mcp-0.1.0/src/jd_selection_mcp.egg-info/top_level.txt

@@ -0,0 +1 @@
+jd_selection_mcp