{"openapi":"3.0.0","info":{"title":"什么值得买·海纳大模型消费开放接口","description":"提供什么值得买全网商品检索、180天历史底价核验、神价爆料与凑单步骤、知识图谱参数、消费长文评测及以图搜图能力。","version":"1.0.0"},"servers":[{"url":"https://smzdm-mcp.k3y.life","description":"当前服务地址"}],"paths":{"/api/tools/smzdm_search_knowledge_graph":{"post":{"summary":"smzdm_search_knowledge_graph","description":"【什么值得买·知识图谱检索】精准查询型号级数码/家电/日常消费品的产品档案。返回官方核心参数、各电商（京东/天猫/拼多多等）当前最新报价、产品核心特征、全网多维度真实用户评价（优点/缺点/避坑点）以及佐证长文链接。适合在需要了解某个具体产品规格细节、横向参数比对、用户口碑评价时调用。","operationId":"smzdm_search_knowledge_graph","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"商品实体词/具体型号，例如：\"iPhone 16 Pro\"、\"索尼 WH-1000XM5\"、\"米家扫地机器人M30 Pro\"、\"戴森 HD15\""},"categories":{"type":"string","description":"商品所属领域分类（可选）。支持：电脑数码、家用电器、个护化妆、母婴、宠物、运动户外、食品酒水、医药健康、家居百货、服饰、鞋类、箱包、配饰、手表、乐器、模玩盲盒、图书。不填则由系统自动判断。"}},"required":["query"]}}}},"responses":{"200":{"description":"成功返回 Markdown 文本与结构化数据","content":{"application/json":{"schema":{"type":"object","properties":{"markdown":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/api/tools/smzdm_search_products":{"post":{"summary":"smzdm_search_products","description":"【什么值得买·全网商品检索 Pro】召回全网各大电商在售商品 SKU、店铺、标价与实时券后价，并提供最核心的【180天历史价格走势（price_info_180_days）】、销量与好评率。适合用于全网比价、核验当前是否为历史低价/虚假促销、筛选指定价格区间与品牌的在售商品。","operationId":"smzdm_search_products","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"product_query":{"type":"string","description":"商品搜索词，如 \"4K 144Hz 显示器\"、\"降噪耳机\"、\"人体工学椅\""},"size":{"type":"number","description":"返回商品数量，默认 10，建议 5~20"},"brand_name":{"type":"string","description":"品牌筛选，如 \"Apple\"、\"联想\"、\"索尼\""},"category_name":{"type":"string","description":"品类筛选，如 \"智能手机\"、\"笔记本电脑\""},"min_price":{"type":"number","description":"最低价格（整数），如 1000"},"max_price":{"type":"number","description":"最高价格（整数），如 3000"},"sort":{"type":"string","enum":["","sale_qty","good_comments_share","price_asc","price_desc"],"description":"排序方式：sale_qty（按销量）, good_comments_share（按好评率）, price_asc（价格从低到高）, price_desc（价格从高到低）"}},"required":["product_query"]}}}},"responses":{"200":{"description":"成功返回 Markdown 文本与结构化数据","content":{"application/json":{"schema":{"type":"object","properties":{"markdown":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/api/tools/smzdm_search_discounts":{"post":{"summary":"smzdm_search_discounts","description":"【什么值得买·神价好价检索 Pro】检索什么值得买独家优质爆料、神价折扣、电商优惠券、满减活动以及【保姆级凑单/领券购买步骤】与直达购买链接。适合当用户询问“XX现在有什么优惠活动？”、“怎么买最便宜？”、“有没有神价爆料？”时调用。","operationId":"smzdm_search_discounts","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"product_query":{"type":"string","description":"想寻找优惠的商品名或关键词，如 \"iPhone 16\"、\"飞天茅台\"、\"Switch OLED\"、\"维达纸巾\""},"size":{"type":"number","description":"返回好价爆料数量，默认 10，建议 5~15"}},"required":["product_query"]}}}},"responses":{"200":{"description":"成功返回 Markdown 文本与结构化数据","content":{"application/json":{"schema":{"type":"object","properties":{"markdown":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/api/tools/smzdm_search_content":{"post":{"summary":"smzdm_search_content","description":"【什么值得买·消费内容长文检索】检索值得买社区高赞长文及站外内容平台（知乎、微信、今日头条、B站等）的深度消费分享、选购指南、详细开箱评测与避坑合集。适合在用户想看真实评测、长期体验、避坑建议时调用。","operationId":"smzdm_search_content","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"检索问题或话题，如 \"扫地机器人真实避坑指南\"、\"OLED电视长时间使用体验\"、\"轻薄本推荐\""},"return_size":{"type":"number","description":"返回文章数量，默认 10，建议 3~10"},"data_source":{"type":"array","items":{"type":"string"},"description":"数据来源平台（可选）：zdm_shequ（值得买社区）, Zhihu（知乎）, weixin（微信）, jinritoutiao（今日头条）"}},"required":["query"]}}}},"responses":{"200":{"description":"成功返回 Markdown 文本与结构化数据","content":{"application/json":{"schema":{"type":"object","properties":{"markdown":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/api/tools/smzdm_search_content_pro":{"post":{"summary":"smzdm_search_content_pro","description":"【什么值得买·全网深度内容检索 Pro】全网深度内容检索增强版。支持精准指定时间范围（最近一天/一周/一月/一年/两年），通过多源召回与重排序提供高时效性的行业趋势、新品发布动态与深度评测。","operationId":"smzdm_search_content_pro","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","description":"深度检索问题，如 \"最新发布的 AI 手机有哪些\"、\"2026年高端旗舰手机横评\""},"time_range":{"type":"string","enum":["OneDay","OneWeek","OneMonth","OneYear","TwoYear","NoLimit"],"description":"检索时间跨度：OneDay（近1天）、OneWeek（近1周）、OneMonth（近1月）、OneYear（近1年，默认）、TwoYear（近2年）、NoLimit（不限）"},"recall_num":{"type":"number","description":"召回篇数，默认 10，范围 1~50"}},"required":["query"]}}}},"responses":{"200":{"description":"成功返回 Markdown 文本与结构化数据","content":{"application/json":{"schema":{"type":"object","properties":{"markdown":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/api/tools/smzdm_search_by_image":{"post":{"summary":"smzdm_search_by_image","description":"【什么值得买·图搜商品与以图比价】输入公网可访问的图片 URL，识别图中的商品同款或相似款，输出精准品牌、四级商品分类、匹配置信度以及对应的全网优惠好价。适合用户提供商品图片或街拍图求同款时调用。","operationId":"smzdm_search_by_image","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"img_url":{"type":"string","description":"公网可访问的商品图片 URL（http/https）"},"img_num":{"type":"number","description":"返回相似商品数量，默认 5，范围 1~20"},"with_haojia":{"type":"number","enum":[0,1],"description":"是否关联返回好价优惠：1 开启（推荐），0 关闭"}},"required":["img_url"]}}}},"responses":{"200":{"description":"成功返回 Markdown 文本与结构化数据","content":{"application/json":{"schema":{"type":"object","properties":{"markdown":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/api/tools/smzdm_get_post_comments":{"post":{"summary":"smzdm_get_post_comments","description":"【什么值得买·社区评论区检索】获取指定好价爆料或长文评测的真实用户评论区楼层。包含实时状态汇报（如“刚失效”、“浙江不支持”、“变价了”）、值友神评、真实解毒槽点、更低凑单方案、品控翻车吐槽、用户所在地与等级。支持传入帖子 ID（如 \"183484394\"）或帖子完整链接 URL，支持 new/hot/old 排序与 cursor 游标翻页。","operationId":"smzdm_get_post_comments","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"article_id":{"type":"string","description":"帖子 ID 或帖子完整 URL（例如 \"183484394\" 或 \"https://www.smzdm.com/p/183484394\"）"},"order":{"type":"string","enum":["new","hot","old"],"description":"排序方式：new（最新评论优先，最快获知“刚失效/变价/缺货”等最新状态，强烈推荐），hot（热门神评优先），old（按发表时间正序）","default":"new"},"limit":{"type":"number","description":"单次返回评论条数，默认 10，最大 30","default":10},"cursor":{"type":"string","description":"翻页游标（上一批次返回的 next_cursor）。当帖子评论较多需要查阅下一页时传入此参数继续读取。"}},"required":["article_id"]}}}},"responses":{"200":{"description":"成功返回 Markdown 文本与结构化数据","content":{"application/json":{"schema":{"type":"object","properties":{"markdown":{"type":"string"},"data":{"type":"object"}}}}}}}}},"/api/tools/smzdm_get_post_detail":{"post":{"summary":"smzdm_get_post_detail","description":"【什么值得买·帖子详情直读】根据帖子 ID 或原帖完整 URL，精确原样读取单篇好价爆料或社区长文评测的完整内容。返回文章标题、作者、发布时间、更新时间、优惠到手价/电商渠道、完整正文/爆料说明/推荐理由、直达购买链接及原帖链接。适合在需要对某篇具体帖子进行深度阅读、分析长文评测细节或核验单条优惠时调用。","operationId":"smzdm_get_post_detail","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"article_id_or_url":{"type":"string","description":"帖子 ID 或原帖完整 URL（例如 \"183484394\"、\"awdwdv72\"、\"https://www.smzdm.com/p/183484394/\"、\"https://post.smzdm.com/p/awdwdv72/\"）"}},"required":["article_id_or_url"]}}}},"responses":{"200":{"description":"成功返回 Markdown 文本与结构化数据","content":{"application/json":{"schema":{"type":"object","properties":{"markdown":{"type":"string"},"data":{"type":"object"}}}}}}}}}}}