Shopee stock that matches your warehouse

An agent that compares Shopee stock per variation with the warehouse sheet every morning, alerts the team on LINE about low or mismatched items, and stages stock updates for the owner to approve

The problem

A shop that sells on Shopee and from its own stockroom keeps two numbers for every variation: what Shopee thinks is left and what is on the shelf. When they drift apart the shop either oversells and has to cancel orders it cannot fill, or shows sold out on a product that is sitting in the back, and nobody notices until a customer complains.

How the agent works

1. It starts

   At 07:00 the agent calls the shop's Shopee Open Platform account through the open source shopee-sdk: getItemList for the active items, then getModelList per item for every variation's SKU and stock.

2. The agent works

   It joins those rows to the warehouse count the team keeps in a Google Sheet (one row per SKU with the reorder point) and writes a daily tab with Shopee stock, shelf stock and the difference. Three lists go to the team's LINE group through the Messaging API: variations at or below the reorder point, variations where the two counts differ by more than the agreed tolerance, and variations Shopee shows as sold out while the shelf has stock. Claude writes the message in plain Thai with the suggested action per SKU. For mismatches the agent stages an updateStock call per model in an approval tab; the owner ticks the rows to apply and the agent pushes only those, logging the before and after values.

3. The result

   Shopee's own push notifications can later replace the morning poll with near real time checks.

Worked example

The MIT licensed shopee-sdk for Node.js (updated October 2026) documents the calls this agent needs: getItemList with offset, page_size up to 100 and item_status filters; getModelList, which returns the tier variations and a model array with model_sku, price_info and stock_info per variation; updateStock, which takes an item_id and a stock_list of model_id and normal_stock; and a PushManager for Shopee's webhooks. The SDK handles request signing and token refresh and ships with file based token storage. It publishes no shop results, so the first number you will see is how many SKUs disagree on day one; that figure alone usually decides whether the owner wants the approval tab or trusts the agent to sync.

Sources

• https://github.com/congminh1254/shopee-sdk
• https://github.com/congminh1254/shopee-sdk/blob/main/docs/managers/product.md