Spresh Spy On Competitor Fb Ads

spreshapp-mcp

将 Claude 连接到 SpreshApp Facebook 广告情报平台的 MCP 服务。

---

直接在 Claude Desktop 或 Claude Code 会话中，让 Claude 调研竞争对手、解读成功广告的角度、追踪品牌广告历史，并分析你保存的广告库。

要求

• Node.js >= 20
• 一个 SpreshApp 账户

设置

Claude Desktop

将以下内容添加到你的 claude_desktop_config.json（macOS：~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "spreshapp": {
      "command": "npx",
      "args": ["-y", "spreshapp-mcp"]
    }
  }
}

保存后重启 Claude Desktop。

Claude Code

claude mcp add spreshapp -- npx -y spreshapp-mcp

VS Code（使用 MCP 扩展）

{
  "mcp": {
    "servers": {
      "spreshapp": {
        "command": "npx",
        "args": ["-y", "spreshapp-mcp"]
      }
    }
  }
}

身份验证

启动 MCP 服务前，请先完成一次身份验证：

npx -y spreshapp-mcp login

这会打开浏览器，让你使用 SpreshApp 账户登录（通过 PKCE 的 OAuth 2.0）。登录后，凭据会保存到 ~/.spreshapp/credentials.json（文件模式为 600），并在每次会话开始前自动刷新。

对于无头或远程 Agent 环境，请使用控制面板中的 SpreshApp API 密钥，而非浏览器 OAuth：

npx -y spreshapp-mcp login --no-browser

这会向用户和 Agent 显示设置说明。用户可以在 spreshapp.com/app/api-access 创建或复制密钥。密钥以 sk_sprs_ 开头。

在 MCP 服务环境中设置密钥：

SPRESHAPP_API_KEY=sk_sprs_... npx -y spreshapp-mcp

高级配置仍支持 OAuth 令牌变量：SPRESHAPP_ACCESS_TOKEN、SPRESHAPP_REFRESH_TOKEN、SPRESHAPP_CLIENT_ID 和 SPRESHAPP_TOKEN_EXPIRES_AT。

检查身份验证状态：

npx -y spreshapp-mcp status

重新登录：

npx -y spreshapp-mcp logout
npx -y spreshapp-mcp login

可用工具

广告工具

工具	描述
ad_search	按关键词、细分市场或行业搜索 Facebook 广告
ad_search_expand_query	扩展搜索查询，以展示更多相关广告
ad_get	获取特定广告的完整详情
ad_get_analysis	获取广告已保存的 AI 分析
ad_analyze	对任意广告运行 AI 分析
ad_analyze_batch	在一次调用中分析多条广告
ad_chat	与 Claude 讨论广告的创意策略

品牌工具

工具	描述
brand_search	在 SpreshApp 中搜索品牌
brand_get_overview	获取品牌的完整资料和统计数据
brand_get_status	获取品牌当前的追踪状态
brand_get_ad_history	获取品牌的历史广告数量数据
brand_list_active_ads	列出品牌当前投放的所有广告
brand_follow	开始追踪品牌

广告库工具

工具	描述
search_ads	搜索你已保存的广告库
get_folder_ads	获取指定文件夹中的广告
list_folders	列出你保存的所有文件夹
get_tags	列出广告库中使用的标签
get_pages	列出已保存的 Facebook 公共主页

示例提示词

Find 10 high-performing Facebook video ads in the fitness niche and summarize the angles used.

Research Nike's current Facebook ad strategy, how many ads are they running and what are the themes?

Open my "Inspiration" folder and identify the top 3 creative hooks.

Track the brand glossier.com and show me their ad history over the last 30 days.

故障排除

症状	解决方法
浏览器未打开	复制终端中显示的 URL，并手动打开
“身份验证已过期”错误	删除 ~/.spreshapp/credentials.json 并重新运行
“未订阅任何套餐”	访问 spreshapp.com/pricing
“已达到每日限额”	配额会在 UTC 午夜重置，或升级套餐
“此功能不可用”	你当前的套餐不包含此工具，请在 spreshapp.com/pricing 升级套餐

License

UNLICENSED — proprietary software. See spreshapp.com for terms.