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

连接

选择你的客户端

CLI 客户端（Claude Code、Codex）：添加服务器后请重启客户端 — 正在运行的会话不会加载它。然后登录：Claude Code 使用 /mcp，Codex 使用下方命令中的 `codex mcp login`。

Claude

Desktop 和网页使用下方 Client ID。Claude Code 使用 CLI 命令，并有自己的 Client ID。

Desktop / web: Settings → Connectors → Add custom connector

粘贴下方 endpoint URL 和 Client ID，然后 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 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/mcp.json 或 .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

运行命令，或将服务器添加到 user 或 workspace 的 mcp.json。

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 → Customize → Connectors → Add custom connector。
填写：Name — Spy.House，URL — https://spy.house/mcp。在 Advanced OAuth settings 中填写 Client ID spy-mcp-claude-desktop；Client Secret 留空。
点击 Add / Connect。

ChatGPT

在 ChatGPT 网页版启用 Settings → Security and login → Developer mode，然后在 Plugins 中添加 remote MCP app：URL https://spy.house/mcp，Client ID spy-mcp-chatgpt，Streamable HTTP，不要填 Client Secret。
点击 Connect / Authenticate，登录 Spy.House 并确认访问。不需要 API key 和 Client Secret。
运行此查询：> 查找最多 12 条美国黑五 FB 创意。

用请求验证

连接后，在客户端运行这些查询。预期结果是检查清单，不是实时搜索。

search_creatives

验证请求

查找最多 12 条美国黑五 Facebook 广告创意。

预期结果：

最多 12 条创意，含数据和剩余搜索配额。每次调用一个网络：push、inpage、facebook、tiktok 或 native。每次非空搜索消耗 1 个配额单位。

get_filter_options

验证请求

列出可用的 Facebook 搜索筛选。

预期结果：

非成人 Facebook 筛选目录，以及 search_creatives 的精确值。不含成人筛选。

get_creative_media

验证请求

给我看你刚找到的创意图片。

预期结果：

该次搜索中最多三个 creative_ref 的媒体。不扣搜索配额。不返回完整视频，聊天可能无法内嵌预览。

render_creatives_gallery

验证请求

把这些创意显示为画廊。

预期结果：

在支持 MCP Apps 的客户端中，嵌入同一搜索的 1–12 个 creative_ref 画廊。其他客户端跳过此工具，改用文本或 get_creative_media。

如遇错误，请发送：AI 客户端名称、时间、错误文本和截图。

Spy.house 与 MCP

连接器 URL

只需 3 步即可连接

选择你的客户端

常见问题

您如何评价我们的服务？

Spy.house 与 MCP

连接器 URL

只需 3 步即可连接

选择你的客户端

常见问题

有问题吗？

分享您的评论

您如何评价我们的服务？