Meta ads cli

Skill ai-native-engineer/astack/skills/meta-ads-cli

Meta Facebook/Instagram ads CLI workflow for campaign/adset/ad/creative CRUD, insights, breakdowns, pixels, conversion tracking, catalogs, and page lookup. Use when user asks 메타 광고, 페이스북/인스타 광고, Meta ads, campaign/adset/ad/creative, 광고 성과/인사이트, ROAS/CTR/CPC, pixel, catalog, or ad automation. Do NOT use for Google Ads, organic social posting, general marketing strategy, SimilarWeb traffic, or non-Meta analytics.From its SKILL.md

Install

npx -y skills add ai-native-engineer/astack --skill meta-ads-cli

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

SKILL.md

3.5 KB, as published. Nobody here has run it

Meta Ads CLI (`meta`)

meta는 Meta Marketing API의 개발자 친화 래퍼다. 명령 형태: meta [전역옵션] ads <resource> <action> [옵션] (인증만 meta auth <action>).

전체 옵션·서브커맨드는 meta <명령> --help가 단일 권위 소스다. 이 파일은 거의 모든 작업에 깔리는 코어 모델만 담는다. 구체 명령·enum·워크플로는 아래 references를 그때그때 읽는다.

코어 멘탈 모델

리소스 계층: campaign ⊃ adset ⊃ ad. ad는 creative를 --creative-id로 참조(creative는 독립·재사용 객체). list는 상위 ID로 필터(adset list <CAMPAIGN_ID>, ad list <ADSET_ID>).
생성 순서: campaign → adset → creative → ad. ad가 adset·creative를 묶으므로 creative를 ad보다 먼저 만든다.
모든 리소스는 기본 PAUSED로 생성된다(노출·과금 없음). 게시는 update --status ACTIVE를 campaign·adset·ad에 각각 — 이때부터 비용 발생.
삭제는 cascade: campaign 삭제 → 하위 adset·ad 동반, adset 삭제 → 하위 ad 동반.
금액 단위는 통화의 minor unit: USD는 cents(--daily-budget 5000 = $50.00), 단 KRW·JPY 등은 자국 기본 단위(17208 = 17,208원). insights spend도 같은 규칙 — adaccount list의 currency로 확인 후 해석.
설정 우선순위(높은 순): CLI 플래그(--ad-account-id) > 셸 환경변수 > .env(find_dotenv로 cwd부터 상위 탐색 — 실행 디렉토리 밖은 안 봄). 필수 키: ACCESS_TOKEN, AD_ACCOUNT_ID.
- 토큰만 user-level fallback이 있다: ~/.config/meta/credentials = 토큰 문자열 그 자체(plain text, JSON·key=value 아님). ~/.config/meta/.env는 안 읽힌다(저장법 → setup-guide).
- AD_ACCOUNT_ID는 글로벌 저장소가 없다: 셸 env(~/.zshrc에 export)나 cwd .env로만. 어디서나 쓰려면 export.
- BUSINESS_ID는 catalog/dataset에서 ad account로부터 자동 해결(필요 시 명시).
출력 형식: --output table|json|plain — 전역 플래그라 서브커맨드 앞에 둔다(meta --output json ads campaign list). 스크립트는 json(jq) 또는 plain(cut/awk).

안전 규칙

ACTIVE 전환·실예산 변경·실삭제는 사용자 명시 승인 없이 실행하지 않는다(과금·비가역).
동작만 검증할 땐 create(기본 PAUSED) → 확인 → delete --force. PAUSED라 비용 0.

어디를 읽나

필요	읽을 곳
설치·시스템 사용자 토큰 발급·`.env` 구성 (최초 1회)	`references/setup-guide.md`
리소스별 명령·필수 옵션·enum 값(objective/optimization-goal/CTA 등)	`references/commands.md`
실전 워크플로: 캠페인 end-to-end 생성·전환추적 셋업·성과 분석·스크립트 자동화·exit code	`references/recipes.md`

공식 문서(전체 레퍼런스의 권위 소스): https://developers.facebook.com/documentation/ads-commerce/ads-ai-connectors/ads-cli