adyou — ADYou 코어 · CLI · MCP

ADYou — 대행사 없이, 당신이 직접. 광고를 24시간 집행하고 통제하세요. https://adyou.ai

adyou는 ADYou 웹(https://adyou.ai)이 쓰는 코어 엔진이면서, 개발자·마케터가 터미널이나 Claude Code·Cursor 같은 MCP 클라이언트에서 같은 일을 직접 할 수 있는 CLI + MCP 서버입니다.

사이트 주소와 한 달 예산만 주면 — 사이트를 읽고 브리프를 만들고 · 소재(이미지 12규격 × 3방향 + 문구)를 만들고 · Meta(페이스북·인스타그램)·Google에 광고를 전부 대기 상태(PAUSED · 노출 안 됨) 로 등록하고 · 미리보기를 보여 주고 · 당신이 승인하면 시작하고 · 한 시간마다 숫자를 보고 정해진 규칙대로 조정하고 · 매주 쉬운 말로 보고합니다.

• 광고 계정은 당신 계정(직광고). 매체비는 어디도 거치지 않고 대행 수수료가 없습니다.
• 광고 시작 전엔 1원도 나가지 않습니다. 예산은 계정 통화 최소 단위로 환산하고 월 상한을 코드로 재확인합니다.
• 자동 운영은 정확히 다섯 가지만: 시작 뒤 48시간 무변경 · 노출 2,000 이상 광고끼리만 비교 · 꼴등이 1등보다 1.8배 나쁘면 끔(매체마다 1개 남김) · 매체 하루 예산 ±20%(월 상한 안) · 잔액 이틀치 미만이면 멈춤. 모든 조치는 이유와 함께 기록됩니다.

설치

npm i -g adyou
adyou init            # 매체 연결 가이드 + 검사기

Node 20 이상. 브라우저·파이썬 불필요(이미지 합성은 satori + resvg). adpilot 명령도 같은 바이너리를 가리킵니다(옛 이름 호환).

5분 흐름

adyou connect meta --token <시스템 사용자 토큰> --account act_… --page <페이지 id> [--pixel <픽셀 id>]
adyou connect google --sa <서비스계정.json> --customer <10자리 고객 ID>
adyou check                                   # 토큰 스코프·계정 통화·픽셀 트래픽 권한·구글 액세스 수준·랜딩 태그·UTM 보존 실측
adyou brief https://example.com --budget 300만 --goal signup [--markets KR,US]
adyou creatives                               # 방향 3 × 이미지 12규격 + 문구 + 규격 검사 → 갤러리 HTML
adyou plan                                    # 예산 분할을 쉬운 말로
adyou build [--validate]                      # 전부 PAUSED 생성 · 멱등 · 부분 실패 재실행 안전
adyou preview --open                          # 메타 실제 미리보기 · 구글 근사
adyou launch                                  # 승인 → ACTIVE(광고 시작)
adyou status | optimize [--apply] | report --open | change "예산 200만원으로, 미국 빼"
adyou audit                                   # 기존 캠페인 전수 조회·진단(인수)
adyou track install | verify                  # 픽셀·gtag·GA4 스니펫 발급 · 랜딩 검증

MCP

{ "mcpServers": { "adyou": { "command": "npx", "args": ["-y", "adyou", "mcp"] } } }

Claude Code·Cursor·bizcoder에서 「우리 사이트 광고 미국에 월 200만원으로 시작해」 한 문장이 곧 브리프 → 소재 → 계획 → 생성(PAUSED) → 미리보기. 시작(adyou_launch)은 사용자가 명시적으로 승인했을 때만 호출됩니다. 툴 이름은 adyou_*.

웹 SaaS — https://adyou.ai

가입해 사이트 주소·예산만 넣으면 같은 엔진이 웹에서 돌아갑니다(광고 계정 없이 ADYou 계정으로 집행 · 잔액 충전 · 수수료 매체비의 10%, 또는 내 계정 연결 · 수수료 0). 웹은 이 패키지를 npm으로만 소비합니다. 체험 계정으로 미리 볼 수 있습니다: https://adyou.ai/demo · 도움말 https://adyou.ai/help

매체 연결(사람이 해야 하는 것)

• Meta: 비즈니스 포트폴리오 · 광고 계정 · 결제수단 · 페이지 · 앱(Marketing API · 라이브 모드) · 시스템 사용자(관리자) 토큰(ads_management · ads_read · business_management · pages_show_list · pages_read_engagement · pages_manage_ads) · 픽셀 트래픽 권한 도메인.
• Google: 광고 계정(통화·결제수단) · GCP 프로젝트에 Google Ads API 사용 설정 · 서비스 계정 JSON · 광고 계정에 서비스 계정 초대(표준) · Google Ads API 액세스 수준 Explorer. 개발자 토큰은 더 이상 필요 없습니다. adyou check가 전부 실측해서 어느 화면에서 무엇을 누를지 알려 줍니다.

안전장치

생성은 항상 PAUSED · ACTIVE는 launch 뒤에만 · 돈 환산은 core/money.ts 한 곳 · 월 상한 withinCap · 모든 mutate는 decisions.jsonl(웹은 decisions 테이블)에 남습니다. 매체 함정(RDA 한글 2자 · DCO 광고 1개 · Advantage+ age_max 불가 · end_date_time 23:59:59 · validate_only 본문 · 픽셀 트래픽 권한 · 앱 라이브 모드)은 어댑터 주석에 박혀 있습니다.

로컬 상태

~/.adpilot/(자격 0600 · 프로젝트별 project.json · decisions.jsonl). 폴더 이름은 호환을 위해 그대로입니다.

개발

npm i && npm run build && npm test        # unit + mock e2e
npm run test:live                          # 읽기 전용 라이브 검사

라이선스 · 문의

AI3 Inc. · [email protected]