MCP MeasureMCP Measure

índice observado

Pixel do Afiliado

Meta Ads tracking for Shopee affiliates: campaigns, sales, commissions, ROAS and CAPI status.

¿Debería usar esto?

Calidad y seguridad

A
Calidad de la descripción
89%
Integridad del esquema
90%
Calidad de los nombres
80%
Riesgo de envenenamiento
100%
Coincidencia de permisos
100%
Cumplimiento del protocolo
100%

Hallazgos (3)

  • LOWTool 'pixel_get_commissions' description lacks action verben pixel_get_commissions
  • LOWTool 'pixel_get_capi_status' description lacks action verben pixel_get_capi_status
  • LOWTool 'pixel_get_daily_trends' description lacks action verben pixel_get_daily_trends

Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.

Costo de contexto

~3,445Tokens (definiciones de herramientas)
~1.1 KBTamaño de respuesta típico
Impacto significativo en la atención (2.69% del contexto de 128k)

Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.

Instalar

Instalación con un clic

Agrega esto a tu archivo `claude_desktop_config.json`:

{
  "mcpServers": {
    "pixel-do-afiliado": {
      "url": "https://app.pixeldoafiliado.com/mcp"
    }
  }
}

Puntos de conexión remotos

https://app.pixeldoafiliado.com/mcpstreamable-http

Qué puede hacer

Inventario de herramientas

Herramientas (18)

🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢pixel_get_dashboard_summary(start_date, end_date, days)

Visão geral da conta no período: investimento (spend Meta), cliques rastreados, vendas Shopee, comissão, ROAS, EPC e taxa de conversão. Valores monetários em centavos de BRL.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string",
      "description": "Início (yyyy-mm-dd, UTC). Opcional."
    },
    "end_date": {
      "type": "string",
      "description": "Fim (yyyy-mm-dd, UTC). Opcional (default hoje)."
    },
    "days": {
      "type": "number",
      "description": "Janela em dias se start/end ausentes (1–366, default 30)."
    }
  },
  "additionalProperties": false
}
🟢pixel_get_campaigns(status, limit, offset)

Lista as campanhas Meta espelhadas no cache da conta (id externo, nome, status efetivo, objetivo e orçamento diário em centavos). Paginação: total/count/offset/has_more/next_offset.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "active",
        "paused",
        "all"
      ],
      "description": "Filtro de status (default all)."
    },
    "limit": {
      "type": "number",
      "description": "Máximo de campanhas (1–100, default 50)."
    },
    "offset": {
      "type": "number",
      "description": "Deslocamento para paginação (default 0)."
    }
  },
  "additionalProperties": false
}
🟢pixel_get_campaign_status(campaign_id)

Detalha UMA campanha Meta a partir do cache: status efetivo, objetivo e orçamento diário (centavos de BRL). Informe o ID externo da campanha (descubra com pixel_get_campaigns).

Esquema de entrada

{
  "type": "object",
  "properties": {
    "campaign_id": {
      "type": "string",
      "description": "ID externo da campanha Meta (TEXT)."
    }
  },
  "required": [
    "campaign_id"
  ],
  "additionalProperties": false
}
🟢pixel_get_links(status, campaign_id, limit, offset)

Lista os links rastreados da conta com o PRODUTO detectado de cada um. Por link: apelido (label), URL (https://…/r/{slug}), modo (edge=rastreado | static=estático), campanha/adset/ad associados, cliques (total + último) e o produto da Shopee (nome, imagem, preço em centavos, comissão em basis points, disponibilidade e quando foi checado). Filtros por status e campanha; paginação total/count/offset/has_more/next_offset.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "active",
        "all"
      ],
      "description": "Filtro de status (default all)."
    },
    "campaign_id": {
      "type": "string",
      "description": "Filtra os links de uma campanha (metaCampaignId, modo estático). Opcional."
    },
    "limit": {
      "type": "number",
      "description": "Máximo de links (1–100, default 50)."
    },
    "offset": {
      "type": "number",
      "description": "Deslocamento para paginação (default 0)."
    }
  },
  "additionalProperties": false
}
🟢pixel_get_shopee_sales(start_date, end_date, days, limit, offset)

Lista TODAS as vendas Shopee rastreadas do período (grão = item da conversão), inclusive as sem clique casado. Mostra status, GMV e comissão (centavos) e a atribuição (campaign/adset/ad) quando disponível. Paginação: total/count/offset/has_more/next_offset.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string",
      "description": "Início (yyyy-mm-dd, UTC). Opcional."
    },
    "end_date": {
      "type": "string",
      "description": "Fim (yyyy-mm-dd, UTC). Opcional (default hoje)."
    },
    "days": {
      "type": "number",
      "description": "Janela em dias se start/end ausentes (1–366, default 30)."
    },
    "limit": {
      "type": "number",
      "description": "Máximo de vendas (1–200, default 50)."
    },
    "offset": {
      "type": "number",
      "description": "Deslocamento para paginação (default 0)."
    }
  },
  "additionalProperties": false
}
🟢pixel_get_products_sold(start_date, end_date, days)

Lista os produtos vendidos no período (por productId): itens, pedidos, comissão e GMV em centavos. Útil para descobrir os itens que mais geram comissão a partir do tráfego pago.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string",
      "description": "Início (yyyy-mm-dd, UTC). Opcional."
    },
    "end_date": {
      "type": "string",
      "description": "Fim (yyyy-mm-dd, UTC). Opcional (default hoje)."
    },
    "days": {
      "type": "number",
      "description": "Janela em dias se start/end ausentes (1–366, default 30)."
    }
  },
  "additionalProperties": false
}
🟢pixel_get_commissions(start_date, end_date, days)

Comissão (centavos de BRL) no período quebrada por campanha Meta, com pedidos, itens, GMV, spend e ROAS (basis points). netCommission == totalCommission (afiliado direto).

Esquema de entrada

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string",
      "description": "Início (yyyy-mm-dd, UTC). Opcional."
    },
    "end_date": {
      "type": "string",
      "description": "Fim (yyyy-mm-dd, UTC). Opcional (default hoje)."
    },
    "days": {
      "type": "number",
      "description": "Janela em dias se start/end ausentes (1–366, default 30)."
    }
  },
  "additionalProperties": false
}
🟢pixel_get_conversions(start_date, end_date, days, limit, offset)

Lista SÓ as conversões com clique CASADO (atribuição completa: clique → venda), com campanha/adset/ad herdados do clique e o status de envio ao CAPI. Para a lista completa de vendas (inclusive sem clique), use pixel_get_shopee_sales. Paginação: total/count/offset/has_more.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "start_date": {
      "type": "string",
      "description": "Início (yyyy-mm-dd, UTC). Opcional."
    },
    "end_date": {
      "type": "string",
      "description": "Fim (yyyy-mm-dd, UTC). Opcional (default hoje)."
    },
    "days": {
      "type": "number",
      "description": "Janela em dias se start/end ausentes (1–366, default 30)."
    },
    "limit": {
      "type": "number",
      "description": "Máximo de conversões (1–200, default 50)."
    },
    "offset": {
      "type": "number",
      "description": "Deslocamento para paginação (default 0)."
    }
  },
  "additionalProperties": false
}
🟢pixel_get_capi_status

Estado do envio de eventos ao Meta CAPI: contagem por status de entrega (sent/pending/failed) e os eventos mais recentes (event_id = conversionId garante dedup no Meta).

Esquema de entrada

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
🟢pixel_get_daily_trends(metric, start_date, end_date, days)

Série temporal diária de uma métrica no período (para detectar tendências/anomalias). Métricas: commission, orders, clicks, spend (valores em centavos quando monetários).

Esquema de entrada

{
  "type": "object",
  "properties": {
    "metric": {
      "type": "string",
      "enum": [
        "commission",
        "orders",
        "clicks",
        "spend"
      ],
      "description": "Métrica da série (default commission)."
    },
    "start_date": {
      "type": "string",
      "description": "Início (yyyy-mm-dd, UTC). Opcional."
    },
    "end_date": {
      "type": "string",
      "description": "Fim (yyyy-mm-dd, UTC). Opcional (default hoje)."
    },
    "days": {
      "type": "number",
      "description": "Janela em dias se start/end ausentes (1–366, default 30)."
    }
  },
  "additionalProperties": false
}
🟢pixel_get_roas(level, start_date, end_date, days)

Calcula o ROAS (comissão ÷ spend Meta) no período, por nível (campaign/adset/ad). Inclui spend, comissão, GMV (centavos), pedidos, cliques e derivadas em basis points. Base para escalar/pausar.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "level": {
      "type": "string",
      "enum": [
        "campaign",
        "adset",
        "ad"
      ],
      "description": "Nível de agregação (default campaign)."
    },
    "start_date": {
      "type": "string",
      "description": "Início (yyyy-mm-dd, UTC). Opcional."
    },
    "end_date": {
      "type": "string",
      "description": "Fim (yyyy-mm-dd, UTC). Opcional (default hoje)."
    },
    "days": {
      "type": "number",
      "description": "Janela em dias se start/end ausentes (1–366, default 30)."
    }
  },
  "additionalProperties": false
}
🔴pixel_pause_campaign(campaign_id, dry_run)

Pausa uma campanha Meta (status PAUSED). DRY-RUN com dry_run:true (mostra o efeito sem aplicar); executa somente quando dry_run for false. Requer plano Pro para executar.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "campaign_id": {
      "type": "string",
      "description": "ID externo da campanha Meta."
    },
    "dry_run": {
      "type": "boolean",
      "default": true,
      "description": "true ou ausente = DRY-RUN: descreve o efeito sem aplicar. false = EXECUTA a ação de fato. Só envie false após o usuário confirmar."
    }
  },
  "required": [
    "campaign_id"
  ],
  "additionalProperties": false
}
🔴pixel_resume_campaign(campaign_id, dry_run)

Reativa uma campanha Meta (status ACTIVE). DRY-RUN por padrão; executa só com dry_run:false. Requer plano Pro para executar.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "campaign_id": {
      "type": "string",
      "description": "ID externo da campanha Meta."
    },
    "dry_run": {
      "type": "boolean",
      "default": true,
      "description": "true ou ausente = DRY-RUN: descreve o efeito sem aplicar. false = EXECUTA a ação de fato. Só envie false após o usuário confirmar."
    }
  },
  "required": [
    "campaign_id"
  ],
  "additionalProperties": false
}
🔴pixel_set_budget(campaign_id, adset_id, amount_cents, dry_run)

Altera o orçamento DIÁRIO de uma campanha (CBO) ou adset Meta. Valor em CENTAVOS de BRL (integer > 0). DRY-RUN por padrão; executa só com dry_run:false. Requer plano Pro.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "campaign_id": {
      "type": "string",
      "description": "ID da campanha (use este OU adset_id)."
    },
    "adset_id": {
      "type": "string",
      "description": "ID do adset (use este OU campaign_id)."
    },
    "amount_cents": {
      "type": "number",
      "description": "Novo orçamento diário em CENTAVOS de BRL (> 0)."
    },
    "dry_run": {
      "type": "boolean",
      "default": true,
      "description": "true ou ausente = DRY-RUN: descreve o efeito sem aplicar. false = EXECUTA a ação de fato. Só envie false após o usuário confirmar."
    }
  },
  "required": [
    "amount_cents"
  ],
  "additionalProperties": false
}
🔴pixel_edit_campaign_url(ad_id, url_tags, dry_run)

Atualiza os url_tags de um anúncio (ad) Meta — por exemplo para colocar os parâmetros do link rastreado. NÃO gera o link (isso é só no painel): recebe os url_tags prontos. DRY-RUN com dry_run:true. Requer plano Pro.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "ad_id": {
      "type": "string",
      "description": "ID externo do anúncio (ad) Meta."
    },
    "url_tags": {
      "type": "string",
      "description": "Novos url_tags (query string de macros)."
    },
    "dry_run": {
      "type": "boolean",
      "default": true,
      "description": "true ou ausente = DRY-RUN: descreve o efeito sem aplicar. false = EXECUTA a ação de fato. Só envie false após o usuário confirmar."
    }
  },
  "required": [
    "ad_id",
    "url_tags"
  ],
  "additionalProperties": false
}
🟢pixel_trigger_sync(dry_run)

Enfileira o pipeline de sincronização (pull Shopee → match → produto → insights Meta → push CAPI → agregação), o mesmo do "Sincronizar agora" do painel. ASSÍNCRONO: responde imediatamente e a cadeia roda em ~1–2 min; consulte pixel_get_dashboard_summary depois. Liberado a partir do plano Starter.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "dry_run": {
      "type": "boolean",
      "default": true,
      "description": "true ou ausente = DRY-RUN: descreve o efeito sem aplicar. false = EXECUTA a ação de fato. Só envie false após o usuário confirmar."
    }
  },
  "additionalProperties": false
}
🔴pixel_push_capi(dry_run)

Enfileira (ou reenfileira) os eventos Purchase/Refund elegíveis ao Meta CAPI da org. O dedup por event_id=conversionId garante idempotência (reenvio não duplica). DRY-RUN com dry_run:true. Requer plano Pro.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "dry_run": {
      "type": "boolean",
      "default": true,
      "description": "true ou ausente = DRY-RUN: descreve o efeito sem aplicar. false = EXECUTA a ação de fato. Só envie false após o usuário confirmar."
    }
  },
  "additionalProperties": false
}
🟡pixel_send_test_event(test_event_code, event_name, value_cents)

Dispara um evento de teste ao Meta CAPI usando test_event_code (aparece em Test Events do Gerenciador de Eventos; NÃO afeta produção/otimização). Útil para validar a integração do Pixel/CAPI.

Esquema de entrada

{
  "type": "object",
  "properties": {
    "test_event_code": {
      "type": "string",
      "description": "Código de teste do Gerenciador de Eventos (TESTxxxxx)."
    },
    "event_name": {
      "type": "string",
      "enum": [
        "Purchase",
        "Refund"
      ],
      "description": "Evento a simular (default Purchase)."
    },
    "value_cents": {
      "type": "number",
      "description": "Valor (comissão) em CENTAVOS de BRL. Opcional."
    }
  },
  "required": [
    "test_event_code"
  ],
  "additionalProperties": false
}

Comunidad

Califica este servidor

Evidencia

Observaciones recientes

verificadoversión no registrada18 herramientas