Meta Ads tracking for Shopee affiliates: campaigns, sales, commissions, ROAS and CAPI status.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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.
ID externo do anúncio (ad) Meta.
Novos url_tags (query string de macros).
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.
The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.
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.
| Argument | Type | Description |
|---|---|---|
| ad_id* | string | ID externo do anúncio (ad) Meta. |
| dry_run | boolean | 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. |
| url_tags* | string | Novos url_tags (query string de macros). |
{
"type": "object",
"required": [
"ad_id",
"url_tags"
],
"properties": {
"ad_id": {
"type": "string",
"description": "ID externo do anúncio (ad) 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."
},
"url_tags": {
"type": "string",
"description": "Novos url_tags (query string de macros)."
}
},
"additionalProperties": false
}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).
| Argument | Type | Description |
|---|---|---|
| campaign_id* | string | ID externo da campanha Meta (TEXT). |
{
"type": "object",
"required": [
"campaign_id"
],
"properties": {
"campaign_id": {
"type": "string",
"description": "ID externo da campanha Meta (TEXT)."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| limit | number | Máximo de campanhas (1–100, default 50). |
| offset | number | Deslocamento para paginação (default 0). |
| status | string | Filtro de status (default all). |
{
"type": "object",
"properties": {
"limit": {
"type": "number",
"description": "Máximo de campanhas (1–100, default 50)."
},
"offset": {
"type": "number",
"description": "Deslocamento para paginação (default 0)."
},
"status": {
"enum": [
"active",
"paused",
"all"
],
"type": "string",
"description": "Filtro de status (default all)."
}
},
"additionalProperties": false
}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).
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}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).
| Argument | Type | Description |
|---|---|---|
| days | number | Janela em dias se start/end ausentes (1–366, default 30). |
| end_date | string | Fim (yyyy-mm-dd, UTC). Opcional (default hoje). |
| start_date | string | Início (yyyy-mm-dd, UTC). Opcional. |
{
"type": "object",
"properties": {
"days": {
"type": "number",
"description": "Janela em dias se start/end ausentes (1–366, default 30)."
},
"end_date": {
"type": "string",
"description": "Fim (yyyy-mm-dd, UTC). Opcional (default hoje)."
},
"start_date": {
"type": "string",
"description": "Início (yyyy-mm-dd, UTC). Opcional."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| days | number | Janela em dias se start/end ausentes (1–366, default 30). |
| limit | number | Máximo de conversões (1–200, default 50). |
| offset | number | Deslocamento para paginação (default 0). |
| end_date | string | Fim (yyyy-mm-dd, UTC). Opcional (default hoje). |
| start_date | string | Início (yyyy-mm-dd, UTC). Opcional. |
{
"type": "object",
"properties": {
"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)."
},
"end_date": {
"type": "string",
"description": "Fim (yyyy-mm-dd, UTC). Opcional (default hoje)."
},
"start_date": {
"type": "string",
"description": "Início (yyyy-mm-dd, UTC). Opcional."
}
},
"additionalProperties": false
}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).
| Argument | Type | Description |
|---|---|---|
| days | number | Janela em dias se start/end ausentes (1–366, default 30). |
| metric | string | Métrica da série (default commission). |
| end_date | string | Fim (yyyy-mm-dd, UTC). Opcional (default hoje). |
| start_date | string | Início (yyyy-mm-dd, UTC). Opcional. |
{
"type": "object",
"properties": {
"days": {
"type": "number",
"description": "Janela em dias se start/end ausentes (1–366, default 30)."
},
"metric": {
"enum": [
"commission",
"orders",
"clicks",
"spend"
],
"type": "string",
"description": "Métrica da série (default commission)."
},
"end_date": {
"type": "string",
"description": "Fim (yyyy-mm-dd, UTC). Opcional (default hoje)."
},
"start_date": {
"type": "string",
"description": "Início (yyyy-mm-dd, UTC). Opcional."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| days | number | Janela em dias se start/end ausentes (1–366, default 30). |
| end_date | string | Fim (yyyy-mm-dd, UTC). Opcional (default hoje). |
| start_date | string | Início (yyyy-mm-dd, UTC). Opcional. |
{
"type": "object",
"properties": {
"days": {
"type": "number",
"description": "Janela em dias se start/end ausentes (1–366, default 30)."
},
"end_date": {
"type": "string",
"description": "Fim (yyyy-mm-dd, UTC). Opcional (default hoje)."
},
"start_date": {
"type": "string",
"description": "Início (yyyy-mm-dd, UTC). Opcional."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| limit | number | Máximo de links (1–100, default 50). |
| offset | number | Deslocamento para paginação (default 0). |
| status | string | Filtro de status (default all). |
| campaign_id | string | Filtra os links de uma campanha (metaCampaignId, modo estático). Opcional. |
{
"type": "object",
"properties": {
"limit": {
"type": "number",
"description": "Máximo de links (1–100, default 50)."
},
"offset": {
"type": "number",
"description": "Deslocamento para paginação (default 0)."
},
"status": {
"enum": [
"active",
"all"
],
"type": "string",
"description": "Filtro de status (default all)."
},
"campaign_id": {
"type": "string",
"description": "Filtra os links de uma campanha (metaCampaignId, modo estático). Opcional."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| days | number | Janela em dias se start/end ausentes (1–366, default 30). |
| end_date | string | Fim (yyyy-mm-dd, UTC). Opcional (default hoje). |
| start_date | string | Início (yyyy-mm-dd, UTC). Opcional. |
{
"type": "object",
"properties": {
"days": {
"type": "number",
"description": "Janela em dias se start/end ausentes (1–366, default 30)."
},
"end_date": {
"type": "string",
"description": "Fim (yyyy-mm-dd, UTC). Opcional (default hoje)."
},
"start_date": {
"type": "string",
"description": "Início (yyyy-mm-dd, UTC). Opcional."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| days | number | Janela em dias se start/end ausentes (1–366, default 30). |
| level | string | Nível de agregação (default campaign). |
| end_date | string | Fim (yyyy-mm-dd, UTC). Opcional (default hoje). |
| start_date | string | Início (yyyy-mm-dd, UTC). Opcional. |
{
"type": "object",
"properties": {
"days": {
"type": "number",
"description": "Janela em dias se start/end ausentes (1–366, default 30)."
},
"level": {
"enum": [
"campaign",
"adset",
"ad"
],
"type": "string",
"description": "Nível de agregação (default campaign)."
},
"end_date": {
"type": "string",
"description": "Fim (yyyy-mm-dd, UTC). Opcional (default hoje)."
},
"start_date": {
"type": "string",
"description": "Início (yyyy-mm-dd, UTC). Opcional."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| days | number | Janela em dias se start/end ausentes (1–366, default 30). |
| limit | number | Máximo de vendas (1–200, default 50). |
| offset | number | Deslocamento para paginação (default 0). |
| end_date | string | Fim (yyyy-mm-dd, UTC). Opcional (default hoje). |
| start_date | string | Início (yyyy-mm-dd, UTC). Opcional. |
{
"type": "object",
"properties": {
"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)."
},
"end_date": {
"type": "string",
"description": "Fim (yyyy-mm-dd, UTC). Opcional (default hoje)."
},
"start_date": {
"type": "string",
"description": "Início (yyyy-mm-dd, UTC). Opcional."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| dry_run | boolean | 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. |
| campaign_id* | string | ID externo da campanha Meta. |
{
"type": "object",
"required": [
"campaign_id"
],
"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."
},
"campaign_id": {
"type": "string",
"description": "ID externo da campanha Meta."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| dry_run | boolean | 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. |
{
"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
}Reativa uma campanha Meta (status ACTIVE). DRY-RUN por padrão; executa só com dry_run:false. Requer plano Pro para executar.
| Argument | Type | Description |
|---|---|---|
| dry_run | boolean | 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. |
| campaign_id* | string | ID externo da campanha Meta. |
{
"type": "object",
"required": [
"campaign_id"
],
"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."
},
"campaign_id": {
"type": "string",
"description": "ID externo da campanha Meta."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| event_name | string | Evento a simular (default Purchase). |
| value_cents | number | Valor (comissão) em CENTAVOS de BRL. Opcional. |
| test_event_code* | string | Código de teste do Gerenciador de Eventos (TESTxxxxx). |
{
"type": "object",
"required": [
"test_event_code"
],
"properties": {
"event_name": {
"enum": [
"Purchase",
"Refund"
],
"type": "string",
"description": "Evento a simular (default Purchase)."
},
"value_cents": {
"type": "number",
"description": "Valor (comissão) em CENTAVOS de BRL. Opcional."
},
"test_event_code": {
"type": "string",
"description": "Código de teste do Gerenciador de Eventos (TESTxxxxx)."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| dry_run | boolean | 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. |
| adset_id | string | ID do adset (use este OU campaign_id). |
| campaign_id | string | ID da campanha (use este OU adset_id). |
| amount_cents* | number | Novo orçamento diário em CENTAVOS de BRL (> 0). |
{
"type": "object",
"required": [
"amount_cents"
],
"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."
},
"adset_id": {
"type": "string",
"description": "ID do adset (use este OU campaign_id)."
},
"campaign_id": {
"type": "string",
"description": "ID da campanha (use este OU adset_id)."
},
"amount_cents": {
"type": "number",
"description": "Novo orçamento diário em CENTAVOS de BRL (> 0)."
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| dry_run | boolean | 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. |
{
"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
}