imrenagicom/adsctl

어떤 프로젝트인가요?

핵심 기능

• 01AI 에이전트와 셸 스크립트에 적합한 버전 관리 JSON 봉투 형식으로 기본 출력합니다.
• 02광고 쓰기 작업에 명시적인 프로필 및 계정 범위를 요구하고 드라이런 미리보기를 제공합니다.
• 03Meta 액세스 토큰을 외부 파일이나 환경 변수에서 읽으며, 값을 설정 파일에 저장하지 않습니다.
• 04네이티브 Insights 쿼리, 비동기 작업, 요약, 순위와 CSV/JSONL 내보내기를 제공합니다.
• 05결정론적인 읽기 전용 모니터링 규칙을 실행하고 계정 스냅샷 간 변경 사항을 보고합니다.
• 06상태 저널과 조정 기능을 통해 여러 단계의 캠페인 시작 작업을 재개할 수 있도록 지원합니다.

활용 사례

• AI 에이전트가 캠페인 성과 보고서를 가져오고 게재 문제를 표시하도록 합니다.
• CI나 cron에서 읽기 전용 계정 점검을 예약하고, 발견 사항이 있으면 작업을 실패 처리합니다.
• 스크립트로 여러 고객 광고 계정의 광고를 일괄 일시 중지하거나 예산을 조정합니다.
• 자동화 파이프라인에서 Instagram 게시물, Reels 또는 캐러셀을 게시합니다.

빠른 시작

1. 1

   README의 공식 설치 스크립트를 실행합니다

2. 2

   PATH 설정을 셸에 불러옵니다

   source "$HOME/.adsctl/env"
3. 3

   CLI가 실행되는지 확인합니다

   adsctl version

사용 전 알아둘 점

• !현재는 Meta 광고만 구현되어 있으며, Google은 향후 추가될 어댑터입니다.
• !Meta 개발자 앱을 직접 만들고 액세스 토큰을 직접 제공해야 합니다. CLI는 OAuth를 처리하지 않습니다.
• !Windows에서는 상시 실행 및 모니터 실행을 지원하지 않습니다.

포함된 컬렉션

토픽

자주 묻는 질문

adsctl은(는) 무엇인가요?

광고 계정을 조회·모니터링·보고하고 Meta 캠페인을 시작하는 AI 에이전트용 Go CLI로, JSON 출력과 명시적인 계정 범위를 지원합니다. adsctl은 광고 계정을 다루는 Go 및 Cobra 기반 명령줄 도구입니다. 첫 지원 플랫폼은 Meta(Facebook 및 Instagram 광고)이며, Google 어댑터도 계획되어 있습니다. 기본적으로 JSON을 반환하고, 쓰기 작업에는 계정 범위를 명시해야 합니다. 자격 증명은 설정 파일에 저장하지 않고 외부 토큰 파일이나 환경 변수에서 읽습니다.

adsctl은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

adsctl은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

adsctl은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. adsctl의 마지막 커밋은 2026년 11월 5일입니다.

adsctl은(는) 어디에 사용할 수 있나요?

AI 에이전트가 캠페인 성과 보고서를 가져오고 게재 문제를 표시하도록 합니다. CI나 cron에서 읽기 전용 계정 점검을 예약하고, 발견 사항이 있으면 작업을 실패 처리합니다. 스크립트로 여러 고객 광고 계정의 광고를 일괄 일시 중지하거나 예산을 조정합니다. 자동화 파이프라인에서 Instagram 게시물, Reels 또는 캐러셀을 게시합니다.

adsctl는 어떻게 설치하나요?

README의 공식 설치 스크립트를 실행합니다 PATH 설정을 셸에 불러옵니다: source "$HOME/.adsctl/env" CLI가 실행되는지 확인합니다: adsctl version

adsctl은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/imrenagicom/adsctl