클로드 코드로 광고 계정 점검하기, claude-ads 사용법

메타나 구글 광고를 직접 돌리다 보면 늘 같은 고민이 남습니다. 돈은 매일 나가는데, 어디가 새는지 한눈에 보이지 않습니다. 대행사에 맡기기에는 규모가 작고, 혼자 보기에는 화면이 너무 많습니다.

이 글은 그런 분들을 위해 claude-ads라는 공개 스킬을 소개합니다. 스킬(클로드 코드에 특정 일을 하는 방법을 가르쳐 두는 설명서 묶음)을 설치하면, 클로드 코드에게 광고 계정 점검을 체계적으로 시킬 수 있습니다. 내용은 모두 이 스킬의 깃허브 저장소 문서와 소스 파일을 직접 읽고 확인한 것입니다. 이 글을 쓰면서 제 컴퓨터에 설치해 돌려 보지는 않았습니다. 클로드 코드를 아직 설치하지 않으셨다면 클로드 코드 시리즈 목차에서 설치 편부터 보고 오시면 됩니다.

claude-ads는 어떤 도구인가

claude-ads는 AgriciDaniel이라는 개발자가 깃허브에 공개한 클로드 코드용 스킬입니다. 저장소에 적힌 라이선스는 MIT(누구나 무료로 쓰고 고칠 수 있는 공개 라이선스)입니다. 이 글을 쓴 날(2026-09-19) 확인 기준으로 별(관심 표시)이 약 9,400개 붙어 있고, 최신 버전은 2.0.2입니다.

저장소 설명에 따르면 다루는 광고 플랫폼은 12곳입니다.

• 검색·영상·소셜: 구글 광고, 메타 광고, 유튜브 광고, 링크드인 광고, 틱톡 광고, 마이크로소프트 광고, 레딧 광고, 스냅챗 광고, X 광고
• 커머스·리테일: 애플 광고, 아마존 광고, 핀터레스트 광고

하는 일은 크게 셋입니다. 광고 계정 데이터를 받아 점검하고, 캠페인·예산·측정 계획을 세우고, 계정에 반영할 변경을 초안으로 만들어 줍니다. 결과는 JSON(프로그램이 읽는 정리된 데이터 파일)으로 먼저 남기고, 그것을 사람이 읽는 보고서로 바꿔 줍니다.

저장소는 이 도구의 대상을 대행사, 컨설턴트, 사내 광고 담당 팀으로 적고 있습니다. 그래서 기능이 꽤 무겁고 절차가 깐깐합니다. 광고비를 혼자 관리하는 1인 사업자라면 모든 기능을 다 쓸 필요는 없습니다. 점검 하나만 제대로 써도 매주 광고 관리자를 뒤지는 시간을 줄이는 데 도움이 될 수 있습니다.

설치와 광고 데이터 넣는 방법

저장소가 권하는 방법은 클로드 코드의 플러그인 설치입니다. 클로드 코드를 켠 뒤 입력창에 아래 두 줄을 차례로 입력합니다. 첫 줄은 이 저장소를 설치 목록(마켓플레이스)에 등록하고, 둘째 줄이 실제로 설치합니다.

/plugin marketplace add agricidaniel/claude-ads

/plugin install claude-ads@ai-marketing-hub-claude-ads

1. 둘째 줄을 입력하면 설치 범위를 고르는 화면이 나옵니다. 모든 폴더에서 쓰려면 사용자 범위(User scope)를 고르시면 됩니다.
2. 설치 요약에 Plugin is now active.라고 나오면 바로 쓸 수 있습니다.
3. Run /reload-plugins to activate.라고 나오면 아직 켜지지 않은 상태입니다. 클로드 코드 공식 문서에 따르면 이때 클로드 코드가 다시 불러오기를 스스로 실행합니다. 경고가 뜨면 /reload-plugins --force를 입력합니다.

플러그인으로 설치하면 명령어 앞에 플러그인 이름이 붙습니다. 저장소 문서에는 /ads audit처럼 적혀 있지만, 플러그인 설치에서는 /claude-ads:ads audit처럼 입력합니다. 저장소를 내려받아 설치 스크립트로 직접 설치한 경우에만 /ads로 시작합니다. 이 글의 표는 짧게 /ads로 적었으니, 플러그인으로 설치하셨다면 앞에 claude-ads:를 붙여 읽어 주십시오.

광고 데이터는 두 가지 길로 들어갑니다. 저장소 표현으로는 "허락받은 내보내기 파일 또는 계정 읽기"입니다.

• 내보내기 파일: 광고 관리자에서 내려받은 보고서 파일(CSV)을 넣습니다. 처음 써 보는 분께는 이쪽이 가장 안전합니다. 계정에 연결하지 않으니 계정을 바꿀 길이 처음부터 없습니다.
• 계정 읽기: 광고 플랫폼의 API나 MCP(클로드가 외부 서비스와 대화하는 연결 통로)로 계정 데이터를 읽어 오는 방식입니다. 이때 쓰는 열쇠(API 토큰)는 환경 변수나 운영체제 키체인(비밀번호 보관함)에 두라고 저장소가 정해 두었습니다. 설정 파일이나 보고서, 대화 기록에 넣지 않습니다.

명령어 한눈에 보기

저장소 README에 적힌 핵심 명령어입니다. 이 중 이 글에서 다룰 것은 점검·계획·소재·모니터링·최적화·보고 여섯 가지이고, 준비용 setup과 초안용 launch --draft도 함께 적었습니다.

명령어	하는 일	언제 쓰나
/ads setup	고객(사업), 계정, 목표 지표(KPI), 개인정보, 안전 한도 정보를 정리한 기본 설정을 만듭니다	처음 한 번. 이후 사업 정보가 바뀔 때
/ads audit [all|platform|scope]	근거를 붙여 계정을 점검합니다. 전체, 플랫폼 하나, 특정 범위를 고를 수 있습니다	처음 쓸 때, 한 달에 한 번, 성과가 갑자기 흔들릴 때
/ads plan	채널, 캠페인, 예산, 경쟁사, 측정 계획을 세웁니다	새 상품을 알리거나 예산을 새로 나눌 때
/ads create	광고 문구, 이미지, 영상, 제품 사진용 자료와 제작 지시서를 만듭니다	새 소재가 필요할 때, 기존 소재가 지쳤을 때
/ads launch --draft	계정을 건드리지 않고 캠페인 생성 계획서만 만듭니다	새 캠페인을 올리기 전 검토용
/ads monitor	예산 소진 속도, 노출, 추적, 소재 피로도, 정책, 성과를 살펴봅니다	매주 정해진 요일
/ads optimize --draft	근거가 있는 개선안을 초안으로 만듭니다	모니터링에서 손볼 곳이 보였을 때
/ads report	이미 돌린 결과(JSON)를 사람이 읽는 보고서로 바꿉니다	사장님·동업자·고객에게 공유할 때

이 밖에 실험 설계용 /ads experiment, 플랫폼 정보 갱신용 /ads research refresh, 결과 검사용 /ads validate, 현재 상태를 보는 /ads status와 /ads next가 있습니다. /ads meta, /ads google처럼 플랫폼 이름만 쓰면 그 플랫폼 점검으로 바로 넘어갑니다.

결과물은 명령을 실행한 폴더 안의 .claude-ads/runs/ 아래에 실행할 때마다 따로 쌓입니다. 점검이라면 report.md(보고서)와 action-plan.json(할 일 목록) 같은 파일이 생긴다고 문서에 적혀 있습니다.

좋은 결과인지 알아보는 기준

AI가 만든 보고서는 그럴듯해 보입니다. 그래서 읽는 쪽에 기준이 있어야 합니다. 아래 네 가지를 통과하지 못하면 결과를 믿지 말고 되물으십시오.

1. 점검 결과는 "어디"와 "얼마"를 짚어야 합니다. "타깃이 넓습니다" 같은 말은 쓸모가 없습니다. 어느 캠페인의 어느 설정이 문제인지, 그 때문에 기간 중 얼마가 쓰였는지가 붙어 있어야 합니다. 이 스킬도 발견 사항마다 근거 표시(evidence)와 확신 정도(confidence)를 달게 되어 있습니다. 근거가 비어 있으면 그 항목은 추측입니다.
2. 계획은 예산을 왜 그렇게 나눴는지 말할 수 있어야 합니다. 플랫폼별 비율만 있고 이유가 없다면 계획이 아닙니다. 저장소 규칙상 계획의 할 일마다 담당자, 시기, 성공 기준, 되돌릴 조건이 붙어야 합니다. 빠져 있으면 채워 달라고 하십시오.
3. 소재 제안은 각도가 서로 달라야 합니다. 같은 말을 단어만 바꾼 다섯 개는 한 개와 같습니다. 가격을 앞세운 안, 불편을 짚는 안, 후기를 보여 주는 안처럼 설득 방향이 달라야 시험해 볼 가치가 있습니다. 저장소도 "겉만 바꾼 문구가 아니라 전략이 다른 안"을 만들라고 정해 두었고, 없는 후기·자격·가격·성과를 지어내지 말라고 적었습니다.
4. 보고서는 다음 주에 내릴 결정으로 끝나야 합니다. 지난주 숫자를 예쁘게 정리한 것만으로는 부족합니다. "이 광고 세트는 한 주 더 두고 본다", "이 소재는 쉬게 한다"처럼 결정할 일과 확인할 날짜가 마지막에 남아야 합니다.

하나 더 있습니다. 데이터가 부족하면 "모름"이라고 말하는 결과가 좋은 결과입니다. 이 스킬은 판단할 수 없는 항목을 unknown으로 남기고, 데이터가 모자란 플랫폼은 "부분 점검(partial)"이나 "근거 부족"으로 표시하게 되어 있습니다. 모든 항목에 자신 있게 답한 보고서가 오히려 의심할 대상입니다.

안전 규칙 — 가장 중요합니다

이 도구는 기본이 읽기 전용이고, 계정을 바꾸는 명령도 기본값이 초안입니다. 저장소의 기능 목록 파일(capability manifest)을 보면 2026년 9월 현재 12개 플랫폼 모두 계정 변경 기능이 꺼짐(disabled)으로 적혀 있습니다. 영구 삭제는 요청해도 거절하게 되어 있습니다. 그래도 도구의 안전장치에만 기대지 말고 쓰는 사람이 규칙을 정해 두어야 합니다. 저는 아래 다섯 가지를 권합니다.

1. 돈이 나가는 권한은 주지 않습니다. 계정을 연결하더라도 보고서를 읽는 권한까지만 줍니다. 수정 권한은 주지 않습니다.
2. 바꾸는 일은 초안만 받고, 누르는 건 사람이 합니다. launch와 optimize는 --draft로만 씁니다. 초안을 읽고 납득한 것만 광고 관리자에서 직접 반영합니다.
3. 새로 만드는 캠페인은 일시중지 상태로 시작합니다. 초안대로 만들더라도 켜기 전에 예산, 기간, 대상, 연결 페이지를 한 번 더 확인합니다.
4. 첫 달은 매주 실제 변경 기록을 봅니다. 광고 관리자에서 변경 기록을 볼 수 있는 화면(플랫폼마다 이름이 다릅니다)을 열어 이번 주에 무엇이 바뀌었는지, 모두 내가 한 일인지 확인합니다. 내가 모르는 변경이 하나라도 있으면 그 자리에서 멈춥니다.
5. 권한을 넓히기 전에 "최악의 경우"를 말할 수 있어야 합니다. 이 권한을 주면 가장 나쁘게 무슨 일이 생길 수 있는지, 하루 동안 최대 얼마가 나갈 수 있는지 스스로 답하지 못한다면 아직 넓힐 때가 아닙니다.

이번 주에 해 볼 한 가지: 점검만 돌리고 읽기

처음부터 계정을 연결하지 마십시오. 내려받은 파일 하나로 점검만 해 보는 것이 시작으로 알맞습니다.

1. 바탕화면에 새 폴더를 하나 만듭니다. 예: 광고점검
2. 광고 관리자에서 지난 몇 주치 캠페인 보고서를 CSV로 내려받아 그 폴더에 넣습니다. 고객 명단이나 연락처가 든 파일은 넣지 않습니다.
3. 그 폴더에서 클로드 코드를 실행합니다. 폴더에서 실행하는 방법은 시리즈 목차의 첫 실행 편에 있습니다.
4. 입력창에 아래처럼 입력합니다. 메타 광고라면 이렇게 씁니다.

   /claude-ads:ads audit meta

5. 업종, 목표, 전환(구매·문의 같은 목표 행동)의 뜻, 기간을 물어보면 아는 만큼 답합니다. 모르는 것은 모른다고 답하셔도 됩니다.
6. 끝나면 보고서를 열어 위의 네 가지 기준으로 읽기만 합니다. 이번 주에는 아무것도 바꾸지 않습니다.

궁금한 항목은 그 자리에서 되물으시면 됩니다. 아래처럼 물으면 근거를 확인하기 좋습니다.

이 발견 사항은 내 파일의 어느 캠페인, 어느 숫자를 보고 판단한 거야? 근거가 없으면 없다고 말해 줘.

결과에 점수가 보이지 않을 수 있습니다. 같은 기능 목록 파일에 계정 건강 점수 기능이 아직 꺼짐으로 적혀 있기 때문입니다. 이 경우 발견 사항만 나오고 점수는 매기지 않는 것이 정상입니다. 버전이 바뀌면 달라질 수 있습니다.

자주 묻는 질문

함께 보면 좋은 글

• 클로드 코드 왕초보 시리즈 전체 목차 — 설치, 첫 실행, 안전하게 쓰는 법

참고: claude-ads 깃허브 저장소 · 클로드 코드 공식 문서 — 플러그인 찾기와 설치