mcpserver.so LogoMCPFly
Submit
Facebook Ads MCP Server logo

Facebook Ads MCP Server

by Tisik79

Marketing/AdvertisingFacebook AdsClaude AIMarketing API

This MCP server provides an interface for communicating with the Facebook Marketing API using the MCP protocol. It allows Claude AI and other LLM models to work with Facebook ads, enabling campaign creation, management, analysis, and performance optimization.

View on GitHub

Last updated: N/A

Facebook Ads MCP Server

MCP (Model Context Protocol) server pro zadávání a vyhodnocování reklamních kampaní na Facebooku s využitím Claude AI.

Popis

Tento MCP server poskytuje rozhraní pro komunikaci s Facebook Marketing API pomocí protokolu MCP. Umožňuje Claude AI a dalším LLM modelům pracovat s Facebook reklamami – vytvářet a spravovat kampaně, analyzovat výsledky a optimalizovat výkon.

Funkce

  • Správa reklamních kampaní

    • Vytváření nových kampaní
    • Získání seznamu existujících kampaní
    • Úprava parametrů kampaní
    • Odstranění kampaní

  • Analytika a reportování

    • Získání přehledu o výkonu kampaní
    • Srovnání více kampaní
    • Analýza účtu
    • Demografická analýza publika

  • Správa publik

    • Vytváření vlastních publik
    • Vytváření lookalike publik
    • Správa seznamů uživatelů

  • AI asistence

    • Šablony promptů pro Claude AI
    • Analýza výkonu kampaní
    • Doporučení pro optimalizaci

Požadavky

  • Node.js (verze 18 nebo vyšší)
  • Facebook Business Manager účet
  • Facebook App s přístupem k Marketing API
  • Přístupový token s oprávněními pro Facebook Ads API
  • Claude AI nebo jiný LLM s podporou MCP

Instalace

  1. Klonujte repozitář:
git clone https://github.com/Tisik79/MCP-Facebook.git
cd MCP-Facebook
  1. Nainstalujte závislosti:
npm install
  1. Vytvořte soubor .env s následujícím obsahem:
FACEBOOK_APP_ID=your_app_id
FACEBOOK_APP_SECRET=your_app_secret
FACEBOOK_ACCESS_TOKEN=your_access_token
FACEBOOK_ACCOUNT_ID=your_ad_account_id
PORT=3000
  1. Zkompilujte TypeScript:
npm run build
  1. Spusťte server:
npm start

Konfigurace pro Claude Desktop

Pro použití tohoto MCP serveru s Claude Desktop přidejte následující konfiguraci do konfiguračního souboru Claude Desktop:

{
  "mcpServers": {
    "facebook-ads": {
      "command": "node",
      "args": ["cesta/k/facebook-ads-mcp-server/dist/index.js"],
      "env": {
        "FACEBOOK_APP_ID": "<YOUR_APP_ID>",
        "FACEBOOK_APP_SECRET": "<YOUR_APP_SECRET>",
        "FACEBOOK_ACCESS_TOKEN": "<YOUR_ACCESS_TOKEN>",
        "FACEBOOK_ACCOUNT_ID": "<YOUR_AD_ACCOUNT_ID>"
      }
    }
  }
}

Dostupné nástroje

Nástroje pro správu kampaní

  • create_campaign - Vytvoření nové reklamní kampaně
  • get_campaigns - Získání seznamu kampaní
  • get_campaign_details - Získání detailů o kampani
  • update_campaign - Aktualizace kampaně
  • delete_campaign - Odstranění kampaně

Nástroje pro analýzu a vyhodnocování

  • get_campaign_insights - Získání analytických dat o kampani
  • get_account_insights - Získání souhrnných dat o účtu
  • compare_campaigns - Porovnání více kampaní
  • get_campaign_demographics - Získání demografických údajů

Nástroje pro správu publik

  • create_custom_audience - Vytvoření vlastního publika
  • get_custom_audiences - Získání seznamu publik
  • create_lookalike_audience - Vytvoření lookalike publika
  • add_users_to_custom_audience - Přidání uživatelů do publika

Bezpečnost

Tento MCP server vyžaduje přístup k vašemu Facebook Business Manager účtu prostřednictvím přístupového tokenu. Zajistěte, aby tento token byl bezpečně uložen a nebyl sdílen s neoprávněnými osobami.

Pro produkční nasazení doporučujeme:

  • Používat token s minimálními potřebnými oprávněními
  • Používat proměnné prostředí pro citlivé údaje
  • Pravidelně obnovovat přístupové tokeny
  • Implementovat další vrstvy zabezpečení (firewall, VPN)

Licence

Distribuováno pod licencí MIT.