PropellerAds MCP 서버

AI를 통한 프로그래매틱 광고의 대중화

Claude와 같은 AI 어시스턴트가 PropellerAds의 광고 캠페인을 자동으로 관리하게 하세요.

빠른 시작 • 사용 가능한 도구 • 사용 예시 • MCP 설정

이것은 무엇인가요?

PropellerAds MCP는 AI 어시스턴트(Claude 및 모든 MCP 호환 클라이언트)를 PropellerAds 광고 플랫폼 API에 직접 연결하는 모델 컨텍스트 프로토콜(Model Context Protocol) 서버입니다. 대시보드에 수동으로 로그인하고, 보고서를 추출하고, 설정을 클릭하는 대신, AI 어시스턴트에게 평범한 언어로 말하기만 하면 모든 것을 처리해 줍니다.

자연스러운 대화를 통해 캠페인 생성, 성과 분석, 실적이 저조한 존(zone) 블랙리스트 등록, 확장 기회 탐색, 기간 비교 등을 수행하세요.

대상:

• 미디어 바이어 및 퍼포먼스 마케터

• iGaming 및 앱 설치 제휴 마케터

• 그로스 해커 및 디지털 에이전시

• 더 빠르게 작업하고자 하는 PropellerAds 캠페인 운영자

주요 기능

• 전체 캠페인 수명 주기 -- 채팅을 떠나지 않고 캠페인 생성, 업데이트, 시작, 중지 및 복제

• 실시간 성과 분석 -- 노출, 클릭, 전환, CTR, CVR, CPC, CPA 및 ROI 자동 계산

• 기간별 비교 -- 추세 지표와 함께 두 기간을 나란히 비교

• 존(Zone) 단위 최적화 -- 예산을 낭비하는 저성과 존을 찾고 화이트리스트에 추가할 가치가 있는 상위 존 식별

• 자동 블랙리스트 등록 -- 불량 존을 식별하고 블랙리스트에 등록하는 단일 명령(드라이런 안전 모드 포함)

• 확장 지능 -- ROI와 전환율이 높아 확장이 가능한 캠페인을 자동으로 탐색

• 크리에이티브 성과 분석 -- 어떤 크리에이티브가 성과를 내고 어떤 것을 교체해야 하는지 확인

• 보안 설계 -- API 토큰은 환경 변수에 저장되며 대화 중에 노출되지 않음

• 드라이런 안전성 -- 파괴적인 작업은 실행 전 미리보기 모드를 기본값으로 설정

사용 가능한 도구

캠페인 관리

list_campaigns용 필터: status(active/paused/pending/rejected), ad_format(push/onclick/interstitial/in-page-push), name(부분 일치)

통계 및 분석

일반적인 선택적 매개변수: date_from, date_to(YYYY-MM-DD, 기본값은 최근 7일), campaign_id, group_by(date/campaign/zone/country/creative/device_type/browser/os)

최적화

타겟팅

계정

기술 스택

빠른 시작

사전 요구 사항

1. PropellerAds 계정 (API 액세스 권한 필요)

   • 최소 요구 사항: 총 지출 또는 입금액 $1,000 이상

   • API 토큰 발급: https://ssp.propellerads.com/#/app/profile

2. Python 3.10+

3. Claude Desktop 또는 Claude Code (또는 MCP 호환 클라이언트)

설치

옵션 1: PyPI에서 설치 (권장)

pip install propellerads-mcp

옵션 2: 소스에서 설치

git clone https://github.com/JanNafta/propellerads-mcp.git
cd propellerads-mcp
pip install -e .

API 토큰 설정

프로젝트 루트에 .env 파일을 생성하거나 환경 변수를 내보내세요:

export PROPELLERADS_API_TOKEN="your_api_token_here"

사용 예시

캠페인 관리

"Show me all my active campaigns sorted by ROI"

"Create a push campaign for gaming offers in Brazil with $100 daily budget"

"Pause all campaigns with negative ROI in the last 7 days"

"Clone my best performing campaign to Mexico, Colombia, and Peru"

성과 분석

"What's my campaign performance for the last week?"

"Compare this week's performance vs last week"

"Show me the top 10 zones by conversions for campaign 12345"

"Which creatives have CTR below 0.5%?"

최적화 워크플로우

"Find all zones spending over $50 without conversions and blacklist them"

"Show me campaigns ready for scaling -- ROI above 50% with at least 10 conversions"

"Find top performing zones for my dating campaigns and add them to a whitelist"

일일 최적화 루틴

1. "Show me yesterday's performance for all campaigns"
2. "Find and blacklist underperforming zones across all campaigns"
3. "Which campaigns are ready for scaling?"
4. "Increase budget by 50% for profitable campaigns"

MCP 설정

Claude Desktop

Claude Desktop 설정 파일에 추가하세요:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "propellerads": {
      "command": "python",
      "args": ["-m", "propellerads_mcp"],
      "env": {
        "PROPELLERADS_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

설정을 저장한 후 Claude Desktop을 다시 시작하세요.

Claude Code

CLI를 사용하여 Claude Code에 MCP 서버를 추가하세요:

claude mcp add propellerads -- python -m propellerads_mcp

Claude Code를 실행하기 전에 셸 환경에 PROPELLERADS_API_TOKEN이 설정되어 있는지 확인하세요.

기타 MCP 클라이언트

이 서버는 표준 MCP 통신 방식인 stdio 전송을 사용합니다. 모든 MCP 호환 클라이언트는 프로세스를 생성하여 연결할 수 있습니다:

python -m propellerads_mcp

서버는 환경에서 PROPELLERADS_API_TOKEN을 읽습니다. MCP 클라이언트의 env 설정을 통해 전달하거나 셸에서 설정하세요.

프로젝트 구조

propellerads-mcp/
├── src/
│   └── propellerads_mcp/
│       ├── __init__.py       # Package init, version, exports
│       ├── __main__.py       # Module entry point (python -m)
│       ├── client.py         # PropellerAds API client (httpx-based)
│       └── server.py         # MCP server, tool definitions & handlers
├── .env.example              # Environment variable template
├── .gitignore
├── LICENSE                   # MIT License
├── pyproject.toml            # Build config, dependencies, metadata
└── README.md

보안 및 권한

기여하기

기여를 환영합니다! 다음과 같이 도울 수 있습니다:

1. 포크(Fork) 저장소

2. 기능 브랜치 생성 (git checkout -b feature/my-feature)

3. 변경 사항 커밋 (git commit -m "Add my feature")

4. 브랜치 푸시 (git push origin feature/my-feature)

5. 풀 리퀘스트(Pull Request) 열기

버그 및 기능 요청은 이슈를 열어주세요.

작성자

Jan Naftanaila -- 미디어 바이어 & AI 자동화 전문가

AI와 프로그래매틱 광고 사이의 격차를 해소하는 도구를 구축합니다. 애드테크를 접근 가능하고 자동화되며 지능적으로 만드는 데 집중하고 있습니다.

라이선스

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 LICENSE 파일을 참조하세요.

PropellerAds MCP -- 오픈 소스. 프로그래매틱 광고 커뮤니티를 위해 구축되었습니다.