Skip to main content
Glama
DatalisHQ

ZuckerBot

by DatalisHQ

ZuckerBot

AI 에이전트를 위한 Meta Ads 툴킷.

한 번의 메시지로 광고 계정을 감사하세요. 계정 감사, 캠페인 관리, 크리에이티브 분석, 오디언스 구축, 전환 추적을 위한 50개 이상의 도구. 단 하나의 npx 명령. Claude, ChatGPT, OpenClaw, Cursor 및 모든 MCP 호환 에이전트에서 작동합니다.

npm version License: MIT MCP Registry GitHub stars

{
  "mcpServers": {
    "zuckerbot": {
      "command": "npx",
      "args": ["-y", "zuckerbot-mcp"],
      "env": { "ZUCKERBOT_API_KEY": "zb_live_your_key_here" }
    }
  }
}

API 키 받기 (무료) · npm · 문서 · 웹사이트


왜 ZuckerBot인가?

여러분의 에이전트는 이미 코드를 작성하고, 파일을 관리하며, 웹을 검색합니다. 광고도 관리할 수 있어야 합니다.

ZuckerBot은 MCP를 통해 모든 AI 에이전트에 완전한 Meta Ads 기능을 제공합니다. 대시보드도, 배울 UI도, 로그인할 플랫폼도 없습니다. 에이전트가 설치하고, 광고 계정을 연결하고, 작업을 시작합니다.

에이전트가 ZuckerBot으로 할 수 있는 일:

  • 한 번의 메시지로 광고 계정 감사 — 검토 대상으로 표시된 지출, 크리에이티브 피로도, 기회 점수, 우선순위가 매겨진 조치 항목 (무료 티어 포함)

  • 캠페인 실적을 확인하고 효과가 있는 것을 파악

  • 광고 크리에이티브를 분석하고 다음에 테스트할 것을 추천

  • 타게팅과 예산을 갖춘 캠페인 구축 및 출시

  • 맞춤 및 유사 오디언스 생성

  • 서버 측 전환 추적(CAPI) 설정

  • 경쟁사, 리뷰, 시장 벤치마크 조사

  • 광고 크리에이티브 브리프 및 카피 생성

Related MCP server: muze-mcp

작동 방식

You ↔ Your Agent (Claude, ChatGPT, OpenClaw, Cursor, etc.)
                  ↕
            ZuckerBot MCP
                  ↕
         Meta Marketing API

ZuckerBot이 Meta API의 복잡성을 처리합니다. 에이전트가 대화를 처리합니다. 결정은 여러분이 내립니다.

설치

Claude Desktop

claude_desktop_config.json에 추가:

{
  "mcpServers": {
    "zuckerbot": {
      "command": "npx",
      "args": ["-y", "zuckerbot-mcp"],
      "env": { "ZUCKERBOT_API_KEY": "zb_live_your_key_here" }
    }
  }
}

OpenClaw

MCP 구성에 추가:

{
  "mcpServers": {
    "zuckerbot": {
      "command": "npx",
      "args": ["-y", "zuckerbot-mcp"],
      "env": { "ZUCKERBOT_API_KEY": "zb_live_your_key_here" }
    }
  }
}

Cursor / Windsurf / 모든 MCP 클라이언트

동일한 구성 패턴입니다. ZuckerBot은 Model Context Protocol을 지원하는 모든 클라이언트에서 작동합니다.

원격 MCP (설치 불필요)

로컬에서 아무것도 실행하고 싶지 않으세요? https://zuckerbot.ai/api/mcp는 동일한 도구를 제공하는 호스팅형 Streamable HTTP 엔드포인트입니다.

  • claude.ai — 사용자 지정 커넥터로 추가하고 (설정 → 커넥터 → 사용자 지정 커넥터 추가) OAuth로 인증하거나, Authorization: Bearer zb_live_... 헤더를 전달하세요.

  • Claude Code:

claude mcp add --transport http zuckerbot https://zuckerbot.ai/api/mcp --header "Authorization: Bearer zb_live_..."
  • 모든 Streamable HTTP 클라이언트 — API 키를 베어러 토큰으로 사용하여 https://zuckerbot.ai/api/mcp에 연결하세요.

CLI (사람용)

npm install -g zuckerbot-mcp

zuckerbot preview https://your-business.com
zuckerbot meta status
zuckerbot create https://your-business.com --budget 5000 --objective leads

도구 (50개 이상)

감사 및 라이선스 (2)

도구

기능

audit_account

완전한 읽기 전용 계정 감사: 각 캠페인 목표 대비 검토 대상으로 표시된 지출, 크리에이티브 피로도, 기회 점수(0-100), 예상 CPL 개선, 우선순위가 매겨진 조치 항목. 모든 티어에서 사용 가능 — 첫 호출로 권장

redeem_license

평생 라이선스 코드(Dealify/AppSumo)를 교환하고 계정의 모든 API 키를 업그레이드

설정 및 계정 (7)

도구

기능

quickstart

안내형 설정: 인증 확인, 다음 단계 표시, 권장 도구 흐름

meta_status

API 키에 대한 Meta 연결 상태 확인

list_ad_accounts

사용 가능한 Meta 광고 계정 및 현재 선택 항목 나열

select_ad_account

특정 광고 계정 연결

list_meta_pages

Facebook 페이지 및 현재 선택 항목 나열

select_meta_page

광고 게재를 위한 활성 페이지 설정

get_launch_credentials

출시 전에 필요한 모든 자격 증명이 설정되어 있는지 확인

캠페인 (9)

도구

기능

preview_campaign

URL에서 광고 미리보기 생성(Meta 계정 불필요)

create_campaign

전략, 타게팅, 크리에이티브가 포함된 캠페인 초안 생성

get_campaign

캠페인 세부 정보, 워크플로 상태, 연결된 크리에이티브 조회

approve_campaign_strategy

인텔리전스 캠페인의 티어와 크리에이티브 앵글 승인

suggest_angles

초안에 대한 제안된 크리에이티브 앵글 및 오디언스 티어 조회

activate_campaign

현재 사용 불가; 인텔리전스 캠페인은 계획 전용으로 유지

launch_campaign

초안에서 하나 또는 모든 변형을 Meta에 출시

pause_campaign

실행 중인 캠페인 일시중지; 재개는 일시적으로 비활성화

get_performance

실시간 캠페인 지표: 지출, 리드, CPL, CTR, ROAS

오디언스 (6)

도구

기능

create_seed_audience

해시된 CAPI 사용자로 맞춤 오디언스 구축

create_lookalike_audience

모든 시드 오디언스에서 유사 오디언스 생성

list_audiences

모든 맞춤 및 유사 오디언스 나열

refresh_audience

오디언스 새로고침 또는 Meta에서 최신 상태 동기화

get_audience_status

오디언스 규모, 상태, 준비 상태 확인

delete_audience

Meta 및 ZuckerBot에서 오디언스 제거

크리에이티브 (8)

도구

기능

upload_creative

완성된 에셋 업로드 및 일시중지된 Meta 광고 프로비저닝

get_creative_status

크리에이티브 생성 진행 상황 확인

creative_analysis

추천 사항이 포함된 광고 크리에이티브 실적 AI 분석

creative_qa

Meta 광고 정책 기준 크리에이티브 품질 검사

generate_briefs

실적 데이터 기반 크리에이티브 브리프 생성

generate_creatives*

광고 카피와 이미지 생성(또는 AI 비디오)

request_creative*

프로덕션을 위한 크리에이티브 핸드오프 패키지 생성

* 크리에이티브 이미지/비디오 생성 도구(generate_static_ad, generate_video_ad, get_video_ad_status, generate_creatives, request_creative)는 기본적으로 비활성화되어 있습니다 — MCP 구성 환경에서 ZUCKERBOT_ENABLE_CREATIVE_TOOLS=1로 활성화하세요(유료 애드온 출시 예정). 모든 크리에이티브 분석 도구는 계속 사용할 수 있습니다.

전환 추적 / CAPI (5)

도구

기능

capi_config

서버 측 전환 추적 구성 가져오기 또는 업데이트

capi_status

7일 및 30일 CAPI 전달 및 기여 통계

capi_test

CAPI 파이프라인을 통해 테스트 이벤트 전송

sync_conversion

리드 품질 피드백을 Meta 알고리즘에 전송

list_pixels

전환 추적용 Meta 픽셀 나열 및 선택

리포트 (2)

도구

기능

get_campaign_insights

계정 내 모든 캠페인(ZuckerBot이 아닌 캠페인 포함)에 대한 캠페인/광고 세트/광고 수준의 Meta 실적, 중복 제거된 리드 지표 포함

get_account_insights

계정 전체 지출, 노출수, CTR, CPM, CPC 및 빈도를 일별 또는 월별로 집계

get_campaign_insights는 하나로 합쳐진 숫자가 아닌 세 가지 개별 리드 수치를 제공하며, 각 수치는 Ads Manager에서 검증된 값입니다:

필드

의미

meta_result / cost_per_meta_result

모든 목표에 대한 Meta의 공식 중복 제거 "Results"(Ads Manager의 "Results" 열)로, meta_result_type이 기본 결과를 명명합니다(리드 캠페인의 경우 conversion_lead, 판매의 경우 offsite_conversion.fb_pixel_complete_registration / purchase). 이제 더 이상 사용되지 않는 results / cost_per_result를 대체합니다.

meta_leads / cost_per_meta_lead

중복 제거된 Meta 내 리드(onsite_conversion.lead_grouped) — Ads Manager의 "Meta Leads"와 일치

conversion_leads / cost_per_conversion_lead

CRM 자격을 갖춘 전환 리드(Meta의 results 지표 conversion_leads:conversion_lead에서 유래) — "Conversion leads"와 일치. 리드 전용(리드가 아닌 목표에서는 0)

actions / cost_per_action_type

모든 Meta 액션 유형에 대한 레이블이 지정된 전체 배열 { action_type, value }(횟수) 및 { action_type, value }(달러 단위 비용)

results / cost_per_result

더 이상 사용되지 않음. 혼합 캠페인의 순위를 잘못 매기는 목표 기준으로 산출된 결과. 이전 버전 호환을 위해 유지 — meta_result / cost_per_meta_result 권장

leads / cpl

더 이상 사용되지 않음. 인스턴트 폼 리드와 해당 CAPI 에코를 이중으로 집계하는 부풀려진 표면 횟수(action_type: lead). 이전 버전 호환을 위해 유지 — meta_leads / conversion_leads 권장

비용은 spend / count로 산출됩니다. Meta의 cost_per_action_type은 비가산적이므로 절대 합산되지 않습니다. 동일한 필드는 summary에서 total_meta_result / blended_cost_per_meta_result(meta_result_type 포함), total_meta_leads / blended_cost_per_meta_lead, total_conversion_leads / blended_cost_per_conversion_lead로 집계됩니다(total_leads / blended_cpl은 행별 대응 필드와 함께 더 이상 사용되지 않음).

포트폴리오 (5)

도구

기능

create_portfolio

템플릿으로 오디언스 포트폴리오를 생성합니다

launch_portfolio

일시적으로 사용 불가; 포트폴리오는 계획/모니터링 전용으로 유지됩니다

portfolio_performance

티어별 포트폴리오 성과 분석

rebalance_portfolio

티어 간 예산 리밸런싱 드라이런 또는 적용

리서치 (3)

도구

기능

research_reviews

모든 비즈니스에 대한 리뷰 인텔리전스

research_competitors

업종 및 지역별 경쟁사 광고 분석

research_market

시장 인텔리전스 및 광고 벤치마크

비즈니스 컨텍스트 (4)

도구

기능

enrich_business

웹사이트를 크롤링하고 구조화된 비즈니스 컨텍스트를 캐시합니다

upload_business_context

텍스트 콘텐츠를 업로드하고 비즈니스 인사이트를 추출합니다

list_business_context

업로드된 컨텍스트 파일 및 요약을 나열합니다

select_lead_form

캠페인 타겟팅을 위한 리드 폼을 선택합니다

일반적인 에이전트 흐름

0. Audit       →  audit_account (how is this account doing today?)
1. Research    →  research_reviews + research_competitors (parallel)
2. Preview     →  preview_campaign (show user what ads look like)
3. Create      →  create_campaign with mode=legacy (launch-ready draft)
4. Review      →  confirm targeting, creative, Meta connection, and budget
5. Launch      →  launch_campaign after explicit approval
6. Monitor     →  get_performance + creative_analysis
7. Pause       →  pause_campaign whenever delivery must stop
8. Optimise    →  sync_conversion + audience tools

모든 도구는 논리적 다음 단계를 제안하는 _hint 필드를 반환하므로, 에이전트는 항상 다음에 무엇을 해야 할지 알 수 있습니다. 요약: 기존(레거시) 생성 -> 검토 -> 실행 -> 모니터링. 인텔리전스 활성화, 포트폴리오 실행, 캠페인 재개는 Dealify 출시 강화 기간 동안 일시적으로 사용할 수 없습니다. MCP 이름에는 zuckerbot_enrich_business, zuckerbot_upload_business_context, zuckerbot_get_campaign, zuckerbot_activate_campaign, zuckerbot_create_seed_audience가 포함됩니다. zuckerbot_duplicate_ad는 지원되는 하나의 광고를 동일한 광고 계정의 기존 광고 세트에 복제합니다 — 기본적으로 드라이런이며, 항상 PAUSED 상태로 생성되고, 명시적인 idempotency_key가 있는 경우에만 실행되므로 재시도해도 광고가 두 번 생성될 수 없습니다. zuckerbot_upload_ad_asset은 호스팅된 https URL에서 연결된 광고 계정의 라이브러리로 새로운 이미지 또는 비디오 파일을 업로드합니다(Meta가 직접 다운로드). image_hash 또는 video_id를 반환하며, 비디오가 처리될 때까지 zuckerbot_get_ad_asset_status를 폴링합니다. zuckerbot_create_ad는 그 자산으로 모든 EXISTING 광고 세트(ZuckerBot 외부에서 만든 라이브 캠페인 포함)에 하나의 새 크리에이티브 + 하나의 새 PAUSED 광고를 만듭니다. 복제와 동일하게 드라이런 우선, idempotency_key 기반 계약을 따릅니다.

ZuckerBot과 대안 비교

ZuckerBot

Pipeboard

AdAmigo.ai

Supermetrics

정의

에이전트를 위한 Meta Ads 툴킷

기본 Meta MCP

종합 광고 관리 에이전트

데이터 추출

도구 수

50+

~20

N/A (플랫폼)

N/A (커넥터)

크리에이티브 분석

✅ AI 기반

✅ 플랫폼 전용

CAPI 지원

✅ 전체 파이프라인

부분 지원

오디언스 빌더

✅ 시드 + LAL

✅ 플랫폼 전용

모든 에이전트와 호환

✅ MCP 표준

✅ MCP 표준

❌ 플랫폼에 종속

가격

무료 티어 제공

무료

$349/mo/account

$39-299/mo

가격

티어

월 비용

API 호출

도구

무료

$0

1,000/mo

읽기 전용(성과, 분석, 리서치, 계정 감사)

프로

$49 + 광고 지출의 0.1%

50,000/mo

캠페인 관리를 포함한 모든 도구

스케일

$149 + 광고 지출의 0.05%

500,000/mo

모든 도구 + 다중 계정 + 우선 순위 속도 제한

무료 티어로 시작할 수 있습니다. 프로는 최적화된 캠페인 하나만으로도 비용을 충당합니다.

API 키 받기

평생 라이선스 딜

Dealify에서 ZuckerBot 평생 라이선스를 구매하셨나요? 코드는 ZB-XXXXX-XXXXX-XXXXX 형식이며, 한 계정에 누적됩니다:

코드 수

티어

광고 계정

API 호출

1

평생 티어 1

1

2,500/mo

2

평생 티어 2

3

10,000/mo

3

평생 티어 3

10

30,000/mo

zuckerbot_redeem_license 도구("내 ZuckerBot 코드 ZB-... 사용") 또는 브라우저의 zuckerbot.ai/start.html에서 바로 코드를 사용할 수 있습니다. 코드를 사용하면 계정의 모든 API 키가 업그레이드되며, 아직 키가 없다면 하나가 생성됩니다(한 번만 표시되므로 저장하세요).

예시 대화

사용자: 이번 주 제 Meta 캠페인 성과는 어떤가요?

에이전트get_account_insights + creative_analysis 호출

에이전트: 이번 주 4개 캠페인에 $2,340을 지출했습니다. LAL 캠페인은 CPL $28로 매우 좋은 성과를 내고 있습니다 — 계정 평균보다 40% 낮습니다. 하지만 브로드 타겟팅 캠페인은 CPL $95로 예산을 태우고 있습니다. '고객 추천사' 크리에이티브는 CTR이 3.2%인 반면, 제품 이미지 크리에이티브는 1.1%입니다. 브로드 캠페인을 일시중지하고 그 예산을 LAL로 옮기는 것을 추천합니다.

사용자: 실행하세요.

에이전트pause_campaign + (예산 조정) 호출

개발

git clone https://github.com/DatalisHQ/zuckerbot.git
cd zuckerbot
npm install
npm run build
npm start

라이선스

MIT

Install Server
A
license - permissive license
A
quality
A
maintenance

Maintenance

Maintainers
Response time
5dRelease cycle
6Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI assistants to manage Facebook and Instagram advertising via the Meta Marketing API. It provides comprehensive tools for campaign lifecycle management, performance analytics, audience targeting, and creative optimization.
    15
    194
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    Provides Meta and Google Ads intelligence for AI assistants, enabling users to analyze performance, track competitors, and manage ad campaigns through natural language. It features 17 tools for generating creative concepts, scraping competitor ads, and performing deep account-level analysis.
    17
    MIT
  • -
    license
    Not graded
    quality
    Not graded
    maintenance
    Enables AI assistants to manage Facebook and Instagram advertising campaigns through the Meta Marketing API. Supports full campaign lifecycle management, performance analytics, audience targeting, and creative optimization.
  • A
    license
    Not graded
    quality
    D
    maintenance
    Comprehensive Meta Ads MCP server providing 77 tools for full campaign lifecycle management, enabling AI assistants to control Meta advertising operations through natural language.
    15
    9
    MIT

View all related MCP servers

Related MCP Connectors

  • Manage Google, Meta, Amazon, TikTok, LinkedIn & ChatGPT ads. 430 tools for campaigns & analytics.

  • 681 tools, all usable alone: ad research, video ads, publishing, campaigns. Meta, Google, TikTok.

  • Run ads on Google, Meta, LinkedIn, TikTok and more from AI. 430+ tools across 13 platforms.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/DatalisHQ/zuckerbot'

If you have feedback or need assistance with the MCP directory API, please join our Discord server