English Français العربية

io.github.PrashantBtkl/spresh-mcp

السجل الرسمي البحث والويب

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package spreshapp-mcp
Claude Code 
claude mcp add spresh-mcp -- npx -y spreshapp-mcp@1.0.3
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "spresh-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "spreshapp-mcp@1.0.3"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. spreshapp-mcp
  2. Requirements
  3. Setup
  4. Authentication
  5. Available Tools
  6. Example prompts
  7. Troubleshooting
  8. License

spreshapp-mcp

MCP server that connects Claude to SpreshApp's Facebook ad intelligence platform.

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.

Requirements

Setup

Claude Desktop

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

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

Restart Claude Desktop after saving.

Claude Code
claude mcp add spreshapp -- npx -y spreshapp-mcp
VS Code (with MCP extension)
{
  "mcp": {
    "servers": {
      "spreshapp": {
        "command": "npx",
        "args": ["-y", "spreshapp-mcp"]
      }
    }
  }
}

Authentication

Authenticate once before starting the MCP server:

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:

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:

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:

npx -y spreshapp-mcp status

To log in again:

npx -y spreshapp-mcp logout
npx -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.

الأسئلة الشائعة

ما هو io.github.PrashantBtkl/spresh-mcp؟

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

كيف أثبّت io.github.PrashantBtkl/spresh-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add spresh-mcp -- npx -y spreshapp-mcp@1.0.3. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.PrashantBtkl/spresh-mcp إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.PrashantBtkl/spresh-mcp مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.PrashantBtkl/spresh-mcp؟

ينشره PrashantBtkl. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.