MCP MeasureMCP Measure

インデックス観測済み

Pixel do Afiliado

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

使うべきか

品質と安全性

A
説明の品質
89%
スキーマの完全性
90%
命名の品質
80%
ポイズニングのリスク
100%
権限の一致
100%
プロトコルへの準拠
100%

検出事項（3）

  • LOWTool 'pixel_get_commissions' description lacks action verbpixel_get_commissions 内
  • LOWTool 'pixel_get_capi_status' description lacks action verbpixel_get_capi_status 内
  • LOWTool 'pixel_get_daily_trends' description lacks action verbpixel_get_daily_trends 内

ツール定義とプロトコルへの準拠に関する自動分析に基づいています。

コンテキストコスト

~3,445トークン数（ツール定義）
~1.1 KB一般的なレスポンスサイズ
注意への影響は大きい（128k コンテキストの 2.69%）

これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。

インストール

ワンクリックインストール

これを `claude_desktop_config.json` ファイルに追加してください:

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

リモートエンドポイント

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

できること

ツール一覧

ツール（18）

🟢 読み取り専用🟡 書き込み🔴 削除⚪ 不明
🟢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.

入力スキーマ

{
  "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.

入力スキーマ

{
  "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).

入力スキーマ

{
  "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.

入力スキーマ

{
  "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.

入力スキーマ

{
  "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.

入力スキーマ

{
  "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).

入力スキーマ

{
  "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.

入力スキーマ

{
  "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).

入力スキーマ

{
  "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).

入力スキーマ

{
  "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.

入力スキーマ

{
  "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.

入力スキーマ

{
  "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.

入力スキーマ

{
  "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.

入力スキーマ

{
  "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.

入力スキーマ

{
  "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.

入力スキーマ

{
  "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.

入力スキーマ

{
  "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.

入力スキーマ

{
  "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
}

コミュニティ

このサーバーを評価する

エビデンス

最近の観測

検証済みバージョンは記録されていませんツール 18 件