Shopee Affiliate MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SHOPEE_APP_ID | Yes | App ID da Open API de afiliados | |
| MCP_PUBLIC_URL | No | URL pública para o transporte oauth-http atrás de HTTPS | |
| SHOPEE_APP_SECRET | Yes | Secret da mesma aplicação | |
| SHOPEE_HISTORY_DB | No | Opcional: caminho absoluto do SQLite de observações | |
| SHOPEE_VERIFIED_PROFILE | Yes | Caminho absoluto de `examples/profile.official.json` | |
| SHOPEE_ACCOUNT_REFERENCE | Yes | Rótulo local, ASCII alfanumérico/underscore/hífen, até 64 caracteres |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| affiliate_statusA | Mostra modo e referência LOCAL da conta. Não autentica nem comprova titularidade na Shopee. |
| search_offersC | Pesquisa uma página; preço/comissão são observações estimadas. Modo fixture contém somente dados sintéticos. |
| get_offerA | Reconsulta oferta por item_id e shop_id. Retorna nova observação; não garante estoque, frete ou comissão aprovada. |
| generate_affiliate_linkB | Gera link SOMENTE via operação oficial verificada, para a referência de conta esperada e subIDs explícitos. Nunca publica. Fixtures recusam geração. |
| search_shop_offersC | Pesquisa ofertas de lojas, comissão, classificação e orçamento disponível. |
| search_campaign_offersC | Pesquisa campanhas e ofertas Shopee com categoria/coleção e período. |
| list_product_feedsB | Lista catálogos oficiais FULL ou DELTA disponíveis para a conta. |
| get_product_feedC | Obtém uma página do feed oficial; preserva IDs e decimais como strings. |
| get_conversion_reportB | Consulta conversões e comissões ainda não validadas; paginação automática limitada e cursor de uso único/30s. |
| get_validated_reportB | Consulta comissões validadas por validationId do painel de faturamento; não comprova pagamento. |
| summarize_reportC | Agrupa conversões por subID bruto, campanha ou dia UTC; informa quando o total cobre apenas parte do relatório. |
| parse_product_urlC | Extrai IDs de URL Shopee. |
| resolve_product_urlB | Resolve link curto Shopee, validando cada redirecionamento antes de consultar IDs. |
| generate_affiliate_links_batchB | Gera até 20 links oficiais sequencialmente; valida todo o lote antes do envio e interrompe em erro. |
| export_dataA | Retorna CSV ou JSON dos registros fornecidos, sem escrever arquivos; neutraliza fórmulas em CSV. |
| observe_offerC | Registra uma nova observação do produto em SQLite local habilitado pelo administrador. |
| get_offer_historyC | Consulta observações coletadas neste servidor, separadas por conta e modo. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 17 tools
Tools mostly target distinct resources: search_offers/search_shop_offers/search_campaign_offers differ by scope, and get_offer/observe_offer/get_offer_history differ by action. The two generate_affiliate_link variants and the report trio could be momentarily confused, but descriptions clarify their boundaries.
Almost all tools follow a verb_noun snake_case pattern (search_offers, get_offer, generate_affiliate_link, get_conversion_report). The lone deviation is the noun-only affiliate_status, which is a minor inconsistency.
17 tools is slightly heavy but each maps to a real affiliate workflow step (search, offer lookup, link generation, feeds, reports, URL parsing, observation history). Nothing appears redundant enough to trim.
The surface covers the affiliate lifecycle well: discovery (offers/shops/campaigns), link generation, feed access, reporting, and local observation history. Missing update/delete style operations and explicit account auth, but those are out of scope per descriptions.