Spy.House is a competitor ad monitoring and analysis service. We collect creatives from Facebook, TikTok, Push, In-Page, Native and Adult sources so you can study advertising approaches, track trends and find new ideas for your campaigns.

Why do I need Spy.House?

Spy.House helps you see what ads competitors run, which creatives they use, which GEO they work in and which approaches they test. Use this data to research the market, find ideas and prepare your own advertising campaigns.

Is Spy.House affiliated with Facebook, TikTok or other advertising platforms?

No. Spy.House is an independent analytics service and is not an official representative of Facebook, TikTok or other advertising platforms.

How does creative analysis work?

Spy.House collects advertising creative data and structures it by source, GEO, device, language, vertical and other parameters. Use filters and search to quickly find the ads you need and compare competitor approaches.

Can I use creatives from Spy.House in my own ads?

Creatives in Spy.House are intended primarily for analysis and market research. Before using someone else's materials in your own advertising, make sure you have the necessary rights to the images, videos, texts and other elements.

How much does the subscription cost?

Spy.House is a paid service with subscription plans. Pricing and payment terms are available in your account. The price depends on the feature set and the subscription period.

Is there a trial period?

Yes! New users get a 7‑day free trial to test all core features of Spy.House. This is enough time to evaluate the service and decide whether to purchase a subscription.

Does the subscription renew automatically?

No. The subscription does not renew automatically. Users track the expiration date themselves and can renew the subscription in their account. If payment is not made on time, access to the service is suspended.

Can I get a refund for my subscription?

No. Under the Agreement, paid subscriptions are non‑refundable, even if you stop using the service or change your mind. That’s why there is a 7‑day trial to make an informed purchase decision.

What should I do if the service is down or there’s a technical error?

Try to: • refresh the page; • clear your browser cache; • check your internet connection. If the issue persists, email us at support@spy.house and we’ll investigate. The administration is not responsible for outages caused by third‑party actions (providers, hosting, external services), but we always help users restore access.

I am a rights holder and want to file a complaint — what should I do?

If you believe that any material on Spy.House infringes your rights, please email support@spy.house with: • a link to the material, • a description of the infringement, • documents proving your rights. We will review the request within 5 business days and take action. See the Rights Holders Policy for details.

How do I connect Spy.House MCP to Claude, ChatGPT, Cursor, VS Code or Codex?

MCP is included with an active paid subscription and is not available on trial. Open https://spy.house/mcp-integration, copy the connector URL and follow the steps for your client. After adding a CLI server, restart the client and sign in with Spy.House.

How do I disconnect Spy.House from an AI client?

Remove or disable the Spy.House server in the AI client. Access also stops when the paid subscription ends. Trial accounts cannot connect.

MCP Integration | Spy.House

Connexion

Choisissez votre client

Clients CLI (Claude Code, Codex) : après l'ajout du serveur, redémarrez le client — une session en cours ne le chargera pas. Puis connectez-vous : Claude Code avec /mcp, Codex avec la ligne `codex mcp login` de la commande ci-dessous.

Claude

Desktop et web utilisent le Client ID ci-dessous. Claude Code utilise la commande CLI, avec son propre Client ID.

Desktop / web : Settings → Connectors → Add custom connector

Collez l'URL de l'endpoint et le Client ID ci-dessous, puis 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

Ajoutez le serveur distant en une commande, puis connectez-vous.

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

Exécutez la commande, ou ajoutez le serveur dans ~/.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

Exécutez la commande, ou ajoutez le serveur au mcp.json 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

Ouvrez Claude → Customize → Connectors → Add custom connector.
Indiquez : Name — Spy.House, URL — https://spy.house/mcp. Dans Advanced OAuth settings, indiquez Client ID spy-mcp-claude-desktop ; laissez Client Secret vide.
Cliquez sur Add / Connect.

ChatGPT

Dans ChatGPT web, activez Settings → Security and login → Developer mode, puis ajoutez une remote MCP app dans Plugins : URL https://spy.house/mcp, Client ID spy-mcp-chatgpt, Streamable HTTP, sans Client Secret.
Cliquez sur Connect / Authenticate, connectez-vous à Spy.House et confirmez l'accès. Aucune clé API ni Client Secret n'est requis.
Exécutez cette requête : > Trouve jusqu'à 12 créatifs FB Black Friday pour les USA.

Vérification par requête

Après la connexion, exécutez ces requêtes dans votre client. Les résultats attendus sont une checklist, pas une recherche en direct.

search_creatives

Requête de vérification

Trouve jusqu'à 12 créatifs publicitaires Facebook Black Friday pour les USA.

Résultat attendu :

Jusqu'à 12 créatifs, avec les données et le quota de recherche restant. Un réseau par appel : push, inpage, facebook, tiktok ou native. Chaque recherche non vide consomme une unité de quota.

get_filter_options

Requête de vérification

Liste les filtres de recherche Facebook disponibles.

Résultat attendu :

Le catalogue de filtres Facebook non adult et les valeurs exactes pour search_creatives. Les filtres adult sont omis.

get_creative_media

Requête de vérification

Montre-moi les images des créatifs que tu viens de trouver.

Résultat attendu :

Médias pour jusqu'à trois creative_ref de cette recherche. Le quota de recherche n'est pas débité. La vidéo complète n'est pas renvoyée, et le chat peut ne pas afficher d'aperçu intégré.

render_creatives_gallery

Requête de vérification

Montre ces créatifs en galerie.

Résultat attendu :

Une galerie intégrée de 1–12 creative_ref de la même recherche, dans les clients qui prennent en charge MCP Apps. Les autres clients ignorent cet outil et utilisent le texte ou get_creative_media.

En cas d'erreur, envoyez : le nom du client IA, l'heure, le texte de l'erreur et une capture d'écran.

Questions fréquentes

Comment connecter Spy.House MCP à Claude, ChatGPT, Cursor, VS Code ou Codex ?

MCP est inclus dans un abonnement payant actif et n’est pas disponible en essai. Ouvrez https://spy.house/mcp-integration, copiez l’URL du connecteur et suivez les étapes de votre client. Après l’ajout d’un serveur CLI, redémarrez le client et connectez-vous avec Spy.House.

Comment déconnecter Spy.House d’un client IA ?

Supprimez ou désactivez le serveur Spy.House dans le client IA. L’accès s’arrête aussi à la fin de l’abonnement payant. Les comptes d’essai ne peuvent pas se connecter.

Comment contacter l'assistance ?

E-mail : [email protected]

Telegram : https://telegram.me/Spy_House

Heures d'assistance : Lun–Ven, 10:00–18:00 (UTC+3)