# Youzan MCP for AI Agents AI Agent Connect

> Youzan MCP lets you manage your Chinese e-commerce store through your AI client. It handles everything from tracking live orders and monitoring stock levels to pulling sales reports and managing customer profiles. Instead of digging through the Youzan backend, you just ask your agent to do the heavy lifting. It's the fastest way to keep your retail operations moving without switching tabs.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/undefined/ai-agent-connect
- **Tags:** retail-saas, omnichannel-commerce, product-management, order-tracking, customer-profiles, sales-analytics

## Description

Managing a retail business on a platform as big as Youzan usually means jumping between dozens of tabs and menus. You're constantly checking if a specific SKU is out of stock, hunting for a customer's purchase history, or trying to make sense of yesterday's sales numbers. This Connector changes that by giving your AI agent a direct line into your store's data. You can just ask your agent to pull a list of orders from this morning or find a specific customer's contact info without ever logging into the backend. It's a huge shift in how you handle the day-to-day grind of e-commerce. Since Vinkius hosts this, you can plug it into your existing workflow and let your agent handle the repetitive data fetching. Whether you're updating product categories or checking high-level sales performance, you're staying in your workspace while the agent handles the heavy lifting in the background. You get your answers in plain English, which means you spend less time on data entry and more time growing your business.

## Tools

### get_customer
Pull up the full details for a specific customer. Use this to see contact info and history.

### get_inventory
Check the stock levels for any specific SKU. This keeps you from overselling items.

### get_item
Get the full details for a single product. Use this when you need to know specific item specs.

### get_order
Retrieve the details for a specific order. This helps you track a single shipment or transaction.

### get_sales_stats
Get a summary of your sales performance. It's great for checking how your shop is doing at a glance.

### get_shop
Fetch the basic information about your store. Use this to quickly verify shop details.

### list_categories
See all the item categories in your shop. This helps you understand how your products are organized.

### list_customers
Search through your SCRM customer base. Use this to find specific people in your database.

### list_items
Get a list of all products currently on sale. This is your go-to for seeing your active inventory.

### list_orders
See all the trades that have been sold. It's perfect for tracking daily fulfillment.

## Prompt Examples

**Prompt:** 
```
Show me the top 5 products we sold today.
```

**Response:** 
```
I've pulled your sales data for today. Here are the top 5 performers:

| Product Name | Quantity Sold | Revenue |
| :--- | :--- | :--- |
| **Spring Collection T-Shirt** | 45 | ¥1,350 |
| **Organic Tea Set** | 32 | ¥960 |
| **Wireless Headphones** | 20 | ¥2,000 |
| **Designer Watch** | 12 | ¥4,800 |
| **Canvas Tote Bag** | 10 | ¥400 |

Would you like me to check the stock levels for any of these?
```

**Prompt:** 
```
Is the 'Blue Hoodie' still in stock?
```

**Response:** 
```
I've checked the inventory for the Blue Hoodie. You currently have **12 units** remaining in stock. 

Would you like me to list the other sizes available or check the sales stats for this item?
```

**Prompt:** 
```
Find the order for customer 'John Doe'.
```

**Response:** 
```
I've located the profile for **John Doe**. 

**Recent Order Details:**
* **Order ID:** #98765
* **Status:** Out for Delivery
* **Items:** 1x Sneakers, 1x Socks
* **Total:** ¥450

Do you need the tracking number or the customer's contact details?
```

## Capabilities

### Pull sales performance reports
Get a summary of your sales performance to see how your shop is doing.

### Fetch shop-level information
Retrieve the basic details and configuration of your store.

### List all store categories
See how your products are organized into different categories.

### Search and find customer profiles
Locate specific customers within your SCRM database.

### List all products currently on sale
View every item that is currently live and available for purchase.

### Track sold trades and orders
Monitor your sold trades and track order fulfillment status.

### Get specific customer contact details
Pull up specific contact information and purchase history for a customer.

### Check SKU inventory levels
Check the exact stock count for any specific item in your shop.

### Retrieve detailed product information
Get full details for a single product, including specs and descriptions.

### Pull specific order details
Retrieve the full transaction details for a single order.

## Use Cases

### Checking stock before a sale
An owner asks for SKU 123 stock levels and gets an immediate count using get_inventory.

### Handling a customer complaint
A rep asks for a customer's history to see what they bought last month using list_customers and get_customer.

### Daily sales review
A manager asks for the sales stats from the last 24 hours to see top performers using get_sales_stats.

### New product audit
A manager asks for a list of all categories to see if a new line is correctly listed using list_categories.

## Benefits

- Stop digging through the Youzan backend to find order details. Use get_order to pull specific transaction info instantly.
- Keep your stock levels accurate without manual checks. Use get_inventory to see real-time SKU counts.
- Get a clear picture of your revenue. Use get_sales_stats to see how your shop is performing.
- Find customer info in seconds. Use list_customers and get_customer to grab history without searching.
- Organize your product catalog easily. Use list_categories and list_items to see what's live on your site.

## How It Works

The bottom line is you get a conversational interface for your entire retail backend.

1. Subscribe to the Youzan MCP on Vinkius.
2. Enter your Youzan Client ID, Client Secret, and Shop ID (kdt_id) in your client settings.
3. Ask your agent to check inventory, pull orders, or summarize sales.

## Frequently Asked Questions

**Does the Youzan MCP work with my existing store?**
Yes, it connects to your current Youzan account. You can keep your current setup and just add the AI connection.

**Can I use the Youzan MCP to check stock levels?**
Yes, you can check specific SKU counts instantly. This helps you avoid overselling items during busy sales.

**How do I get my sales stats using the Youzan MCP?**
Just ask your agent for a sales summary. It will pull the latest data and give you a quick overview of your performance.

**Can the Youzan MCP find specific customer profiles?**
Yes, it can search and retrieve details for your customers. This makes it much faster to find contact info or purchase history.

**Is the Youzan MCP good for high-volume retail?**
Yes, it's built for managing large-scale operations. It handles the data fetching so you can focus on managing the business.

**How do I find my Youzan Client ID and Secret?**
Log in to the [Youzan Cloud Console](https://console.youzanyun.com/), create an application, and you will find your Client ID (App Key) and Client Secret in the app settings.

**Where is my Shop ID (kdt_id)?**
Your Shop ID (kdt_id) can be found in the bottom left corner of your Youzan store administration backend.

**Can I check stock levels for specific product variants?**
Yes. Use the `get_inventory` tool with the product's item ID. It will return a list of all SKUs (variants) along with their current stock levels and pricing.