🍚 깃밥 PRO가 열렸어요 — 월 3,900원 · 알아보기 →
kLOsk/adloop

Google Ads와 GA4를 AI 어시스턴트에 연동하는 MCP 서버 — 쓰기 권한과 안전 가드레일 포함

설치형 도구맘대로 써도 됨 · MIT마케팅·그로스Python난이도
2730 찜
63포크10이슈
데모·홈페이지 열기getadloop.com

중간맛 분석

스택: Python 3.11+, MCP(Model Context Protocol), Google Ads v23, GA4 Data , Google Manager , 선택사항으로 Search Console·Merchant Center .

난이도: 중상(5단계 중 3) — pip install adloop && adloop init 한 번이면 되지만, Google Cloud 프로젝트 생성과 개발자 토큰 발급 단계가 필요합니다. 클라우드 버전이면 설정이 2분으로 단축됩니다.

바로 쓸 수 있는가: 네. 67개 도구가 즉시 작동하며, Claude Code·Cursor·Claude Desktop·로컬 MCP 클라이언트에 연결 가능합니다.

데모: AdLoop 클라우드(getadloop.com)에서 Google 연동 후 claude.ai나 ChatGPT에서 "검색 광고 성과 분석"·"네거티브 키워드 추가" 같은 요청을 즉시 실행할 수 있습니다.

이런 레포예요

이럴 때 쓰면 좋아요

  • 광고 성과 분석 시 Ads 클릭 수·GA4 전환·GDPR 동의율을 한 번에 비교하여 문제 원인 파악
  • AI와의 대화 속에서 네거티브 키워드 추가·광고 그룹 생성·입찰가 조정을 미리보기와 함께 실행
  • 코드베이스 이벤트·GTM 태그·GA4 실제 발생 데이터를 3방향 감사하여 추적 누락·비활성 태그·페이지 범위 필터 문제를 찾기

핵심 기능

Google Ads + GA4 자동 크로스 참조 (클릭→세션→전환 조인, GDPR 동의 자동 보정)코드베이스·GTM·GA4 3방향 추적 감사(audit_event_coverage)로 추적 누락 찾기draft → preview → confirm 워크플로우로 AI 실수로 인한 광고비 낭비 방지

대안 대비 차별점

별개의 Ads·GA4 도구를 수동으로 호출하는 대신, 두 API를 자동으로 조인하여 단일 응답을 돌려주며, GTM 태그·코드베이스·GA4 이벤트를 3방향으로 매칭하는 추적 감사 기능은 다른 도구에 없습니다.

먹어본 사람들

실제로 차려 먹어본 손님들의 흔적이에요 — 한마디와 완주 인증 모두 검수 후 공개돼요.

시식평 · 먹어본 사람 한마디

아직 시식평이 없어요. 먹어보셨다면 첫 한마디를 남겨주세요.

다른 레포 시식평 구경하기 →

이 레포로 만든 것들

🖋 완주 인증하기

아직 이 레포로 만든 완주 인증이 없어요. 첫 밥도장을 찍어보세요!

이 레포, 해먹는 법

처음 오셨어요? 어렵지 않아요 — 위에서 아래로 따라 하면 내 컴퓨터에 이 레포를 차려서 바로 맛볼 수 있어요.

준비물

  • Python 3.11 이상
  • Google Ads 계정 및 MCC(Manager Account)
  • Google Ads 개발자 토큰
  • Google Cloud 프로젝트(자신의 OAuth 클라이언트용)

바로 차려먹기Python (uv)

깃밥이 레포 구조를 확인하고 만든 실행 명령이에요. 터미널에 붙여넣으면 받기부터 실행까지 한 번에 진행돼요.

git clone --depth 1 https://github.com/kLOsk/adloop.git &&
cd adloop &&
uv sync

uv가 없다면: brew install uv · 실행 명령은 README를 확인하세요.

코드는 내 컴퓨터에서 실행돼요 — 처음 보는 레포라면 내용을 한번 훑어보고 실행하는 습관을 추천해요.

README가 안내하는 자세한 단계 보기
  1. adloop 설치
pip install adloop
  1. 초기화 위저드 실행 (Google Cloud 프로젝트 생성·개발자 토큰 입력·OAuth 로그인을 자동으로 안내)
adloop init
  1. 설치 확인 (OAuth·GA4·Ads 연결 테스트)
adloop health_check
  1. Cursor 또는 Claude Code에 MCP 설정 추가 (위저드가 설정 스니펫을 출력하므로 에디터 config에 붙여넣기)

소스에서 설치할 경우:

git clone https://github.com/kLOsk/adloop.git
cd adloop
uv sync
uv run adloop init

깃밥트라이로 맛보기

받아보기 귀찮고 살짝 불안했다면 — 안전 스캔부터 설치까지 터미널 한 줄로 끝나요.

터미널에 붙여넣으면 깃밥 안전 스캔 → 격리 폴더 clone → 설치 → 실행법 안내까지 자동이에요. 처음이어도 괜찮아요 — 이 한 줄이 전부예요.

npx gitbap-try kLOsk/adloop

Node.js만 있으면 설치 없이 실행돼요 · 깃밥트라이가 뭐예요? →

이걸로 써먹는 법

맛봤다면 이제 써먹을 차례 — 이 레포를 내 일과 사업에 응용하는 방법을 모아뒀어요.

🍳 레시피 — AI에게 이대로 시켜보세요

레시피 불러오는 중…

별 추이 · 7일

2737일 증가분은 비교 데이터가 부족해요

확인 시각

활용성 · 따라 만들기 좋은가

따라 하기 좋음샘플 점수 52/100
  • 관대한 라이선스
  • 테스트 있음
  • 예제 디렉토리
  • 최근 활동
  • AGENTS.md
  • llms.txt
  • 템플릿

🟢 최근 활동 있음 · 2026년 생성

「마케팅·그로스」 이런 레포, 매주 받아보실래요?

매주 월요일 아침, 골라 담은 밥상만. 광고 없이 · 언제든 해지.

내 레포인가요? README에 깃밥 배지 달기
[![깃밥](https://www.gitbap.com/badge/kLOsk/adloop.svg)](https://www.gitbap.com/r/kLOsk/adloop)
🔌 클로드에서 바로 써보기 — 깃밥 연결하는 법

깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.

방법 ① 커넥터 URL

클로드 설정 → 커넥터에 이 주소를 붙여넣기.

https://www.gitbap.com/api/mcp
방법 ② 플러그인 (체험까지)

플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.

/plugin marketplace add jakeparkcolde/gitbap-cowork
/plugin install gitbap-cowork@gitbap
연결 방법 자세히 →

AI가 README 기반으로 요약했습니다 · 원문 보기