Falar com o gerente
PT PT
Black Friday Banco BRB
● Ativo
Móvel
EUA
BLACK FRIDAY IESA BYD
● Ativo
Móvel
EUA
Croma - Black Friday 🛒🛍️
● Ativo
Móvel
EUA
Black Friday - up to 70% off
● Ativo
Móvel
EUA
Cyber Week: last chance
● Ativo
Móvel
EUA
Black Friday deals inside 🛍️
● Ativo
Móvel
EUA

Spy.house e MCP

Milhões de anúncios da concorrência, consultáveis em linguagem natural. Leve-os para o Claude, ChatGPT, Cursor, VS Code ou Codex.
Claude Codex Cursor VS Code ChatGPT
Ligar o seu cliente

URL do conector

O seu URL do conector MCP
Cole este URL no seu cliente MCP.
Como ligar

Ligue em apenas 3 passos

1
Adicione o servidor
Aponte o seu cliente MCP para o endpoint acima — uma linha de configuração ou o comando abaixo.
2
Inicie sessão com o Spy.House
O cliente abre o browser para autorizar via OAuth. Entra com a sua conta Spy.House — sem API key. É necessária uma subscrição paga ativa; o trial não pode ligar.
3
Pergunte ao seu agente
«Encontra até 12 criativos FB de Black Friday para os EUA». O agente chama a ferramenta certa e responde.
Ligação

Escolha o seu cliente

Clientes CLI (Claude Code, Codex): depois de adicionar o servidor, reinicie o cliente — uma sessão em execução não o carrega. Depois inicie sessão: Claude Code com /mcp, Codex com a linha `codex mcp login` no comando abaixo.
Claude
Claude
Desktop e web usam o Client ID abaixo. O Claude Code usa o comando CLI, com o seu próprio Client ID.

Desktop / web: Settings → Connectors → Add custom connector

Cole o URL do endpoint e o Client ID abaixo, depois Connect & authorize.

claude mcp add --transport http --client-id spy-mcp-claude-code \
--callback-port 8787 spy-house https://spy.house/mcp
Client ID: spy-mcp-claude-desktop
Codex
Codex
Adicione o servidor remoto com um comando e depois inicie sessão.
codex mcp add spy-house --url https://spy.house/mcp \
--oauth-client-id spy-mcp-codex
codex mcp login spy-house
Client ID: spy-mcp-codex
Cursor
Cursor
Execute o comando ou adicione o servidor a ~/.cursor/mcp.json ou .cursor/mcp.json.
cursor --add-mcp '{"name":"spy-house","url":"https://spy.house/mcp","auth":{"CLIENT_ID":"spy-mcp-cursor","scopes":["mcp:search"]}}'
Client ID: spy-mcp-cursor
VS Code
VS Code
Execute o comando ou adicione o servidor ao mcp.json de user ou workspace.
code --add-mcp '{"name":"spy-house","type":"http","url":"https://spy.house/mcp","oauth":{"clientId":"spy-mcp-vscode"}}'
Client ID: spy-mcp-vscode
Claude Web
Claude Web
  1. Abra o Claude → Customize → Connectors → Add custom connector.
  2. Indique: Name — Spy.House, URL — https://spy.house/mcp. Em Advanced OAuth settings, indique Client ID spy-mcp-claude-desktop; deixe Client Secret em branco.
  3. Clique em Add / Connect.
ChatGPT
ChatGPT
  1. No ChatGPT web ative Settings → Security and login → Developer mode e, em Plugins, adicione uma remote MCP app: URL https://spy.house/mcp, Client ID spy-mcp-chatgpt, Streamable HTTP, sem Client Secret.
  2. Clique em Connect / Authenticate, inicie sessão no Spy.House e confirme o acesso. Não é necessária API key nem Client Secret.
  3. Execute esta consulta: > Encontra até 12 criativos FB de Black Friday para os EUA.

Verificação por pedido

Depois de ligar, execute estes pedidos no cliente. Os resultados esperados são uma checklist, não uma pesquisa em direto.

search_creatives
Pedido de verificação
Encontra até 12 criativos publicitários de Facebook de Black Friday para os EUA.
Resultado esperado:
Até 12 criativos, com dados e quota de pesquisa restante. Uma rede por chamada: push, inpage, facebook, tiktok ou native. Cada pesquisa não vazia consome uma unidade de quota.
get_filter_options
Pedido de verificação
Lista os filtros de pesquisa de Facebook disponíveis.
Resultado esperado:
O catálogo de filtros Facebook não adult e os valores exatos para search_creatives. Os filtros adult são omitidos.
get_creative_media
Pedido de verificação
Mostra-me as imagens dos criativos que acabaste de encontrar.
Resultado esperado:
Media de até três creative_ref dessa pesquisa. A quota de pesquisa não é cobrada. O vídeo completo não é devolvido e o chat pode não mostrar uma pré-visualização.
render_creatives_gallery
Pedido de verificação
Mostra estes criativos em galeria.
Resultado esperado:
Uma galeria incorporada de 1–12 creative_ref da mesma pesquisa, em clientes com MCP Apps. Os outros clientes ignoram esta ferramenta e usam texto ou get_creative_media.
Em caso de erro, envie: o nome do cliente de IA, a hora, o texto do erro e uma captura de ecrã.

Perguntas frequentes

Como ligar o Spy.House MCP ao Claude, ChatGPT, Cursor, VS Code ou Codex?
O MCP está incluído numa subscrição paga ativa e não está disponível no trial. Abra https://spy.house/mcp-integration, copie o URL do conector e siga os passos do seu cliente. Depois de adicionar um servidor CLI, reinicie o cliente e inicie sessão com o Spy.House.
Remova ou desative o servidor Spy.House no cliente de IA. O acesso também termina quando a subscrição paga acaba. Contas trial não conseguem ligar-se.

E-mail: [email protected]

Telegram: https://telegram.me/Spy_House

Horário de atendimento: Seg–Sex, 10:00–18:00 (UTC+3)