API e MCP

Pergunte ao SpyWinAds direto no ChatGPT e no Claude.

Permita que o ChatGPT, o Claude, o Cursor ou seus scripts consultem vídeos de anúncios do Facebook com o SpyWinAds: a idade do vídeo e todas as lojas que rodam o mesmo vídeo.

https://spywinads.com/mcp
Somente leitura5 ferramentasPlano grátis: 30 chamadas por diaLogin via OAuth

Conectar

ChatGPT

  1. Abra Plugins na barra lateral esquerda, clique em Mais no canto superior direito e escolha Adicionar servidor MCP personalizado.
  2. Cole https://spywinads.com/mcp.
  3. Quando uma ferramenta precisa da sua conta, o ChatGPT pede para você entrar no SpyWinAds e clicar em Allow.

Claude.ai / Claude Desktop

  1. Acesse Customize → Connectors → Add custom connector.
  2. Cole https://spywinads.com/mcp e escolha Sign in when needed.
  3. Entre quando o Claude pedir e clique em Allow.

Claude Code · Cursor · VS Code

Claude Code: rode o comando e digite /mcp para entrar.

claude mcp add --transport http spywinads https://spywinads.com/mcp

Cursor, VS Code, Windsurf, scripts: envie uma chave de API no header:

{ "mcpServers": { "spywinads": {
  "url": "https://spywinads.com/mcp",
  "headers": { "Authorization": "Bearer YOUR_KEY" } } } }

Nunca coloque a chave na URL. Você pode revogar chaves e remover apps conectados a qualquer momento em Configurações → API e MCP do SpyWinAds.

Pergunte ao assistente de IA

“Este vídeo de anúncio é novo ou é um vídeo antigo que voltou a rodar? https://www.facebook.com/ads/library/?id=…”
“Quais vídeos de anúncio do Facebook a loja example.com está rodando, e quantas outras lojas usam os mesmos vídeos?”
“Exporte este produto Shopify para um CSV para eu importar na minha loja: https://store.com/products/…”

Ferramenta

Somente leitura. 5 ferramentas. Plano grátis: 30 consultas por dia. Permissões: ads:read para consultar dados públicos de anúncios e product:export para gerar arquivos CSV de produtos. Não lê dados da conta nem grava nada.

spywin_lookup_video_adEntrada

Link da Biblioteca de Anúncios da Meta ou ID do anúncio

Retorna

Idade real do vídeo (data em que o arquivo chegou ao Facebook pela primeira vez, margem de 1–2 dias), primeiro anúncio, número de anúncios ativos, número de lojas que rodam ou já rodaram o mesmo vídeo, as lojas que o rodaram primeiro na base

spywin_spy_store_adsEntrada

Domínio da loja

Retorna

Anúncios ativos, anúncios novos nos últimos 7 dias, número de vídeos, produtos, páginas, vídeos em destaque com idade real e número de lojas

spywin_get_page_adsEntrada

Link ou ID da página do Facebook

Retorna

Total de anúncios e anúncios ativos, número de vídeos, vídeos em destaque, lojas para onde a página envia tráfego

spywin_export_shopify_productEntrada

Link de produto Shopify

Retorna

Nome, preço, variantes, imagens, link para baixar o CSV para importar no Shopify (válido por 24 horas) e os vídeos de anúncio do produto na base. Permissão product:export

spywin_get_video_reuse_researchEntrada

—

Retorna

Os principais números do relatório SpyWinAds Video Reuse Index, com links para a metodologia e os dados. Não exige login

Obtenha uma chave de API grátis

Para scripts e editores de código (Cursor, VS Code). O ChatGPT e o Claude não precisam de chave: eles entram com a sua conta SpyWinAds. Informe seu e-mail: enviaremos um link de confirmação e mostraremos a chave uma única vez.

Já tem uma conta SpyWinAds? Crie uma chave direto no app: Configurações → API e MCP.

REST API

curl -H "Authorization: Bearer YOUR_KEY" \
  "https://spywinads.com/api/v1/store?domain=example.com"

Endpoints: /api/v1/video?ad= · /api/v1/store?domain= · /api/v1/page?page= · /api/v1/product?url= · /api/v1/research/video-reuse. Especificação OpenAPI: /api/v1/openapi.json (funciona com GPT Actions e n8n).

Limites e dados

  • Plano grátis: 30 consultas por dia (renovadas às 0h, horário do Vietnã), no máximo 20 consultas por minuto. Contas em teste: 100 consultas por dia.
  • Dados: anúncios da Meta (Facebook, Instagram) exibidos nos EUA, da base do SpyWinAds. As contagens são mínimas, não vendas. Não há valores de investimento em anúncios, alcance ou receita. “Loja mais antiga” é a mais antiga na base, não a dona do vídeo.
  • Cada consulta retorna exatamente o que as ferramentas grátis na web mostram; não há busca em toda a base.
  • Ainda não está na base? O resultado traz um link para a ferramenta na web, onde você pede uma varredura grátis.

Dúvidas: support@spywinads.com · Política de privacidade ›