Spytrend

Spytrend MCP 服务

Spytrend 是一个广告分析平台。 本仓库是其 MCP 服务的官方主页：只需一个 URL、在浏览器中登录，AI 助手就能直接处理 Meta 和 TikTok 的广告数据——广告及其背后的图片和视频、广告主，以及投放广告的人。无需安装任何内容，也无需粘贴密钥：服务在我们这边运行，你只需使用 Spytrend 账号登录，也就是你在网站上使用的同一个账号。所有套餐都支持连接，包括免费套餐；使用量按令牌计费，你为结果付费，而不是为提问付费——没有返回内容的调用不收费。一条广告只是单帧。在这里，你可以看到竞争对手投放的全部广告。

---

本仓库的内容

本仓库包含由我们托管的服务的公开目录元数据（见 server.json），以及设置说明和使用示例。服务本身属于 Spytrend 平台，其源代码不开源。此处没有可下载的软件包，也没有可运行的代码——只需提供 URL 并点击登录按钮即可连接。

---

连接

端点

https://mcp.spytrend.com/mcp

登录： 在浏览器中使用你的 Spytrend 账号。无需 API 密钥，也无需粘贴令牌。

账号中的位置： Settings → AI / MCP，或访问连接页面 https://spytrend.com/mcp/?utm_source=github&utm_medium=repo&utm_campaign=mcp-launch。

无论使用哪个客户端，只需三个步骤：

1. 打开客户端的连接器设置。
2. 添加远程 MCP 服务，并填写上方的 URL。
3. 在浏览器窗口打开后登录，然后开始提问。

各客户端的说明：docs/quickstart.md。

一键安装：

Claude — 桌面端、命令行和 Web

在 Settings → Connectors 中添加自定义连接器，粘贴端点 URL，然后在打开的浏览器窗口中完成登录。 完整操作指南：docs/quickstart.md#claude。

ChatGPT

在 Settings 中将端点添加为连接器，然后使用你的 Spytrend 账号登录。 完整操作指南：docs/quickstart.md#chatgpt。

Cursor · Codex · VS Code

将上方端点添加为 streamable-http 类型的远程 MCP 服务，然后根据提示通过浏览器登录。 完整操作指南：docs/quickstart.md。

任何支持 Streamable HTTP 的客户端都可以使用——我们写了使用说明的只有上面这四种。

---

你将获得什么

搜索。 按关键词、业务类别、格式或投放日期，查询某个市场、类别或国家/地区正在投放什么广告。还可以直接搜索广告素材：人们实际看到的图片和视频。

一条完整记录。 打开单条广告、广告主，或一组广告背后的账户，即可获取完整记录：文案、素材、页面、域名、国家/地区和投放日期。

排行榜。 查看某个国家/地区、类别或应用中近期热度上升的内容——当你还没有明确的竞争对手目标时，可以从这里开始。

文件夹和余额。 将找到的内容保存到文件夹，以便日后取用。随时免费查看余额。

自主 Agent。 Agent 可以自行注册，并在任何人注册之前开始采样数据库：归档结果、市场级排行榜、每次调用获取 10 行，不含媒体内容。将其关联到 Spytrend 账户即可解锁其余功能。请参阅 docs/quickstart.md。

---

竞争对手投放的所有内容

一条广告只是单帧。在这里，你可以看到完整的投放内容：每条广告、每段视频、每个页面、每个域名、每个国家/地区和每个投放日期，汇总在一条记录中。只需打开广告背后的账户，完整情况就已整理好——无需自己逐个标签页点击查看。

大多数服务只回答一个问题：给我看看这条广告。 这里回答的是另一个问题：是谁在投放广告？他们还投放了什么？

---

工具

工具	功能	费用
search_ads	按关键词、国家、业务类别、格式和投放日期搜索 Meta 和 TikTok 广告	每返回一行消耗 1 个令牌
search_creatives	搜索广告素材本身，即用户实际看到的图片和视频	每返回一行消耗 1 个令牌
search_advertisers	按名称、域名、国家或业务类别查找广告主	每返回一行消耗 1 个令牌
search_webmasters	查找一组广告背后的公司或个人：一个账号在多个页面、域名和国家投放许多广告	每返回一行消耗 1 个令牌
search_hubs	按目的地探索广告引导用户前往的地方，包括社交平台、应用商店、线上市场和商店	目的地目录：免费。目录中的资料：每返回一行消耗 1 个令牌
search_shops	将域名作为流量入口进行查询，查看月访问量估算值及每项估算的置信度	每返回一行消耗 1 个令牌
get_ad	返回一条广告的完整记录：文案、素材、广告主、国家、投放日期和目标页面	1 个令牌
get_advertiser	完整返回一位广告主的信息：页面、国家和业务类别	1 个令牌
get_webmaster	在一条记录中返回一组广告背后的账号投放的所有广告	1 个令牌
get_creative	返回一张图片或一个视频的记录：投放位置及重复投放次数	1 个令牌
get_shop	返回一个域名的完整资料	1 个令牌
get_media	下载图片或视频文件本身	每条广告 1 个令牌 · 每项素材 10 个令牌
get_trends	返回国家、类别或应用的排名，包括近期开始走红的内容	每返回一行消耗 1 个令牌
get_ads_analytics	返回一组广告的分布情况，而非广告本身：数量，以及按状态、国家、业务类别、目的地和广告主划分的情况	Pro 及以上套餐 · 每条细分记录消耗 1 个令牌
find_similar_ads	查找使用与你已有广告相同素材的广告	每返回一行消耗 1 个令牌
find_similar_creatives	查找与你已有素材相似的图片和视频	每返回一行消耗 1 个令牌
find_similar_webmasters	查找投放广告方式与你已有账号相似的账号	每返回一行消耗 1 个令牌
get_webmaster_similarity_facets	在请求列表之前，展示两个账号相似的依据	免费
add_to_favorites	将广告、图片或视频、广告主、目的地或账号保存到文件夹	广告 1 个令牌 · 素材 10 个令牌 · 其他均免费
list_favorites	返回文件夹中的内容	免费
get_usage	显示你的套餐、余额以及每次调用的费用	免费

每个页面默认返回 20 行，除非你要求更多，但最多不超过 200 行。费用按 实际返回的行数计算——如果页面返回的行数较少，差额会自动退还。TikTok 数据集 （source=tiktok，Pro 套餐及以上）单独计价，每返回一行消耗 100 个令牌。

每项工具的 适用场景 / 不适用场景 指引、返回格式和请求示例： docs/tools.md。

词语释义。 在本产品中，webmaster 指一组广告背后的公司或个人：一个账号在不同页面、域名和国家投放许多广告。工具名称保留原词；描述不依赖该词。

---

技能

skills/ 中提供了 6 个适用于 Claude Code 和 Codex 的现成工作流：绘制垂直领域图谱、分析广告主或一组广告背后的账号、审核网站、按关键词搜索、发现店铺。每项技能都是一个普通文件夹——将其复制到助手的技能目录，然后用自然语言提出请求；技能会决定要调用哪些工具并生成报告。安装步骤和共享规范见：skills/README.md。

一条命令即可安装：Claude Code 使用 /plugin marketplace add Spytrend/spytrend-mcp，然后运行 /plugin install spytrend-mcp-skills@spytrend-mcp；Claude Code、Codex、Cursor、Copilot、Gemini CLI 及其他 70 多种工具使用 npx skills add Spytrend/spytrend-mcp。

---

场景适配器

基于同一托管服务的精简 stdio 适配器，每个适配器都针对一种研究场景，并提供专属工具名称。当你希望助手只能看到目录中的一个部分时，可以使用它们。

• facebook-ads-library-mcp — Meta / Facebook 广告资料库搜索，数据源固定为 Meta。
• tiktok-ads-library-mcp — TikTok 广告研究，数据源固定为 TikTok（Pro 计划）。

所有适配器都连接到 https://mcp.spytrend.com/mcp，并共享同一账号、计划和令牌。

---

社区

由社区构建——不由 Spytrend 团队维护：

• dvygolov/spytrend-cli，作者 Daniel Vygolov — 独立的 Python CLI 和可直接使用的 Agent 技能，通过 Streamable HTTP 和 OAuth2 客户端凭据调用此服务，适用于无需 MCP 主机即可运行的 Agent 和脚本。

基于 Spytrend MCP 构建了什么项目？请提交一个附有链接的 issue，我们会将其添加到这里。

---

示例

以下是人们第一天就会向助手提出的请求。用自己的话输入请求——助手会选择相应的工具。

示例	你的请求
查找在你所在市场投放广告的其他人	目前有哪些人在你的领域投放广告？他们投放的是什么？
匹配业务类型	类似你这类企业投放的广告——无需提供竞争对手名称
某个市场中的热门广告	某个类别中正在投放哪些广告？按投放时长排序
某个行业目前正在投放的广告	有哪些新广告正在升温？哪些广告已经投放了一段时间？

---

积分与计划

用量按令牌计费，来自同一余额。**你为结果付费，而不是为提问付费：**没有返回结果的调用不收费；返回的页面短于你请求的长度时，差额会退还。

• 每交付一行或一条记录——1 个令牌。包括一行搜索结果、一行排名，以及完整打开的广告主、账号、落地页或创意。
• 下载素材本身——每条广告 1 个令牌，每个创意 10 个令牌。
• TikTok 语料库（source=tiktok，Pro 及以上计划）——每交付一行收取 100 个令牌。
• 查询余额、列出文件夹以及查看落地页目录——免费。

免费的 Starter 计划包含 500 个令牌，永不过期。每个付费计划每月包含 40,000 个令牌——约可进行 2,000 次默认大小的搜索。Enterprise 的限额由支持团队设定。

所有计划（包括免费计划）都可以连接。**免费 Starter 计划的结果仅限存档内容——不包含最近 90 天的数据。**付费计划提供最新广告；这与网站免费版的限制相同。助手始终可以调用 get_usage——此操作免费，且由服务端直接返回结果。当前价格： https://spytrend.com/pricing/?utm_source=github&utm_medium=repo&utm_campaign=mcp-launch

有关详情以及余额耗尽时助手会看到的内容，请参阅： docs/limits.md。

---

文档

文件	内容
docs/quickstart.md	五分钟内完成连接，按客户端分类
docs/tools.md	所有工具：功能、适用场景、不适用场景以及返回内容
docs/limits.md	积分、限制、套餐以及错误的样子
examples/	四个示例：要问什么、会返回什么以及如何解读
skills/	为 Claude Code 和 Codex 准备的六个工作流，包含安装步骤和共享约定
server.json	目录元数据，已发布到官方 MCP 注册表
llms.txt	这项连接的简短机器可读概览，供 AI 助手使用

---

支持

有关连接、访问权限或账户的问题：https://spytrend.com/contact/

如果此仓库有问题——例如链接失效，或说明与屏幕上显示的内容不符：请提交 issue。

安全问题请通过单独的渠道报告，不要通过 issue：参见 SECURITY.md。

---

许可证

MIT——参见 LICENSE。此许可证涵盖此仓库的内容：文档、元数据和示例。服务端本身属于 Spytrend 平台。