mcp-shopee-seller
Servidor MCP para a Shopee Open Platform API v2. Permite que agentes de IA (Claude Code, Codex, Cursor, Antigravity etc.) administrem sua loja Shopee: pedidos, produtos/estoque, logística, finanças, promoções, chat e ads.
Roda 100% no seu computador — os dados da loja trafegam direto entre o seu PC e a Shopee; tokens ficam salvos localmente no seu perfil de usuário.
Tools (42)
| Módulo | Tools |
|---|---|
| Conexão de loja | connect_shop, connect_status, connect_shop_manual, disconnect_shop, list_authorized_shops |
| Pedidos | list_orders, get_order_details |
| Produtos & estoque | list_products, get_product_details, update_stock, update_price |
| Catálogo (criar/editar anúncios) | upload_product_image, search_categories, get_category_requirements, create_product, update_product, set_product_status |
| Relatórios analíticos | get_sales_performance_report, get_unsold_products_report |
| Logística | get_shipping_parameter, ship_order, get_tracking_info, get_logistics_channels |
| Finanças | get_payout_detail, list_wallet_transactions |
| Promoções (vouchers) | list_vouchers, get_voucher, create_voucher, end_voucher |
| Chat (atendimento) | list_conversations, get_messages, send_message |
| Shopee Ads | get_ads_balance, get_ads_shop_info, get_ads_daily_performance, get_recommended_keywords, create_ads_campaign, pause_ads, resume_ads, delete_ads |
| Genérico / diagnóstico | shopee_api_call, shopee_status |
Instalação
Pré-requisito único: uv (curl -LsSf https://astral.sh/uv/install.sh | sh).
Claude Code:
claude mcp add shopee --env MCP_BROKER_URL=... --env MCP_LICENSE_KEY=... -- uvx mcp-shopee-seller
Claude Desktop / Cursor / Antigravity (JSON de MCP servers):
{
"mcpServers": {
"shopee": {
"command": "uvx",
"args": ["mcp-shopee-seller"],
"env": { "MCP_BROKER_URL": "...", "MCP_LICENSE_KEY": "..." }
}
}
}
Codex (~/.codex/config.toml):
[mcp_servers.shopee]
command = "uvx"
args = ["mcp-shopee-seller"]
env = { MCP_BROKER_URL = "...", MCP_LICENSE_KEY = "..." }
Modos de operação
| Modo | Variáveis | Para quem |
|---|---|---|
| broker (padrão) | MCP_BROKER_URL + MCP_LICENSE_KEY |
Usuário final. A assinatura HMAC vem do serviço de licença; somente metadados (path, timestamp, shop_id) são enviados a ele — pedidos, produtos e valores nunca passam pelo broker. |
| local (avançado) | SHOPEE_PARTNER_ID + SHOPEE_PARTNER_KEY |
Quem tem App próprio em open.shopee.com. Tudo 100% local, zero serviços de terceiros. |
Variáveis opcionais: SHOPEE_ENV (live padrão | sandbox), SHOPEE_HOST (host regional),
SHOPEE_SHOP_ID (loja padrão), SHOPEE_AUTH_PORT (porta do callback, padrão 38473),
SHOPEE_TOKEN_FILE, SHOPEE_REDIRECT_URL.
Conectando sua loja (login)
Basta pedir ao agente: "conecte minha loja Shopee".
- A tool
connect_shopabre o navegador na página de autorização da Shopee. - Você entra como vendedor e autoriza (a senha nunca passa pelo MCP).
- O agente chama
connect_statuse a loja fica pronta.
Os tokens ficam em ~/Library/Application Support/marketplace-mcp/shopee/ (macOS),
%APPDATA%\marketplace-mcp\shopee\ (Windows) ou ~/.config/marketplace-mcp/shopee/
(Linux), com renovação automática do access token (4h). Multi-loja: repita
connect_shop para cada conta; use shop_id nas tools para escolher a loja.
Sem navegador (SSH/headless): autorize em outra máquina e cole a URL de redirect na
tool connect_shop_manual (ou use o CLI shopee-authorize).
Desenvolvimento
Este pacote faz parte do monorepo (workspace uv) junto com
marketplace-mcp-core. Na raiz do repositório:
uv sync # cria o venv do workspace
uv run mcp-shopee-seller # roda o servidor (stdio)
uv run shopee-authorize --list # CLI de autorização
Modo local no dev: crie um .env com SHOPEE_PARTNER_ID, SHOPEE_PARTNER_KEY e
SHOPEE_ENV=sandbox, e registre http://127.0.0.1:38473/callback como Redirect URL
no painel do seu App.
Metadata
Release files for mcp-shopee-seller 0.5.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| mcp_shopee_seller-0.5.0.tar.gz | 28.0 kB | Without provenance | Details for mcp_shopee_seller-0.5.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| mcp_shopee_seller-0.5.0-py3-none-any.whl | Python 3 | none | any | Details for mcp_shopee_seller-0.5.0-py3-none-any.whl |
Total release size: 69.2 kB
Release files / mcp_shopee_seller-0.5.0.tar.gz
| Download URL | mcp_shopee_seller-0.5.0.tar.gz |
|---|---|
| Size | 28.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
499e745b397f92d59f9bbe79bc7b69f5289d923c93b4418e09d4eceeb19cdbd2
|
|
BLAKE2b-256 checksum How to use checksums |
a0440249cba2a7a8bd5266d53199e8664126d2b5abdbd63c6b9614d3a9b79346
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.28 {"installer":{"name":"uv","version":"0.11.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / mcp_shopee_seller-0.5.0-py3-none-any.whl
| Download URL | mcp_shopee_seller-0.5.0-py3-none-any.whl |
|---|---|
| Size | 41.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
86e37e038e2686f9ea93bdaf9609fc5f67acfd2c8acefd3fd825fad5931e3f85
|
|
BLAKE2b-256 checksum How to use checksums |
f99ef6b7528573b9a009ab963751211ba98bb0645c43b390bef9b7d5b01ecdd5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.11.28 {"installer":{"name":"uv","version":"0.11.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for mcp-shopee-seller 0.5.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.