Shopee Agentic

You are deploying a lightweight, autonomous MCP server that acts as a real-time integration bridge between AI agents and the Shopee platform. It exposes Shopee Affiliate API and Seller Center interactions as tools, enabling agents to search products, filter by commission, and query categories directly within conversations.

How to use

You will run the MCP server and connect it to an MCP client or orchestrator. The server provides two tools: search_shopee_products to query the Shopee catalog with filters like keyword and category_id and with sorting options including highest commission, and search_shopee_categories to map keywords to official global categories and retrieve exact category IDs for product searches. Use the SSE endpoint for real-time, agent-to-agent communication.

How to install

Prerequisites: Install Python and Poetry. Ensure you can run Python and have Poetry available in your shell.

poetry install

Configure your Shopee API credentials by creating a .env file at the project root with your Shopee OpenAPI credentials.

SHOPEE_APP_ID=your_app_id
 SHOPEE_SECRET=your_secret_here

Additional sections

Start the server locally using the Server-Sent Events (SSE) protocol. The server binds to port 8002 and exposes the MCP endpoint for tools at the SSE URL.

make dev

# or equivalently
poetry run python mcp_server.py sse 8002

Available tools

search_shopee_products

Query the Shopee catalog with filters by keyword and category_id, and sort by relevance, best sellers, price, or commission. Returns detailed product data including images, price, sales volume, rating, and affiliate links.

search_shopee_categories

Resolve keywords to official global categories to obtain exact category IDs for product searches.