분석, 크리에이티브, 리드 생성 폼을 포함한 LinkedIn Marketing API 데이터를 쿼리하기 위한 강력한 읽기 전용 명령줄 인터페이스입니다.
설치 및 다운로드
1. ClawHub CLI
레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.
npx clawhub@latest install linkedin-ads-cli
2. 수동 설치
스킬 폴더를 다음 위치 중 하나로 복사하세요
~/.openclaw/skills/ <project>/skills/ 우선순위: 워크스페이스 > 로컬 > 번들
3. 프롬프트 설치
이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.
Clawhub를 사용해서 linkedin-ads-cli 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).
다운로드를 원하시나요?
ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.
LinkedIn Ads CLI란 무엇인가요?
LinkedIn Ads CLI 스킬은 개발자와 마케터가 LinkedIn Marketing API(버전 202603)와 상호작용할 수 있는 강력한 인터페이스를 제공합니다. 이는 Openclaw Skills 생태계 내의 전문 도구로, 광고 계정 구조, 성과 지표, 타겟 데이터에 대한 읽기 전용 액세스를 위해 설계되었습니다. 이 스킬을 사용하면 사용자는 표준 웹 인터페이스를 탐색할 필요 없이 프로그래밍 방식으로 조직, 캠페인 그룹, 개별 크리에이티브를 탐색할 수 있습니다.
이 도구는 피벗 분석을 통해 상세한 분석 데이터를 추출하거나 복잡한 타겟팅 요소를 검사해야 하는 데이터 중심 팀에게 특히 유용합니다. LinkedIn 엔터티 계층 구조와의 깊은 통합을 지원하여 계정 수준 개요와 특정 캠페인 심층 분석 간의 원활한 전환이 가능합니다. 광고 비용을 감사하든 리드 폼 제출을 검색하든, 이 스킬은 LinkedIn 광고 관리의 기술적 워크플로우를 간소화합니다.
LinkedIn Ads CLI 활용 사례
- 주간 LinkedIn 광고 성과 스냅샷 및 보고서 자동화.
- 상세한 일별 또는 월별 피벗을 사용하여 캠페인 성과에 대한 심층 감사 수행.
- 고성과 광고 콘텐츠를 식별하기 위한 크리에이티브 수준 지표 검토.
- CRM 통합 또는 분석을 위한 리드 생성 폼 제출 데이터 내보내기.
- 향후 계획을 위한 광고 전달 예측 및 LinkedIn 예산 권장 사항 검색.
- 계정 액세스 및 조직 수준 권한 감사.
LinkedIn Ads CLI 작동 원리
- ID 확인: 이 스킬은 me 및 organization-acls 명령을 사용하여 인증된 사용자와 해당 조직을 식별하는 것으로 시작합니다.
- 계정 검색: 분석에 필요한 특정 엔터티를 찾기 위해 사용 가능한 광고 계정을 나열합니다.
- 데이터 쿼리: 이 스킬은 사용자의 의도에 따라 특정 명령(예: campaigns, creatives, analytics)을 실행하고 날짜 범위나 상태와 같은 필터를 적용합니다.
- 피벗 분석: 성과 요청의 경우 CAMPAIGN 또는 CREATIVE와 같은 피벗 차원을 적용하여 노출수, 클릭수, 비용과 같은 지표를 세분화합니다.
- 응답 포맷팅: CLI는 구조화된 JSON 데이터를 반환하며, 이를 파싱하여 사용자에게 실행 가능한 인사이트나 시각적 요약을 제공합니다.
LinkedIn Ads CLI 설정 가이드
Openclaw Skills 내에서 이 LinkedIn Ads 통합을 사용하려면 CLI가 설치 및 인증되었는지 확인하십시오:
# CLI 전역 설치
npm install -g linkedin-ads-cli
# 설치 확인 및 도움말
linkedin-ads-cli --help
인증:
r_ads, r_ads_reporting, r_organization_social 범위(scope)가 포함된 LinkedIn OAuth2 Bearer token을 제공해야 합니다. LINKEDIN_ADS_ACCESS_TOKEN 환경 변수를 통해 설정하거나 ~/.config/linkedin-ads-cli/credentials.json에 구성 파일을 생성하여 설정할 수 있습니다.
LinkedIn Ads CLI 데이터 스키마 및 분류 체계
이 스킬은 LinkedIn 엔터티 계층 구조와 상호작용하며 구조화된 JSON 형식으로 데이터를 반환합니다. 주요 엔터티는 다음과 같습니다:
| 엔터티 | URN 형식 | 설명 |
|---|---|---|
| 광고 계정 | urn:li:sponsoredAccount:ID |
모든 광고 활동을 위한 기본 컨테이너. |
| 캠페인 그룹 | urn:li:sponsoredCampaignGroup:ID |
예산/상태 관리를 위해 관련 캠페인을 그룹화하는 데 사용. |
| 캠페인 | urn:li:sponsoredCampaign:ID |
타겟팅 및 예산을 포함하는 개별 광고 세트. |
| 크리에이티브 | urn:li:sponsoredCreative:ID |
사용자에게 표시되는 실제 광고 콘텐츠. |
| 리드 생성 폼 | urn:li:leadGenForm:ID |
LinkedIn에서 직접 사용자 데이터를 수집하는 데 사용되는 폼. |
모든 통화 값은 costInLocalCurrency 및 costInUsd 필드에서 십진수 문자열(예: "244.85000")로 반환됩니다.
LinkedIn Ads CLI 고급 기능
- 대규모 데이터 세트를 위한 토큰 기반 및 오프셋 기반 페이지네이션 지원.
- 페이로드 크기를 줄이고 KPI에 집중하기 위한 분석의 사용자 지정 지표 필드 선택.
- 사전 예방적 계정 관리를 위한 자동화된 예산 권장 사항 및 전달 예측.
- 매칭된 타겟(DMP 세그먼트)과 실시간 캠페인 타겟팅 간의 교차 참조.
- 유연한 명령 실행을 위해 숫자 ID와 전체 URN 문자열 모두 지원.
SKILL.md
로드 중
관련 Openclaw 스킬
Microsoft Ads CLI
캠페인 통계, 잠재고객 인사이트, 전환 목표를 포함한 Bing Ads API v13 데이터를 쿼리하기 위한 전문가용 읽기 전용 CLI 도구입니다.
MiniMax Vision Scraper
Playwright 스크린샷과 MiniMax VLM을 결합하여 기존 스크레이퍼를 차단하는 웹사이트에서 데이터를 추출하는 강력한 시각적 스크래핑 스킬입니다.
Meta Ads CLI
Facebook 및 Instagram 광고 성과에 대한 심층 분석을 가능하게 하는 Meta Marketing API용 포괄적인 읽기 전용 명령줄 인터페이스입니다.
Claw Code Suite
오프라인 코드 분석 및 AI 에이전트 오케스트레이션을 위해 184개의 도구와 207개의 명령을 제공하는 보안 우선 Python 하니스입니다.
Cludo
AI 에이전트가 안전한 CLI 인터페이스를 통해 Cludo 검색 데이터, 발견 설정 및 자동화된 워크플로우를 관리할 수 있도록 하는 전문 통합 도구입니다.
Google Search Console CLI
Google Search Console 데이터 검색, 기술적 SEO 검사 및 사이트맵 관리를 자동화하기 위한 포괄적인 CLI 도구입니다.
Suno-Claw: 멀티 에이전트 AI 노래 생성기
Suno AI와 kie.ai API를 활용하여 반복적인 창의적 개선을 통해 전문 수준의 음악을 생성하는 정교한 멀티 에이전트 프레임워크입니다.
추천*
