Spresh Mcp

io.github.PrashantBtkl由 GitHub 账号 PrashantBtkl 发布v1.0.3更新于 Oct 27, 2026

Search Facebook ads, decode competitor creative strategy, and track brand ad history.

已验证STDIO仅桌面数据与分析商业与电商

概览

AI 生成的概览

将 Claude 连接到 SpreshApp 的 Facebook 广告情报平台，可搜索广告、分析竞品创意策略并追踪品牌广告历史。

可以做什么
  • 按关键词、细分领域或行业搜索 Facebook 广告，扩展查询词并获取广告详情
  • 对单条或多条广告运行 AI 分析，并就广告创意策略进行对话
  • 查询品牌、查看品牌资料与统计、追踪状态、广告历史及在投广告，并可开始追踪品牌
  • 按文件夹、标签或已保存主页浏览自己的广告收藏库
适用场景
适合营销人员、投放人员和创业者，在 Claude 会话中研究竞品 Facebook 广告创意与品牌投放动态，或查询自己在 SpreshApp 中保存的广告库。
运行要求
通过 npx 在本地运行，需要 Node.js 20 或更高版本。需要 SpreshApp 账号，部分工具需付费套餐。需先用登录命令完成一次认证（浏览器 OAuth 2.0 配合 PKCE），无浏览器环境可改用 SPRESHAPP_API_KEY 环境变量中的 API 密钥；也支持 OAuth 令牌相关环境变量。
安装前请注意
凭据保存在本地凭据文件中，API 密钥或 OAuth 令牌从环境变量读取，应视为机密。部分工具受订阅套餐和每日配额限制，追踪品牌会改变账号中的追踪状态。广告检索查询与广告库数据会发送至 SpreshApp 服务。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Spresh Mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

[SpreshApp logo]

spreshapp-mcp

MCP server that connects Claude to SpreshApp's Facebook ad intelligence platform.
[npm version] [Node 20+] [MCP compatible]

Ask Claude to research competitors, decode winning ad angles, track brand ad history, and analyze your saved ad library, all directly from your Claude Desktop or Claude Code session.

[SpreshApp MCP in Claude Code]

Requirements

Setup

Claude Desktop

Add this to your claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

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

Restart Claude Desktop after saving.

Claude Code

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

VS Code (with MCP extension)

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

Authentication

Authenticate once before starting the MCP server:

bash
npx -y spreshapp-mcp login

This opens your browser to log in with your SpreshApp account (OAuth 2.0 with PKCE). After login, credentials are saved to ~/.spreshapp/credentials.json (file mode 600) and refreshed automatically before each session.

For headless or remote agent environments, use a SpreshApp API key from the dashboard instead of browser OAuth:

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

This prints setup instructions for the user and agent. The user can create or copy a key at spreshapp.com/app/api-access. Keys start with sk_sprs_.

Set the key in the MCP server environment:

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

OAuth token variables are still supported for advanced setups: SPRESHAPP_ACCESS_TOKEN, SPRESHAPP_REFRESH_TOKEN, SPRESHAPP_CLIENT_ID, and SPRESHAPP_TOKEN_EXPIRES_AT.

Check auth status:

bash
npx -y spreshapp-mcp status

To log in again:

bash
npx -y spreshapp-mcp logoutnpx -y spreshapp-mcp login

Available Tools

Ad tools

ToolDescription
ad_searchSearch Facebook ads by keyword, niche, or industry
ad_search_expand_queryExpand a search query to surface more relevant ads
ad_getFetch full details for a specific ad
ad_get_analysisRetrieve saved AI analysis for an ad
ad_analyzeRun AI analysis on any ad
ad_analyze_batchAnalyze multiple ads in one call
ad_chatChat with Claude about an ad's creative strategy

Brand tools

ToolDescription
brand_searchSearch for brands in SpreshApp
brand_get_overviewGet a brand's full profile and stats
brand_get_statusGet the current tracking status for a brand
brand_get_ad_historyGet historical ad volume data for a brand
brand_list_active_adsList all ads a brand is currently running
brand_followStart tracking a brand

Library tools

ToolDescription
search_adsSearch your saved ad library
get_folder_adsGet ads from a specific folder
list_foldersList all your saved folders
get_tagsList tags used across your library
get_pagesList saved Facebook pages

Example prompts

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.

Troubleshooting

SymptomFix
Browser did not openCopy the URL printed to the terminal and open it manually
"Authentication expired" errorDelete ~/.spreshapp/credentials.json and re-run
"Not subscribed to any plan"Visit spreshapp.com/pricing
"Daily limit reached"Quota resets at midnight UTC, or upgrade your plan
"Feature not available"Your current plan does not include this tool, upgrade at spreshapp.com/pricing

License

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

来源：README.md，提交 bb186a9

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.0.3最新Sep 16, 2026

评分

已满足适用检查项的 40%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。