Claude란 무엇인가요?
Gemini CLI는 Google의 오픈소스 터미널 에이전트예요. GitHub 저장소에서 익스텐션을 바로 설치하고, 익스텐션은 스킬과 컨텍스트 파일을 함께 가져올 수 있어요. Hermoso는 그중 하나를 제공해서, 설치 전체가 명령 하나로 끝나고 에이전트는 스킬을 보고 언제 Hermoso를 써야 하는지 스스로 알아요.
Gemini CLI인가요, Gemini 앱인가요? Gemini CLI는 Google의 터미널 에이전트이고 Hermoso를 익스텐션으로 설치해요. gemini.google.com의 Gemini 앱은 Hermoso를 커스텀 앱으로 연결하며, 별도의 요구 사항이 있어요.
Hermoso는 마케팅을 자동 조종하는 서비스입니다. 하나의 MCP 엔드포인트에서 922+개 도구를 제공하며, 경쟁사 광고 리서치, 100+개 모델로 만드는 완성된 이미지·영상 광고, 열한 개 소셜 채널에 게시와 예약, 그리고 Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads, AppLovin Ads의 캠페인 관리를 포함합니다. 연결 한 번이면 Claude가 이 모든 기능을 씁니다.
Claude에 Hermoso 연결하기
- 익스텐션을 설치하세요.
Hermoso 공개 저장소의 최신 릴리스를 설치해요. 스킬 5개(research, ad-from-brand, generate, product-photoshoot, marketing)와gemini extensions install https://github.com/hermoso-ai/hermosoGEMINI.md컨텍스트 파일이 들어 있어요. 스킬은npx를 통해hermoso명령을 실행하므로, Gemini CLI의 도구 목록에는 아무것도 추가되지 않고 명령이 실행되기 전까지는 문맥도 쓰지 않아요.gemini extensions list에 Agent skills 아래로 표시돼요. - 한 번 로그인하세요.
브라우저에서 로그인 화면이 열리고, 자격 증명은npx -y hermoso auth login~/.hermoso/config.json에 소유자만 읽을 수 있게 저장돼요. Gemini CLI는 Hermoso가 처음 필요할 때 이 로그인을 대신 실행할 수 있어요. 그 기기에 브라우저가 없나요? MCP & CLI → 터미널 & API 키에서 키를 만들고npx -y hermoso auth login --token hmk_…를 실행하세요. - 선택 사항: MCP 서버도 추가하기.
Gemini CLI는 첫 연결이 401로 응답하면 Hermoso의 인증 서버를 찾고 스스로 등록하므로,gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcpsettings.json에 키를 넣을 필요가 없어요. 세션 안에서/mcp auth hermoso를 실행하면 로그인이 진행돼요. 스킬은 이것이 없어도 모든 도구에 닿아요. - Claude에 무언가를 요청하세요. “가장 가까운 경쟁사 세 곳의 가장 오래 달리는 광고를 찾아서, 가장 좋은 훅을 9:16 영상으로 리믹스해 줘” 또는 “이 렌더를 채널에 올려 줘”. 에이전트가 도구를 고르고, 지출은 당신이 승인합니다.
위 설치는 2026-09-23에 깨끗한 홈 디렉터리에서 Gemini CLI 0.60.0으로 실행했어요. hermoso-ai/hermoso의 최신 릴리스를 가져왔고, gemini extensions list는 스킬 5개와 컨텍스트 파일을 표시했어요. 이 익스텐션에는 자체 MCP 서버가 없는데, 이는 의도된 설계예요. 도구 목록은 모든 세션에 불러와지지만, 스킬은 실행되기 전까지 아무 비용도 들지 않아요. Hermoso는 Google과 제휴하거나 Google의 승인을 받은 곳이 아니에요.
Claude가 게시할 수 있는 모든 채널
각 채널에는 그 채널의 실제 캡션 한도, 실제 공개 범위 옵션, 거부하는 항목과 그 이유, 그리고 Claude용으로 쓴 예시가 담긴 별도 페이지가 있습니다.
| 채널 | 캐러셀 | 글자 수 제한 |
|---|---|---|
| 사진 2장 이상, 자체 상한 30장 | 63,206자 | |
| 2–10장, 이미지 + 영상 | 2,200자 | |
| Threads | 2–20장, 이미지 + 영상 | 500자 |
| TikTok | 이미지 최대 35장 | 2,200 / 4,000자 |
| YouTube | 거부됨(단위가 영상) | 제목 100자 |
| X | 거부됨(4장은 그리드로 표시됨) | 280자, 또는 Premium은 25,000자 |
| 이미지 2–20장, 회사 페이지 전용 | 3,000자 | |
| 이미지 2–5장(Trial에서는 차단) | 설명 800자 | |
| Bluesky | 이미지 2~4장 | 300자, 3,000바이트 |
| Telegram | 2~10장, 사진과 영상 | 4,096자, 미디어 첨부 시 1,024자 |
이 채널들은 모두 schedule_post 일정표 하나를 거치며 채널별 캡션을 붙일 수 있습니다. list_scheduled는 단일 초록불이 아니라 채널별 결과를 보여 줍니다. “작업이 성공했다”와 “게시물이 나갔다”는 서로 다른 질문이기 때문입니다. 예약된 게시물은 Hermoso에 저장되므로, Claude가 계속 실행 중이든 아니든 제때 나갑니다.
Google Business Profile은 가장 새로운 채널입니다. Google 검색과 지도의 업체 정보에 사진과 버튼이 있는 게시물을 올리고, 리뷰에 답하고, 업체 정보를 수정하고, 업체 정보로 생기는 전화, 웹사이트 클릭, 길찾기 요청을 관리합니다. Claude는 같은 도구로 이 채널에 접근하며, schedule_post로 같은 일정표에 예약합니다.
만들어졌지만 제공하지 않는 채널 하나
이 부분을 솔직하게 말하는 것이 긴 목록을 보여 주는 것보다 가치가 있습니다. 코드베이스에는 게시 기능이 하나 있지만 보류되어 있으며, 그 이유는 우리가 아니라 플랫폼을 기다리고 있기 때문입니다:
- Reddit: 조직 게시와 게시물 통계는 만들어져 있습니다. 하지만 Reddit의 Responsible Builder Policy에 따라 앱이 Data API를 쓰기 전에 명시적인 서면 승인이 필요하며, 그 승인은 아직 받지 못했습니다. 그래서 작동하지 않는 API로 이어지는 OAuth 화면을 띄우기보다 커넥터를 보류해 두었습니다. Reddit Ads는 별개의 연결이며 이미 운영 중입니다: 캠페인 구조 전체, 예측, 타깃팅 검색, 픽셀, 리드 양식을 지원합니다.
성공한 OAuth 화면을 보여 주지만 작동하지 않는 API로 연결되는 커넥터는, 아직 제공하지 않는 것보다 나쁩니다. 그래서 사용 가능한 것으로 나열하지 않습니다.
연결한 뒤 한 번만 입력하면 되는 세 가지
- 리서치. “가장 가까운 경쟁사 세 곳은 누구이고, 가장 오래 달리는 Meta 광고는 무엇인가? 계속 반복되는 훅이 무엇인지 알려 줘.”
find_competitors→pull_competitor_ads→mine_angles순서로 실행됩니다. - 제작. “그 훅을 써서 내 실제 제품 사진과 자막을 넣은 9:16 UGC 영상 광고를 만들어 줘.”
get_brand→plan_ad→render_ad순서로 실행되고, 완성된 mp4 URL을 돌려줍니다. - 게시. “화요일 오전 9시에 Instagram과 TikTok에 예약하고, 그 광고를 중심으로 미국을 대상으로 하루 $30짜리 일시 중지된 Meta 캠페인을 만들어 줘.”
schedule_post→create_meta_campaign→create_meta_ad순서로 실행됩니다.
Gemini CLI 혼자서는 할 수 없는 일
예산이 있는 에이전트는 영향 범위가 제한되어 있을 때만 쓸모가 있으므로, 울타리는 프롬프트가 아니라 서버에 둡니다. 모든 광고 캠페인, 광고 세트, 광고 그룹, 광고는 일시 중지 상태로 만들어지며, 실제 돈이 움직이는 상태 변경은 명시적인 확인 표시 없이는 실행되지 않습니다. 모든 렌더는 먼저 견적을 받습니다(hermoso_capabilities가 비용이 쓰이기 전에 모델별 정확한 크레딧 비용을 공개합니다). 크레딧은 첫 제공자 호출 전에 예약되고 이후 정확한 비용으로 정산되므로, 전송이 실패하면 환불되며 아무것도 없이 청구되지 않습니다. 삭제도 확인이 필요하며, 에이전트가 무엇을 만들었다고 말하기 전에 모든 캠페인 구조를 광고 플랫폼에서 다시 읽어 옵니다.
일부러 사람이 직접 하도록 남겨 둔 단계가 하나 있습니다: 각 계정을 한 번 연결하는 것. 대부분의 채널은 플랫폼의 OAuth 승인 화면을 브라우저에서 거쳐 연결됩니다. Bluesky는 앱 비밀번호를, Telegram은 봇 토큰을 받으며, Hermoso에 붙여 넣습니다. 그 뒤의 모든 작업은 도구 호출입니다.
Gemini CLI는 셸 명령을 실행하기 전에 물어보고, 스킬은 hermoso 명령을 통해 동작해요. 그래서 게시는 승인하기 전에 읽을 수 있는 한 줄로 나타나요. MCP 도구에는 한 번만, 해당 도구는 항상, 또는 서버는 항상 허용 중에서 고를 수 있어요.
비용
Claude에 Hermoso를 추가하는 데 추가 비용은 없습니다. 크레딧 계량기는 하나이며, 어떤 클라이언트가 호출했는지는 따지지 않습니다. 무료 계정은 가입 시 30 크레딧으로 시작하고 250 크레딧 이상을 더 적립할 수 있습니다. 크레딧은 AI 모델과 광고 스파이 리서치에만 씁니다. 게시, 예약, 광고 관리, 분석은 X를 제외한 모든 채널에서 무료이며, X는 API 요청마다 비용을 내므로 호출당 과금됩니다. 유료 플랜은 월 $29, $69, $149이며, 각각 1,200, 3,000, 7,000 크레딧을 줍니다. 모든 기능이 모든 플랜에 포함됩니다. hermoso_capabilities는 렌더를 실행하기 전에 그 렌더의 정확한 크레딧 가격을 알려 줍니다.
문제 해결
- 로컬 서버가 도움말을 출력하고 종료합니다. 인수에 끝의
mcp가 빠져 있습니다.npx -y hermoso만 실행하면 도움말이 나오고,npx -y hermoso mcp를 실행하면 서버가 시작됩니다. - 그 컴퓨터에 브라우저가 없습니다. MCP & CLI → Terminal & API keys에서 키를 만든 다음, 대신
npx -y hermoso auth login --token hmk_…를 실행하세요. - 채널이 없습니다. Hermoso의 설정 → 커넥터에서 연결한 다음, Claude에
list_connectors를 다시 실행해 달라고 하세요. - Claude가 Hermoso를 쓰지 않고 답합니다. 요청에 이름을 넣으세요: “Hermoso로 …해 줘”. 그러면 어떤 도구가 작업을 해야 하는지 분명해집니다.
게시 그 이상
게시는 마지막 단계이며 가장 작은 부분입니다. 같은 연결로 Claude는 리서치를 위해 Meta, Google, LinkedIn 광고 라이브러리와 TikTok, Instagram, YouTube, Reddit, Threads의 오가닉 콘텐츠를 얻습니다. 하나의 크레딧 계량기로 100+개의 이미지, 영상, 음성, 글쓰기 모델을 쓰고, UGC 아바타, 더빙, 업스케일링, 네이티브 HTML 광고 포맷도 씁니다. 열두 개 유료 플랫폼에 걸친 캠페인 구조 전체도 포함됩니다. 보관할 공급사별 API 키도, 익힐 별도 앱도 없습니다.
전체 도구 목록, Hermoso가 작동하는 모든 에이전트, 또는 마케팅 MCP란 무엇인가를 보세요.
다른 에이전트에서의 Hermoso
아래 모든 에이전트에서 같은 Hermoso 계정이 작동하므로, 브랜드, 라이브러리, 일정, 크레딧이 에이전트 사이에서 그대로 따라옵니다.
| 에이전트 | Hermoso 연결 방식 |
|---|---|
| Claude | OAuth로 연결, 붙여 넣을 것 없음 |
| ChatGPT | OAuth로 연결, 붙여 넣을 것 없음 |
| Claude Code | 터미널에서 hermoso auth login으로 로그인, 붙여 넣을 것 없음 |
| Cursor | 터미널에서 hermoso auth login으로 로그인, 붙여 넣을 것 없음 |
| Codex | 터미널에서 hermoso auth login으로 로그인, 붙여 넣을 것 없음 |
| Cline | Authorization 헤더에 API 키 입력 |
| OpenClaw | 터미널에서 hermoso auth login으로 로그인, 붙여 넣을 것 없음 |
| Grok Bot | Hermoso Marketing Bot 템플릿을 추가하고 채팅에 API 키를 입력하거나, Bot 자체의 터미널에서 로그인 |
| Hermes | 터미널에서 hermoso auth login으로 로그인, 붙여 넣을 것 없음 |
| Perplexity | OAuth로 연결, 붙여 넣을 것 없음 |
| Le Chat | OAuth로 연결, 붙여 넣을 것 없음 |
| Claude Cowork | OAuth로 연결, 붙여 넣을 것 없음 |
| Perplexity Computer | OAuth로 연결, 붙여 넣을 것 없음 |
| Paperclip | OAuth로 연결, 붙여 넣을 것 없음 |
| Gemini | OAuth로 연결, 붙여 넣을 것 없음 |
| Grok Build | 터미널에서 hermoso auth login으로 로그인, 붙여 넣을 것 없음 |
| Kimi Code | 호스팅 URL을 mcp.json에 추가하고 /mcp-config login으로 로그인, 붙여 넣을 것 없음 |
| DeepSeek Harness | 터미널에서 hermoso auth login으로 로그인하고 Hermoso를 로컬 서버로 실행, 붙여 넣을 것 없음 |
| Manus | Authorization 헤더에 API 키 입력 |
| Muse | 채팅 메시지 한 번 후 OAuth 로그인 |
| 모든 MCP 클라이언트 | OAuth가 있는 호스팅 URL, 또는 stdio를 통한 로컬 서버 |
자주 묻는 질문
Claude에서 소셜 미디어에 게시할 수 있나요?
네, Hermoso 익스텐션을 설치하면 가능해요. 그러면 Gemini CLI는 Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram, Google Business Profile에 게시할 수 있고, 채널별 캡션을 붙여 11개 채널 모두를 하나의 대기열에서 예약할 수 있어요.
Claude에 Hermoso는 어떻게 추가하나요?
다음 명령을 실행하세요: gemini extensions install https://github.com/hermoso-ai/hermoso. 이 명령은 hermoso 명령을 구동하는 Hermoso 스킬 5개를 추가하고, 그다음 npx -y hermoso auth login으로 한 번 로그인하세요. 로그인은 브라우저를 열고 자격 증명을 직접 저장하므로, 만들 키도 붙여넣을 키도 없어요. Gemini CLI 자체 도구 목록에도 Hermoso 도구를 넣고 싶다면 gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcp 명령이 호스팅 서버를 추가하며, 이 서버는 OAuth로 로그인해요. 위 설치는 2026-09-23에 깨끗한 홈 디렉터리에서 Gemini CLI 0.60.0으로 실행했어요. hermoso-ai/hermoso의 최신 릴리스를 가져왔고, gemini extensions list는 스킬 5개와 컨텍스트 파일을 표시했어요. 이 익스텐션에는 자체 MCP 서버가 없는데, 이는 의도된 설계예요. 도구 목록은 모든 세션에 불러와지지만, 스킬은 실행되기 전까지 아무 비용도 들지 않아요. Hermoso는 Google과 제휴하거나 Google의 승인을 받은 곳이 아니에요.
Claude로 Meta와 Google 광고 캠페인을 운영할 수 있나요?
네. Claude는 Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads, AppLovin Ads에서 캠페인 구조 전체를 만들 수 있습니다. 받는 요약은 플랫폼에 실제로 저장된 내용을 다시 읽어 와서 만든 것입니다.
Claude에서 Hermoso를 쓰면 추가 비용이 드나요?
아니요. 크레딧 계량기는 하나이며, 어떤 클라이언트가 호출했는지는 따지지 않습니다. 무료 계정은 30 크레딧으로 시작하고 250 크레딧 이상을 더 적립할 수 있습니다. 유료 플랜은 월 $29, $69, $149이며, 각각 1,200, 3,000, 7,000 크레딧을 줍니다. 게시는 X를 제외한 모든 채널에서 무료입니다. X는 API 요청마다 비용을 내므로 호출당 과금됩니다.
Claude가 대신 게시하고 광고를 집행해도 안전한가요?
Gemini CLI가 어떻게 설정되어 있든, Hermoso는 돈이 들거나 되돌릴 수 없는 단계를 자체 서버의 게이트 뒤에 둬요. 모든 캠페인은 일시정지 상태로 만들어지고, 지출 전환과 삭제에는 명시적인 확인이 필요하며, 게시물은 연결하고 Hermoso에서 체크한 계정에만 도달해요. Gemini CLI는 셸 명령을 실행하기 전에 물어보고, 스킬은 hermoso 명령을 통해 동작하므로, 게시는 승인하기 전에 읽을 수 있는 한 줄로 나타나요. MCP 도구에는 한 번만, 해당 도구는 항상, 또는 서버는 항상 허용 중에서 고를 수 있어요.
Gemini CLI 익스텐션과 MCP 서버가 둘 다 필요한가요?
아니요. 익스텐션만으로도 hermoso 명령을 통해 Hermoso의 모든 도구에 닿아요. MCP 서버는 선택 사항이며, Hermoso의 도구를 Gemini CLI 자체 목록에 넣는 것이라서 매 세션마다 문맥을 차지해요.