pdd-selection-mcp 0.1.0__tar.gz

pdd_selection_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,6 @@
+Metadata-Version: 2.4
+Name: pdd-selection-mcp
+Version: 0.1.0
+Summary: 拼多多精选MCP服务 - 全网比价好帮手，通过SCF代理调用拼多多联盟API
+Requires-Python: >=3.10
+Requires-Dist: mcp

pdd_selection_mcp-0.1.0/pdd_selection_mcp/__init__.py

@@ -0,0 +1,310 @@
+"""
+拼多多精选 MCP 服务 v0.1.0 - 魔搭部署版
+通过腾讯云SCF代理调用拼多多联盟API
+统一 type+params 请求格式 + X-Proxy-Token 鉴权
+5个接口：search / detail / generate_url / recommend / pid_query
+"""
+
+import os
+import json
+import urllib.request
+from typing import Optional
+from mcp.server.fastmcp import FastMCP
+
+# 腾讯云SCF代理地址（拼多多精选专用）
+PROXY_URL = os.environ.get("PDD_PROXY_URL", "https://1439498936-1iog1h3lb1.ap-guangzhou.tencentscf.com")
+PROXY_TOKEN = os.environ.get("PROXY_TOKEN", "tp_8k2mX9vQ4z")
+
+mcp = FastMCP("pdd-selection")
+
+
+def call_proxy(rtype, params):
+    """调用SCF代理 - type+params格式"""
+    data = json.dumps({"type": rtype, "params": params}).encode("utf-8")
+    req = urllib.request.Request(
+        PROXY_URL,
+        data=data,
+        method="POST",
+        headers={
+            "Content-Type": "application/json",
+            "X-Proxy-Token": PROXY_TOKEN,
+        },
+    )
+    try:
+        with urllib.request.urlopen(req, timeout=60) as resp:
+            return json.loads(resp.read().decode("utf-8"))
+    except Exception as e:
+        return {"ok": False, "error": str(e)}
+
+
+def format_search_results(data):
+    """格式化搜索结果"""
+    if not data.get("ok"):
+        return "搜索失败：" + data.get("error", "未知错误")
+
+    results = data.get("data", [])
+    total = data.get("total", 0)
+
+    if not results:
+        return "没有找到符合条件的商品，建议换一个关键词试试。"
+
+    lines = ["共找到 {} 件商品：\n".format(total)]
+
+    for i, item in enumerate(results, 1):
+        name = item.get("goods_name", "")
+        final_price = item.get("final_price", 0)
+        min_group_price = item.get("min_group_price", 0)
+        coupon_discount = item.get("coupon_discount", 0)
+        has_coupon = item.get("has_coupon", False)
+        sales = item.get("sales_tip", "")
+        mall = item.get("mall_name", "")
+        category = item.get("category_name", "")
+        goods_sign = item.get("goods_sign", "")
+        image = item.get("goods_image_url", "")
+
+        # 价格
+        if coupon_discount > 0 and has_coupon:
+            price_str = "到手价¥{}（拼团价¥{} - 券¥{}）".format(final_price, min_group_price, coupon_discount)
+        else:
+            price_str = "拼团价¥{}".format(min_group_price)
+
+        # 优惠券标记
+        coupon_tag = " | 有券" if has_coupon else ""
+
+        # 销量
+        sales_str = " | 销量{}".format(sales) if sales else ""
+
+        # 店铺
+        mall_str = " | {}".format(mall) if mall else ""
+
+        # 分类
+        cat_str = " | {}".format(category) if category else ""
+
+        line = "{}. {}{}{}\n   {}{}{}{}\n   goods_sign: {}".format(
+            i, name, coupon_tag, sales_str,
+            price_str, mall_str, cat_str,
+            " | 图:{}".format(image[:50]) + "..." if image else "",
+            goods_sign
+        )
+        lines.append(line)
+
+    return "\n\n".join(lines)
+
+
+def format_detail(data):
+    """格式化商品详情"""
+    if not data.get("ok"):
+        return "查询失败：" + data.get("error", "未知错误")
+
+    item = data.get("data", {})
+    if not item:
+        return "未找到该商品信息"
+
+    name = item.get("goods_name", "")
+    desc = item.get("goods_desc", "")
+    brand = item.get("brand_name", "")
+    mall = item.get("mall_name", "")
+    category = item.get("category_name", "")
+    final_price = item.get("final_price", 0)
+    min_group_price = item.get("min_group_price", 0)
+    min_normal_price = item.get("min_normal_price", 0)
+    coupon_discount = item.get("coupon_discount", 0)
+    coupon_min_order = item.get("coupon_min_order", 0)
+    has_coupon = item.get("has_coupon", False)
+    sales = item.get("sales_tip", "")
+    goods_sign = item.get("goods_sign", "")
+    goods_id = item.get("goods_id", "")
+    image = item.get("goods_image_url", "")
+    gallery = item.get("goods_gallery_urls", [])
+    sku_list = item.get("sku_list", [])
+
+    lines = [
+        name,
+        "品牌：{} | 店铺：{} | 分类：{}".format(brand or "未知", mall or "未知", category or "未知"),
+    ]
+
+    # 价格信息
+    if coupon_discount > 0 and has_coupon:
+        lines.append("到手价：¥{}（拼团价¥{} - 优惠券¥{}，满¥{}可用）".format(
+            final_price, min_group_price, coupon_discount, coupon_min_order))
+    else:
+        lines.append("拼团价：¥{} | 单买价：¥{}".format(min_group_price, min_normal_price))
+
+    if sales:
+        lines.append("销量：{}".format(sales))
+
+    if image:
+        lines.append("主图：{}".format(image))
+
+    if sku_list:
+        lines.append("规格：")
+        for sku in sku_list[:10]:
+            lines.append("  {} - ¥{}".format(sku.get("spec", ""), sku.get("price", 0)))
+
+    lines.append("goods_sign: {}".format(goods_sign))
+    lines.append("goods_id: {}".format(goods_id))
+
+    return "\n".join(lines)
+
+
+def format_generate_url(data):
+    """格式化推广链接"""
+    if not data.get("ok"):
+        return "生成失败：" + data.get("error", "未知错误")
+
+    item = data.get("data", {})
+    if not item:
+        return "生成失败：返回为空"
+
+    lines = []
+    short_url = item.get("short_url", "")
+    mobile_url = item.get("mobile_url", "")
+
+    if short_url:
+        lines.append("短链接：{}".format(short_url))
+    if mobile_url:
+        lines.append("移动端链接：{}".format(mobile_url))
+
+    we_app_id = item.get("we_app_app_id", "")
+    we_app_path = item.get("we_app_page_path", "")
+    if we_app_id:
+        lines.append("小程序：{} {}".format(we_app_id, we_app_path))
+
+    return "\n".join(lines) if lines else "生成失败：无链接返回"
+
+
+def format_recommend(data):
+    """格式化推荐结果"""
+    if not data.get("ok"):
+        return "推荐失败：" + data.get("error", "未知错误")
+
+    results = data.get("data", [])
+    if not results:
+        return "暂无推荐商品"
+
+    lines = ["为您推荐 {} 件商品：\n".format(len(results))]
+
+    for i, item in enumerate(results, 1):
+        name = item.get("goods_name", "")
+        final_price = item.get("final_price", 0)
+        min_group_price = item.get("min_group_price", 0)
+        coupon_discount = item.get("coupon_discount", 0)
+        has_coupon = item.get("has_coupon", False)
+        sales = item.get("sales_tip", "")
+        goods_sign = item.get("goods_sign", "")
+
+        if coupon_discount > 0 and has_coupon:
+            price_str = "到手价¥{}".format(final_price)
+        else:
+            price_str = "¥{}".format(min_group_price)
+
+        sales_str = " | 销量{}".format(sales) if sales else ""
+        line = "{}. {} | {}{}\n   goods_sign: {}".format(i, name, price_str, sales_str, goods_sign)
+        lines.append(line)
+
+    return "\n\n".join(lines)
+
+
+@mcp.tool()
+def search_goods(keyword: str, sort_type: Optional[int] = None,
+                 cat_id: Optional[int] = None, has_coupon: Optional[bool] = None,
+                 price_min: Optional[float] = None, price_max: Optional[float] = None,
+                 page: int = 1, page_size: int = 20) -> str:
+    """
+    拼多多商品搜索 - 关键词搜索拼多多商品
+
+    适用场景：搜索任意商品，支持价格筛选、优惠券筛选、分类筛选、排序等
+
+    Args:
+        keyword: 搜索关键词，如"iPhone 17"、"夏季连衣裙"、"跑步鞋"
+        sort_type: 排序方式（可选）：0-综合排序 1-价格升序 2-价格降序 3-销量排序 6-佣金比例 9-优惠券面额
+        cat_id: 分类ID（可选）
+        has_coupon: 仅显示有优惠券的商品（可选）
+        price_min: 最低价格（可选，单位元）
+        price_max: 最高价格（可选，单位元）
+        page: 页码，默认1
+        page_size: 每页数量，默认20，最小10最大100
+    """
+    params = {"keyword": keyword, "page": page, "page_size": max(10, min(page_size, 100))}
+    if sort_type is not None:
+        params["sort_type"] = sort_type
+    if cat_id is not None:
+        params["cat_id"] = cat_id
+    if has_coupon is not None:
+        params["with_coupon"] = "true" if has_coupon else "false"
+    if price_min is not None:
+        params["range_from"] = int(price_min * 100)
+    if price_max is not None:
+        params["range_to"] = int(price_max * 100)
+
+    data = call_proxy("search", params)
+    return format_search_results(data)
+
+
+@mcp.tool()
+def get_goods_detail(goods_sign: str) -> str:
+    """
+    拼多多商品详情 - 通过goods_sign获取商品完整信息
+
+    适用场景：已知商品goods_sign，获取详情（价格、优惠券、SKU规格、图片等）
+
+    Args:
+        goods_sign: 商品签名ID（从搜索或推荐结果获取），如"E932cKJQRhht7tuxwfDAxrupzXBiZpWMgg_JQPw6VPiN3"
+    """
+    data = call_proxy("detail", {"goods_sign": goods_sign})
+    return format_detail(data)
+
+
+@mcp.tool()
+def generate_promotion_url(goods_sign: str, generate_short_url: bool = True,
+                           generate_we_app: bool = True, generate_h5: bool = True) -> str:
+    """
+    拼多多推广链接生成 - 生成商品推广短链接和小程序路径
+
+    适用场景：为商品生成推广链接，包含短链接、移动端链接和小程序路径
+
+    Args:
+        goods_sign: 商品签名ID（从搜索或推荐结果获取）
+        generate_short_url: 生成短链接，默认true
+        generate_we_app: 生成小程序路径，默认true
+        generate_h5: 生成H5链接，默认true
+    """
+    data = call_proxy("generate_url", {
+        "goods_sign_list": [goods_sign],
+        "generate_short_url": generate_short_url,
+        "generate_we_app": generate_we_app,
+        "generate_h5": generate_h5,
+    })
+    return format_generate_url(data)
+
+
+@mcp.tool()
+def get_recommend_goods(channel_type: int = 1, activity_tags: Optional[str] = None,
+                        limit: int = 20) -> str:
+    """
+    拼多多推荐商品 - 获取热门推荐商品列表
+
+    适用场景：获取热销榜、猜你喜欢、相似商品推荐等
+
+    Args:
+        channel_type: 频道类型：1-今日销量榜 3-相似商品推荐 4-猜你喜欢 5-实时热销榜 6-实时收益榜
+        activity_tags: 活动标签（可选）：4-秒杀 7-百亿补贴 10851-千万补贴 31-品牌黑标 10564-精选爆品官方直推
+        limit: 返回数量，默认20，最小10最大100
+    """
+    params = {
+        "channel_type": channel_type,
+        "limit": max(10, min(limit, 100)),
+    }
+    if activity_tags:
+        params["activity_tags"] = activity_tags
+
+    data = call_proxy("recommend", params)
+    return format_recommend(data)
+
+
+def main():
+    mcp.run()
+
+
+if __name__ == "__main__":
+    main()

pdd_selection_mcp-0.1.0/pdd_selection_mcp.egg-info/PKG-INFO

@@ -0,0 +1,6 @@
+Metadata-Version: 2.4
+Name: pdd-selection-mcp
+Version: 0.1.0
+Summary: 拼多多精选MCP服务 - 全网比价好帮手，通过SCF代理调用拼多多联盟API
+Requires-Python: >=3.10
+Requires-Dist: mcp

pdd_selection_mcp-0.1.0/pdd_selection_mcp.egg-info/SOURCES.txt

@@ -0,0 +1,8 @@
+pyproject.toml
+pdd_selection_mcp/__init__.py
+pdd_selection_mcp.egg-info/PKG-INFO
+pdd_selection_mcp.egg-info/SOURCES.txt
+pdd_selection_mcp.egg-info/dependency_links.txt
+pdd_selection_mcp.egg-info/entry_points.txt
+pdd_selection_mcp.egg-info/requires.txt
+pdd_selection_mcp.egg-info/top_level.txt

pdd_selection_mcp-0.1.0/pdd_selection_mcp.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pdd_selection_mcp-0.1.0/pdd_selection_mcp.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+pdd-selection-mcp = pdd_selection_mcp:main

pdd_selection_mcp-0.1.0/pdd_selection_mcp.egg-info/requires.txt

@@ -0,0 +1 @@
+mcp

pdd_selection_mcp-0.1.0/pdd_selection_mcp.egg-info/top_level.txt

@@ -0,0 +1 @@
+pdd_selection_mcp

pdd_selection_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,13 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "pdd-selection-mcp"
+version = "0.1.0"
+description = "拼多多精选MCP服务 - 全网比价好帮手，通过SCF代理调用拼多多联盟API"
+requires-python = ">=3.10"
+dependencies = ["mcp"]
+
+[project.scripts]
+pdd-selection-mcp = "pdd_selection_mcp:main"

pdd_selection_mcp-0.1.0/setup.cfg

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