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 分

    請在儲存庫或註冊中心條目中宣告授權條款。