shopee-mcp
Shopee MCP Connect your AI assistant to Shopee marketplace data via SEA MCP — search shops, listings and the category tree across 8 Shopee markets through the…
What it can do
- Shopee Search Shops: Search Shopee shops. Filters are ANDed. Defaults to most followers. Shops are complete. Some shops have no username. The latest data point is 22 Sep 2026. Use registrationNumber f
- Shopee Get Shop: Fetch one Shopee shop by id, or by country plus username. Shops are complete. Some shops have no username, so a username lookup can miss a shop that exists; use id when you have it. T
- Shopee Search Products: Search Shopee listings. Filters are ANDed. Defaults to most units sold. Prices are in the market currency (IDR, MYR, THB, VND, PHP, SGD, TWD, BRL, MXN, COP, CLP), not converted
What data it sees
Do you need an account
No: the server works without sign-in
Shopee MCP
Connect your AI assistant to Shopee marketplace data via SEA MCP — search shops, listings and the category tree across 8 Shopee markets through the Model Context Protocol.
Markets: Indonesia, Malaysia, Thailand, Vietnam, Philippines, Singapore, Taiwan and Brazil. Prices stay in each market's own currency.
What it's for
- Market research — size up a category or niche in any market: who the biggest sellers are, how many followers and listings they have, and how their ratings compare.
- Competitor analysis — benchmark rival shops on followers, catalogue size, rating, response rate, cancellation rate and how long they've been selling.
- Finding regional stores — list sellers in a specific city, district or province (e.g. every shop in Bandung or Surabaya), or the sellers shipping from a given location.
- Supplier and reseller sourcing — find manufacturers, distributors and wholesalers on Shopee by product, brand or region.
- B2B lead generation — build prospect lists of merchants by region, size and seller tier (Shopee Mall, Preferred+, verified) for logistics, payments, SaaS or agency outreach.
- Company due diligence (KYC / KYB) — link a shop to its legal entity through the registered business number (Indonesian NIB, Thai company registration) and check its address and trading history.
- Brand protection — find unofficial resellers and look-alike shops selling your brand, and compare them against your official store.
- Pricing and discount research — compare listing prices, original prices and discount levels across sellers and markets.
- Product and trend research — spot best-selling products by units sold and monthly sales within a category or brand.
- Cross-border expansion — compare the same category across Southeast Asia, Taiwan and Brazil before entering a new market.
- Academic and economic research — study e-commerce seller distribution and SME activity across the region.
Product listing coverage is still growing, so product-level rankings reflect the listings loaded so far; shop data is the most complete.
Connect
https://seamcp.com/shopee/mcp
Add this URL as a custom MCP connector in Claude, ChatGPT, Cursor, or any MCP-compatible client. Sign in with Google when prompted.
- Transport: Streamable HTTP
- Auth: Google OAuth (sign in once, stays authorized)
- Free tier: 100 tool calls per month
- Docs: seamcp.com/shopee
Tools
| Tool | Description |
|---|---|
Shopee_search_shops |
Search sellers by name, handle, legal registration number (e.g. Indonesian NIB), street, city or province — filter by Mall / Preferred+ / verified status, followers, rating, catalogue size and opening date |
Shopee_get_shop |
Single shop by id or country + username — address, ratings, response and cancellation rates, top listings by units sold |
Shopee_search_products |
Rank listings by units sold, monthly sales, price, rating or discount — filter by brand, category (children included), ship-from location and price range |
Shopee_get_product |
Single listing by item id, with its shop and category |
Shopee_search_categories |
Walk the category tree — roots, children of a node, or search by name |
Shops are complete per market. Listing coverage is still growing, so product totals and sales rankings reflect the listings loaded so far.
Example prompts
- "Top 20 Shopee Mall skincare shops in Malaysia by followers, with their cities"
- "Find every Indonesian shop registered to a given NIB, with addresses"
- "Best-selling air fryers in Thailand under ฿2,000"
- "Compare the biggest Vietnamese phone-case sellers — rating, response rate and when they opened"
Top shops by market
The 100 most-followed shops on each Shopee domain, exported from the SEA MCP database on 2026-09-25. Each market has a Markdown table (logo, shop link, username, registration number, address, followers, items, ratings, response and cancellation rates, Mall / Preferred+ / verified flags, opened and last-active dates — columns with no data for that market are left out) and the raw CSV with every column in top-shops/csv/.
| Market | Table | CSV | Shops | #1 by followers | Followers |
|---|---|---|---|---|---|
| Indonesia | shopee.co.id | csv | 100 | Shopee Official Shop | 11,120,672 |
| Malaysia | shopee.com.my | csv | 100 | ShopeeFood MY | 41,170,271 |
| Thailand | shopee.co.th | csv | 100 | ShopeeFood TH | 100,292,496 |
| Vietnam | shopee.vn | csv | 100 | Shopee VN | 269,648,270 |
| Philippines | shopee.ph | csv | 100 | Shopee Choice Global | 14,374,275 |
| Singapore | shopee.sg | csv | 100 | Shopee Choice Global | 573,217 |
| Taiwan | shopee.tw | csv | 100 | 蝦小編的店(官方) | 42,821,451 |
| Brazil | shopee.com.br | csv | 100 | shopee_br | 281,903,859 |
About 90% of shops in every market have a street address. City, province and postal code are split into their own columns only where Shopee provides them (Indonesia has all three); Brazil and Taiwan keep the full address in the street column. Registration numbers are available for Indonesia and Thailand. For live data, ask the MCP (Shopee_search_shops with sortBy: "followerCount").
How to connect
How to connect shopee-mcp to Claude
The server address to paste into Claude settings:
https://shopee-mcp--seamcp.run.tools
- Open Claude (claude.ai or the desktop app).
- Go to Settings → Connectors.
- Click Add custom connector.
- Paste the server address copied below into Remote MCP server URL and click Add.
- In a chat, click + → Connectors and switch the new connector on.
Custom connectors are available on Free, Pro, Max, Team and Enterprise plans (Free is limited to one). On Team and Enterprise an organization Owner adds the connector first under Organization settings → Connectors.
Authorization
After you click Add, a sign-in window for the service opens. Sign in with your own account and approve access. Claude never sees your password.
How to connect shopee-mcp to ChatGPT
The server address to paste into ChatGPT settings:
https://shopee-mcp--seamcp.run.tools
- Open ChatGPT in a browser (chatgpt.com). A Plus, Pro, Business, Enterprise or Edu plan is required.
- Turn on developer mode once: Settings → Apps → Advanced settings → Developer mode.
- Open Settings → Connectors and click Create.
- Fill in the form: Name (anything), Description (one line about what the service does), MCP server URL (copy it below).
- Under Authentication choose OAuth if the service requires sign-in, otherwise None. Click Create.
- In a new chat open + → Apps/Connectors and enable the connector.
OpenAI has renamed this section before (Connectors → Apps/Plugins). If the label differs, search settings for "developer mode". On Business/Enterprise workspaces an admin must allow custom connectors first.
Authorization
On first use ChatGPT opens the service's sign-in window. Sign in and approve access.
How to connect shopee-mcp to Cursor
The server address to paste into Cursor settings:
https://shopee-mcp--seamcp.run.tools
Fastest: click Open in Cursor below and confirm the prompt.
Manually:
- In Cursor open Settings → Cursor Settings → MCP and click Add new global MCP server.
- Paste the JSON copied below into
~/.cursor/mcp.json(per project:.cursor/mcp.jsonin the repo root). - Save the file. The server appears in the MCP list; authorize it there if asked.
Authorization
If the service needs sign-in, an authorize button appears next to the server in the MCP list.
Server tool list (5)
Raw names from tools/list. Only developers need these.
| Shopee_search_shops | Search Shopee shops. Filters are ANDed. Defaults to most followers. Shops are complete. Some shops have no username. The latest data point is 22 Sep 2026. Use registrationNumber for a legal id (Indonesia NIB, Thailand company registration). Use username for an exact handle. Street, city, and district are substrings. City is stored with a prefix such as "KOTA JAKARTA UTARA" or "KAB. TANGERANG"; province for Indonesia is uppercase, e.g. "DKI JAKARTA". followerCount and ratingStar are indexed — set minFollowers or minRating when scanning a market. sortBy is any ShopeeShop column. Returns { data, total, page, limit }. Each row includes a Shopee url. |
| Shopee_get_shop | Fetch one Shopee shop by id, or by country plus username. Shops are complete. Some shops have no username, so a username lookup can miss a shop that exists; use id when you have it. The latest data point is 22 Sep 2026. Includes address, ratings, and the top stored products by units sold. Product coverage is not complete yet: embedded products are only the listings we have loaded, not the shop's full catalog. itemCount is the shop's total listing count on Shopee. Returns { data: null } when missing. |
| Shopee_search_products | Search Shopee listings. Filters are ANDed. Defaults to most units sold. Prices are in the market currency (IDR, MYR, THB, VND, PHP, SGD, TWD, BRL, MXN, COP, CLP), not converted. Product coverage is not complete yet. Totals and soldCount rankings only cover stored listings, not the full Shopee catalog. A shop with no matches may still sell the item. Pass shopId when you already have a shop. category matches a category name and includes its child categories. price and soldCount are indexed. Returns { data, total, page, limit }. When category is set, matchedCategories lists the named matches (children are searched but not all listed). |
| Shopee_get_product | Fetch one Shopee product by item id, with its shop and category. Price is in the market currency. Product coverage is not complete yet, so { data: null } means the listing is missing or not loaded. |
| Shopee_search_categories | Search the Shopee category tree. Filters are ANDed. Use parentId to list children of a category, or rootsOnly for top-level categories. Returns { data, total, page, limit }. |