API de parceiro de marketplace da LatAm — gigante no BR, crescendo em outros lugares. Pedidos, produtos, devoluções. Combina com o Mercado Libre pra alcance total de marketplace. Alpha no npm — recipe de assinatura via refs de SDK.
O Shopee dá ao seu agente 22 tools que ele chama direto — escolha as que precisar, no Claude, Cursor ou qualquer cliente MCP.
get_shop_info — Get basic information about the authorized Shopee shop (shop_name, region, status, auth expiry).list_orders — List orders within a time window, optionally filtered by order_status. Time window cannot exceed 15 days. Returns order_sn list which can be fed into get_order_detail.get_order_detail — Get full detail for one or more orders by order_sn (comma-separated, up to 50).// Your agent calls a tool directly — no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("get_shop_info", { /* ... */ });$ npm install @codespar/mcp-shopee@alphaAdicione esta entrada ao seu claude_desktop_config.json (ou a config de qualquer cliente compatível com MCP).
{
"mcpServers": {
"shopee": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-shopee@alpha"
],
"env": {
"SHOPEE_PARTNER_ID": "<your_shopee_partner_id>",
"SHOPEE_PARTNER_KEY": "<your_shopee_partner_key>",
"SHOPEE_ACCESS_TOKEN": "<your_shopee_access_token>",
"SHOPEE_SHOP_ID": "<your_shopee_shop_id>"
}
}
}
}Depois de reiniciar, seu agente pode chamar qualquer uma das 22 ferramentas abaixo — teste get_shop_info primeiro.
Necessárias pra autenticar o server. Armazenadas criptografadas ao usar a hospedagem gerenciada da CodeSpar.
SHOPEE_PARTNER_IDShopee Open Platform partner_id (integer) assigned when the app is registered.
SHOPEE_PARTNER_KEYShopee partner_key used as the secret for HMAC-SHA256 request signing.
SHOPEE_ACCESS_TOKENMerchant access_token obtained via the shop authorization OAuth flow (expires every 4 hours; refresh via refresh_token).
SHOPEE_SHOP_IDShop identifier (integer) returned after merchant authorization.
SHOPEE_ENVEnvironment: 'sandbox' uses partner.test-stable.shopeemobile.com, 'production' (default) uses partner.shopeemobile.com.
Cada ferramenta é independente — seu agente carrega só o que precisa pra reduzir contexto e tempo de resposta.
get_shop_infolist_ordersget_order_detailship_ordercancel_orderlist_productsget_product_detailupdate_product_stockMCP é um protocolo — qualquer framework que o fale pode montar este server.