# Painel do Afiliado

> Affiliate sales analytics across Shopee, AliExpress, Amazon, Mercado Livre and other marketplaces.

- name: io.github.CssEoCAO/painel-do-afiliado
- version: 1.0.0
- connection class: R0 (autonomous)
- trust: 79/100 flags: no-repository
- quality: 91/100 (strong)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.CssEoCAO%2Fpainel-do-afiliado
- tools: https://api.protogrid.dev/v1/servers/io.github.CssEoCAO%2Fpainel-do-afiliado/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "painel-do-afiliado": {
      "type": "http",
      "url": "https://paineldoafiliado.com/mcp"
    }
  }
}
```


## Trust

- hygiene: 80
- liveness: 99
- freshness: 100
- provenance: 45
- drivers: +website +reachable +uptime-98% +updated-10d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 91/100 (strong)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-06-18; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 100 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 20 of 20 tools declare readOnlyHint or destructiveHint
- pass `tools.directory_hints`: every tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
- pass `tools.token_cost`: about 4,803 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 100 (weight 15)

- pass `stability.changes`: 3 tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 20, about 4,803 tokens to load them all
- tool set hash: 74caec25f2a46748349a94ec39f13274
- tools last changed: 2026-10-31T19:40:08.494Z
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.CssEoCAO/painel-do-afiliado.svg)](https://protogrid.dev/servers/io.github.CssEoCAO/painel-do-afiliado)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-10-31 `painel_list_sales` changed (inputSchema)
- 2026-10-31 `painel_get_top_links` changed (inputSchema)
- 2026-10-31 `painel_get_products_by_period` changed (inputSchema)

Full history: https://api.protogrid.dev/v1/servers/io.github.CssEoCAO%2Fpainel-do-afiliado/changes

## Remotes

- https://paineldoafiliado.com/mcp (streamable-http, auth none, reachable true, uptime30d 0.975)

## Packages

_none_

## Tools (20)

- `painel_compare_marketplaces`: Compara os marketplaces lado a lado no período (cliques, pedidos, comissão, GMV, EPC, conversão, ticket médio), do que mais rende para o que menos rende. Use para perguntas tipo "qual loja rende mais?".
- `painel_compare_periods`: Compara o período com outro (default: o período imediatamente anterior, de mesma duração): comissão, vendas, pedidos, cliques, conversão e EPC, com variação absoluta e % no total e por marketplace. Use para "como foi esta semana vs. a passada?" ou "outubro vs. setembro" (informe compare_start_date/compare_end_date).
- `painel_get_advertiser_breakdown`: Vendas das REDES de afiliados (AWIN, CityAds, Rakuten) quebradas por ANUNCIANTE/programa (ex.: "Kabum BR", "Nike BR") no período: pedidos, itens, comissão e GMV por programa.
- `painel_get_cancellations`: Vendas PENDENTES (comissão a receber), NÃO PAGAS da Shopee (unpaid: aguardando pagamento, fora dos totais) e CANCELADAS/não efetivadas (comissão perdida) por marketplace, com taxa de cancelamento e totais. Mercado Livre entra pelo KPI diário de não efetivadas; Amazon não informa status e não entra.
- `painel_get_category_breakdown`: Comissão e vendas (BRL) por CATEGORIA de produto no período, de todos os marketplaces que informam categoria (as demais vão para "Outros").
- `painel_get_channel_breakdown`: Funil por CANAL de divulgação (Telegram, WhatsApp, Instagram, Websites…): cliques, pedidos, conversão, vendas, comissão e EPC por canal. Fonte: relatórios da Shopee (Canal/Referenciador) e origem do Magalu — marketplaces sem essa dimensão não aparecem.
- `painel_get_direct_indirect`: Vendas DIRETAS (produto/loja do próprio link) vs INDIRETAS (outro produto/loja comprado após o clique), quebradas por marketplace em `byMarketplace[]`. Fontes: Amazon (relatório de Categorias, em ITENS; sem comissão separada), Shopee ("Tipo de atribuição": mesma loja vs loja diferente, em produtos, COM comissão separada — directCommissionBrl/indirectCommissionBrl) e Mercado Livre (quantity_direct/quantity_not_direct, em pedidos). Cada item traz direct, indirect e directShare (0–1).
- `painel_get_goals`: Metas de vendas (GMV) do mês corrente que o usuário definiu por marketplace, com o realizado, % atingido, quanto falta e quanto falta por dia até o fim do mês. Na Shopee traz também as faixas do bônus. Lista vazia = nenhuma meta definida (o usuário define em Metas, no painel).
- `painel_get_hourly_breakdown`: Distribuição por HORA do dia (0–23, fuso de Brasília): pedidos, itens e comissão por hora (de todos os pedidos com timestamp) e cliques por hora (quando o relatório de cliques informa hora). Use para recomendar horários de postagem.
- `painel_get_insights`: Insights gerados automaticamente pela IA do painel (anomalias, recomendações, tendências, digests), mais recentes primeiro.
- `painel_get_monthly_growth`: Comissão, vendas, pedidos e cliques por MÊS, com variação % sobre o mês anterior, no total e por marketplace. `firstDate` depois do dia 1 indica mês incompleto (conexão recente ou início do histórico do plano) — não compare um mês incompleto como se fosse cheio.
- `painel_get_products_by_period`: Produtos que venderam no período escolhido, com pedidos, comissão (BRL) e última venda — sem cancelados. Aceita filtro por marketplace, categoria e nome. Cliques/EPC por produto não existem por período arbitrário (para isso use painel_get_top_products).
- `painel_get_sales_summary`: Visão geral do período: cliques, pedidos, itens, comissão (BRL), vendas/GMV (BRL), conversão, EPC e ticket médio — totais e por marketplace (maior comissão primeiro). É o ponto de partida para entender a conta. Conversão/EPC do total consideram só marketplaces com cliques.
- `painel_get_status_breakdown`: Pedidos do período agrupados por status normalizado: pending (a receber), confirmed (concluídos), unpaid ("não pago" da Shopee — aguardando pagamento, FORA dos totais, como no relatório da Shopee) e cancelled (cancelados), com itens, comissão e GMV de cada grupo.
- `painel_get_subid_breakdown`: Vendas agrupadas pelo VALOR BRUTO de um nível de sub_id (Shopee Sub_id1..5 e equivalentes): pedidos, itens, comissão e GMV por valor — os 50 de maior comissão. Use quando o afiliado marca campanha/grupo/post no sub_id e ainda não criou etiquetas. `availableLevels` diz quais níveis têm dado.
- `painel_get_tag_performance`: Desempenho por etiqueta de rastreamento (sub-IDs unificados entre marketplaces, criados pelo usuário no painel) no período: cliques, pedidos, comissão, conversão e EPC por etiqueta. Use para avaliar campanhas/canais rastreados.
- `painel_get_top_links`: Links de afiliado do AliExpress que mais renderam no período (sem cancelados): pedidos, vendas, comissão, compradores distintos e produtos vendidos por link. `coverage` diz quantos pedidos vieram com o link identificado. Só AliExpress (os outros marketplaces não informam o link da venda).
- `painel_get_top_products`: Ranking de produtos nas janelas FIXAS de 7 e 30 dias (não aceita período): comissão, pedidos, cliques, EPC ou conversão. Única fonte de cliques/EPC/conversão POR PRODUTO. Para um período escolhido (ex.: "mês passado"), use painel_get_products_by_period.
- `painel_get_trends`: Série temporal diária de uma métrica (comissão, pedidos, cliques ou vendas) por marketplace no período. Use para detectar tendências, picos e quedas ao longo dos dias.
- `painel_list_sales`: Lista pedidos INDIVIDUAIS no período (paginado, mais recentes primeiro por padrão), com produto, quantidade, venda, comissão, status, referenciador e anunciante. Um pedido com vários itens aparece em várias linhas. Filtros: marketplace, status, busca por nome de produto. Limitação: Amazon e Mercado Livre não têm pedidos individuais (são pré-agregados). Para totais, use painel_get_sales_summary — não some páginas.