Hermoso는 마케팅 MCP 서버입니다. 하나의 OAuth 엔드포인트를 통해 922+개 도구를 제공하며, 에이전트가 시장에서 이미 달리는 광고를 리서치하고, 완성된 이미지와 영상 광고를 만들고, 게시하고, 그 뒤의 유료 캠페인을 만들 수 있게 해 줍니다. Claude는 연결 하나로 이 모든 것에 접근합니다. 이 페이지는 그중 한 부분, 즉 Claude가 Facebook에서 실제로 무엇을 할 수 있고 Facebook이 무엇을 허용하지 않는지를 다룹니다.
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의 승인을 받은 곳이 아니에요.
그다음 Hermoso의 설정 → 커넥터에서 @BotFather가 준 봇 토큰을 붙여넣어 Telegram을 한 번 연결하고, 그 봇을 채널에 관리자로 추가하세요. 동의 화면은 없습니다. 토큰이 자격 증명이고, 봇이 게시하는 주체입니다.
Claude가 받는 Telegram 도구
post_to_telegram: 지정한 채팅방에 봇으로 메시지를 보냅니다. 최대 4,096자의 텍스트, 사진 1장, 영상 1개, 또는 사진과 영상을 섞은 2~10개짜리 앨범입니다.schedule_post: 다른 모든 채널과 같은 캘린더에chatId와 함께 대기열로 넣습니다.list_telegram_chats: 최근 24시간 안에 봇에게 메시지를 보낸 채팅방 목록입니다. ID를 찾는 데 도움이 되지만, 봇이 속한 모든 채팅방의 목록은 아닙니다.edit_telegram_message / pin_telegram_message: 조회수를 잃지 않고 메시지 본문이나 캡션을 고치며, 행동 유도 메시지를 고정하거나 고정 해제합니다.create_telegram_invite_link: 캠페인마다 이름 있는 초대 링크를 만듭니다. 만료일, 멤버 수 제한, 가입 승인을 선택할 수 있어 누가 어디서 들어왔는지 볼 수 있습니다.telegram_account: 채팅방의 구독자 또는 멤버 수, 제목, 설명, 초대 링크입니다.list_telegram_dms: 최근 24시간 동안 사람들이 봇에게 보낸 메시지를 최신순으로 보여 줍니다.post_to_telegram으로 답하기 위한 것입니다.delete_telegram_message: 봇이 보낸 메시지를 Telegram의 48시간 안에서 삭제합니다. 확인 단계를 거칩니다.
Telegram은 로그인 화면이 아니라 봇 토큰으로 연결합니다. Telegram에서 @BotFather로 봇을 만들고, 토큰을 설정 → 커넥터에 붙여넣은 뒤, 봇을 채널에 메시지 게시 권한이 있는 관리자로, 또는 그룹에 글을 쓸 수 있는 멤버로 추가하세요. Hermoso는 여러분이 아니라 그 봇으로 게시합니다. 계획할 때 고려할 Telegram의 제한이 두 가지 있습니다. 봇은 게시물별 조회수와 게시 기록을 받지 못하므로, 구독자 수와 이름 있는 초대 링크가 여러분이 가진 숫자의 전부입니다. 그리고 봇에게 보낸 메시지는 24시간 동안만 보관되고 그 뒤에는 사라집니다. 게시에는 크레딧이 들지 않습니다.
자동화하기 전에 알아 둘 Telegram 제한
| 텍스트 | Telegram 메시지는 4,096자까지 가능하지만, 사진이나 영상이 붙으면 텍스트가 캡션이 되므로 1,024자로 줄어듭니다. 이 제한은 게시물을 만들거나 예약할 때 적용되므로, 글자 수를 넘은 게시물은 나가는 도중 몰래 잘리는 대신 여러분이 아직 옆에 있을 때 거부됩니다. |
|---|---|
| 공개 범위 | 보내졌거나 보내지지 않음이며, 초안, 일부 공개, 비공개 형태는 없습니다. 누가 보는지는 채팅방이 정합니다. “비공개 그룹이나 채널에 게시하면 그 멤버만 봅니다.” silent는 알림음 없이 전달하며, 메시지를 누가 볼 수 있는지는 바꾸지 않습니다. |
| 캐러셀 | 2~10개 항목의 앨범이며, 사진과 영상을 섞을 수 있습니다. 두 경계값은 Bot API의 sendMediaGroup이 정한 Telegram 자체 규칙(“must include 2-10 items”)이며, 섞을 수 있는 것도 같은 규칙입니다. 앨범은 첫 항목에 캡션 하나를 표시합니다. Hermoso는 링크를 전달하는 대신 파일을 직접 업로드하므로, Telegram의 상한이 사진 1장당 10MB, 영상 1개당 50MB로 올라갑니다. |
| 어느 계정 | chatId는 모든 게시물에 필수입니다. 공개 채널의 @사용자명 또는 숫자 ID입니다(슈퍼그룹이나 채널은 -100으로 시작합니다). Bot API에는 봇이 속한 채팅방을 나열하는 메서드가 없으므로, Hermoso는 그 목록을 알 수 없고 추측하지도 않습니다. |
Claude에서 해 보기
일상 언어로 요청하세요. 이것은 DSL이 아니라 평범한 문장입니다:
“./renders/teaser.mp4를 Telegram 채널 @ourbrand에 게시해 주세요. 캡션은 1,024자 미만으로 쓰고, 멤버에게 알리지 않고 고정해 주세요.”
이 흐름은 render_ad → post_to_telegram → pin_telegram_message → create_telegram_invite_link 순서로 진행돼요. Gemini CLI는 셸 명령을 실행하기 전에 물어보고, 스킬은 hermoso 명령으로 작동하므로 게시 작업은 승인하기 전에 읽을 수 있는 한 줄로 나타나요. MCP 도구는 한 번만 허용하거나, 그 도구를 항상 허용하거나, 서버 전체를 항상 허용할 수 있어요.
Facebook에서의 Gemini CLI: 까다로운 부분
호출하기 전에 파일 크기를 확인하세요. Hermoso가 링크가 아니라 파일 자체를 보내더라도 Telegram은 업로드한 동영상을 50MB로 제한해요(링크로 보내면 20MB). 더 긴 렌더는 더 가볍게 인코딩해야 할 수도 있어요. 봇은 채널에서 메시지 게시 권한이 있는 관리자여야 하고, 고정하려면 고정 권한도 있어야 해요. 빠진 권한이 무엇인지는 Telegram의 거부 메시지에 나와요.
Gemini CLI에서 두 가지 설정이 이 방식의 안전성을 정해요. gemini mcp add는 --scope user를 주지 않으면 프로젝트의 .gemini/settings.json에 기록해요. 한 저장소가 항상 한 브랜드로만 실행되어야 할 때 유용해요. 그리고 Hermoso를 --trust와 함께 추가하지 마세요. 이 옵션은 게시 직전의 확인을 포함해 서버의 모든 확인을 건너뛰어요. MCP 도구의 이름은 mcp_hermoso_와 도구 이름이 합쳐져 붙고, --exclude-tools로 특정 도구를 아예 제외할 수 있어요.
게시하기 전에 Telegram 리서치하기
Hermoso에는 Telegram 광고 라이브러리도 채널 검색도 없으므로 Telegram에서의 경쟁사 조사는 주장하지 않습니다. 크리에이티브가 공개된 곳(Meta, Google, LinkedIn 광고 라이브러리와 유기적 TikTok, Instagram, YouTube, Reddit, Threads)에서 조사하고, 완성된 광고는 여기에 게시하세요.
유료 부분
Hermoso에는 Telegram 광고가 없으며, 있는 것처럼 말하지 않습니다. 여기서 Telegram은 여러분이 소유하고 봇으로 운영하는 채널입니다. 게시, 고정, 수정, 구독자 수 세기, 초대 추적을 합니다. 유료 도구는 Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads, AppLovin Ads를 다룹니다.
Gemini CLI 혼자서는 할 수 없는 일
예산이 있는 에이전트는 영향 범위가 제한되어 있을 때만 쓸모가 있으므로, 울타리는 프롬프트가 아니라 서버에 둡니다. 모든 광고 캠페인, 광고 세트, 광고 그룹, 광고는 일시 중지 상태로 만들어지며, 실제 돈이 움직이는 상태 변경은 명시적인 확인 표시 없이는 실행되지 않습니다. 모든 렌더는 먼저 견적을 받습니다(hermoso_capabilities가 비용이 쓰이기 전에 모델별 정확한 크레딧 비용을 공개합니다). 크레딧은 첫 제공자 호출 전에 예약되고 이후 정확한 비용으로 정산되므로, 전송이 실패하면 환불되며 아무것도 없이 청구되지 않습니다. 삭제도 확인이 필요하며, 에이전트가 무엇을 만들었다고 말하기 전에 모든 캠페인 구조를 광고 플랫폼에서 다시 읽어 옵니다.
한 단계는 의도적으로 여러분이 직접 해야 합니다. @BotFather에서 봇을 만들고 채널에 추가하는 것입니다. 그 이후는 모두 도구 호출입니다.
나머지 매트릭스
Gemini CLI에서 다음에 게시: Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky. 또는 Gemini CLI가 게시할 수 있는 모든 채널을 보세요.
다음에서 Telegram에 게시: Claude · ChatGPT · Claude Code · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip
자주 묻는 질문
Claude에서 Facebook에 게시할 수 있나요?
네, Hermoso의 Gemini CLI 익스텐션으로 가능해요. 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로 로그인해요. 그러면 Gemini CLI는 마케팅 도구 922개 이상을 쓸 수 있어요. Facebook에 게시하는 도구뿐 아니라, 시장에서 이미 집행 중인 광고를 리서치하고 크리에이티브를 처음부터 렌더링하는 도구도 포함돼요.
Facebook을 Claude에 어떻게 연결하나요?
두 단계를 각각 한 번씩 진행하세요. gemini extensions install https://github.com/hermoso-ai/hermoso를 실행하면 hermoso 명령을 구동하는 Hermoso 스킬 다섯 개가 추가되고, 그다음 npx -y hermoso auth login으로 한 번 로그인하세요. 로그인하면 브라우저가 열리고 인증 정보는 자동으로 저장되므로 키를 만들거나 붙여 넣을 필요가 없어요. Hermoso 도구를 Gemini CLI 자체 도구 목록에도 넣고 싶다면 gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcp로 호스팅된 서버를 추가하세요. 이 서버는 OAuth로 로그인해요. 그다음 Telegram에서 @BotFather로 봇을 만들고, 발급받은 토큰을 Hermoso의 설정 → 커넥터에 붙여 넣은 뒤, 봇을 채널에 메시지 게시 권한이 있는 관리자로 추가하세요. 그러면 Gemini CLI가 매번 채팅을 지정하는 일반 도구 호출로 Telegram에 게시해요.
Claude로 Facebook에 비공개로 또는 초안으로 게시할 수 있나요?
Bot API에는 초안이나 비공개 메시지가 없습니다. Telegram의 공개 범위는 채팅방이 정합니다. 비공개 그룹이나 채널에 게시하면 멤버만 봅니다. Hermoso는 Telegram이 지킬 수 없는 공개 범위를 요청받는 순간 거부하며, 더 약한 설정으로 몰래 게시하지 않습니다.
ChatGPT가 게시하기 전에 Facebook을 조사할 수 있나요?
아니요. Hermoso에는 Telegram 광고 라이브러리나 채널 검색이 없습니다. 공개 광고 라이브러리와 유기적 플랫폼에서 크리에이티브를 조사하고, 결과물은 Telegram에 게시합니다.
Claude에서 Facebook에 게시할 때 캡션 글자 수 제한은 얼마인가요?
텍스트만 있는 Telegram 메시지는 4,096자까지 가능하며, 사진이나 영상이 붙으면 텍스트가 캡션이 되고 한도는 1,024자가 됩니다. Hermoso는 어떤 한도가 적용되었는지 알려 줍니다. Hermoso는 게시물을 만들거나 예약할 때 이를 적용하므로, ChatGPT는 나중에 아무도 지켜보지 않을 때 실패하는 대신 즉시 알림을 받습니다.
ChatGPT가 게시뿐 아니라 Telegram 광고도 운영할 수 있나요?
아니요. Hermoso에는 Telegram 광고가 없습니다. 여기서 Telegram은 여러분이 자신의 봇으로 운영하는 채널입니다. 게시물, 고정, 수정, 초대 링크, 구독자 수를 다룹니다.