使用说明
Shopee代理MCP服务器
一个基于 **模型上下文协议（MCP）**专为充当整合桥梁而设计。 节奏真实 人工智能代理（LLM）和人工智能平台之间 虾皮.
它将联盟API和卖家中心调用封装在一个“工具”界面中，允许代理商与Shopee交谈以搜索产品，按佣金过滤并本地查询类别。
🛠️ LLM的工具（Tools）
将此 MCP 插入您的 Agent 后，以下工具立即可用：
-
search_shopee_products- 描述 ： 直接在 Shopee 目录中搜索产品。
- 支持的过滤器： 关键字（
keyword） 类别 ID （category_id). - 支持的排序方式 ： 相关性， 最畅销 （默认）， 更高的价格， 更低的价格和 最大 委员.
- 返回 ： 详细信息包括图片，价格，销售量，评级和联盟链接。
-
search_shopee_categories- 描述 ： 映射关键字（例如“手机”）并搜索平台的全球官方类别，有助于查找产品搜索所需的确切类别ID。
⚙️ 先决条件和安装
该项目仅通过软件包管理器进行维护 诗歌利用 Architecture 的 FastMCP.
-
安装项目的基本依赖关系 ：
poetry install -
设置您的 Shopee API 凭据： 重命名，复制或创建自己的
.env在包含您访问 Shopee OpenAPI 联盟面板的密钥的项目根中。SHOPEE_APP_ID=seu_app_id SHOPEE_SECRET=sua_secret_aqui
🚀 如何执行
该项目被设计为通过协议上传 **服务器发送事件（SSE）**非常适合远程代理人对代理（A2A）通信。
在本地启动服务器 ：
make dev
（或手动） poetry run python mcp_server.py sse 8002)
系统将在本地端口上绑定 8002为其他应用程序提供工具的 MCP 端点将是：
http://localhost:8002/sse
🔌 使用工具（集成）
这个模块是为了在几十个现代管弦乐手中插入和播放。一些例子：
使用 Google ADK （A2A）
如果您正在运行“库存代理”或“销售代理”，只需在 ADK 的上下文提供程序管理器或工具注册表中注册新创建的 SSE URL 即可。Shopee购物路线的发现将自动嵌入到提示规划器中。
克劳德桌面/光标（通过STDIO）
要使用标准 I/O （stdio） 原生连接到 IDE （Cursor） 或离线客户端： 只需在 MCP JSON 中设置路径，指定此模块通过 poetry 运行：
{
"mcpServers": {
"shopee-mcp": {
"command": "poetry",
"args": ["run", "python", "/caminho/absoluto/do/projeto/mcp_server.py"]
}
}
}
清洁架构 - 无需本地数据库。所有流量都通过官方API实时代理工作。
