BS

bintangtimurlangit/shopee-mcp

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

26 stars 17 forks 质量 80 趋势 25MIT

通过认证的CloakBrowser会话,用于探索Shopee产品列表和价格的MCP服务器。仅限发现。

概览

一个MCP服务器,适用于任何MCP客户端(Claude Desktop、Claude Code等)的产品搜索、价格、评价、商店和闪售。仅限发现:无卖家功能。 Shopee会屏蔽匿名请求,因此该服务器会通过你登录的浏览器会话读取公共数据(参见为什么要浏览器?)。登出后为只读;登录后它还提供实验性账户工具,用于你的订单、购物车、代金券、点赞和关注。 根据MCP注释规范——所有默认工具都是只读的,没有副作用。 当保存会话为 时,服务器还提供可操作的工具。当不支持时,你会得到上述只读工具,账户工具则隐藏。服务器在启动时后台检查登录情况,以及每当check_login_status运行或请求报告会话中断时,并告诉你的 MCP 客户端刷新工具列表(通知/工具/list_changed)。设置 SHOPEE_ACCOUNT_TOOLS=off 保持只读,即使登录也一样。

概述(AI 翻译)

一个用于探索Shopee的MCP服务器——包括产品搜索、价格、评价、商店和闪售——来自任何MCP客户端(Claude Desktop、Claude Code等)。仅限发现:无卖家功能。

需登录,唯读。 Shopee屏蔽匿名请求,因此这个非官方服务器通过你登录的浏览器会话读取公共数据(参见为什么是浏览器?)。登出后为只读;登录后还提供实验性账户工具,用于你的订单、购物车、代金券、点赞和关注。

完整参考文献: 文档 ·更新日志: CHANGELOG.md ·版本控制与发布: docs/RELEASES.md

工具

工具 它返回的内容
search_products 关键词搜索,带排序功能,筛选器(价格范围、最低评分、卖家位置、仅限Shopee Mall)和页码——价格、销售次数、ID、网址。
get_product_detail 一个产品——价格与折扣、评分、销售数量、库存、类别、规格、运费(费用、免运费门槛、预计到达时间)、卖家、描述。

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

shopee-mcp

An MCP server for exploring Shopee — product search, prices, reviews, shops and flash sales — from any MCP client (Claude Desktop, Claude Code, etc.). Discovery only: no seller features.

Login required, read-only. Shopee blocks anonymous requests, so this unofficial server reads public data through your own logged-in browser session (see Why a browser?). Signed out it is read-only; signed in it also offers experimental account tools for your orders, cart, vouchers, likes and follows.

Full reference: Documentation · Changelog: CHANGELOG.md · Versioning & releases: docs/RELEASES.md

Tools

Tool What it returns
search_products Keyword search with sorting, filters (price range, min rating, seller location, Shopee Mall only) & pagination — prices, sold counts, IDs, URLs.
get_product_detail One product — price & discount, rating, sold count, stock, category, specs, shipping (fee, free-shipping threshold, ETA), seller, description.
get_product_variants Every variant of a listing — model IDs, variant names, per-variant prices and availability. Opt into includeStock for exact counts.
get_product_reviews Rating summary (star breakdown, with-media/comment counts) and pages of buyer reviews — filter by star rating, comments, or media.
get_shop_info A seller’s profile by shop ID or username — badges, rating, products, followers, chat response rate/time, join date, last active.
get_shop_products One shop’s catalogue, with sorting (popular, newest, top sales, price) & pagination.
在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →

配置

{ "mcpServers": { "shopee": { "command": "xvfb-run", "args": ["-a", "shopee-mcp"] } } }