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의 설정 → 커넥터에서 TikTok 자체를 한 번 연결하세요. 이것은 OAuth 승인 화면이라서 브라우저가 필요한 유일한 단계입니다. 그 이후의 모든 작업은 도구 호출입니다.
Claude가 받는 TikTok 도구
post_to_tiktok: 완성된 영상이나 이미지 최대 35장의 사진 게시물을 원하는 공개 범위로 프로필에 바로 게시하거나, 앱에서 마무리하도록 TikTok 초안에 넣습니다. 상호작용 설정(댓글, 듀엣, 스티치), 커버 프레임, 브랜디드 콘텐츠 고지도 함께 담습니다.schedule_post: 공유 일정표에 나중을 위해 대기열에 넣으며, 대기열에 넣을 때 공개 범위가 고정됩니다.tiktok_account / tiktok_creator_info: 계정의 소개, 인증 여부, 팔로워와 영상 수, 그리고 계정 자체가 허용하는 공개 수준.tiktok_post_status: TikTok이 아직 처리 중인 게시물을 추적하므로, 느린 업로드는 다시 게시되지 않고 확인됩니다.list_tiktok_videos / tiktok_account_insights: 최근 게시물의 조회수, 좋아요, 댓글, 공유, 그리고 계정 자체 분석. 팔로워 100명 이상의 Business 계정에서는 팔로워 인구 통계도 포함됩니다.list_tiktok_comments / reply_to_tiktok_comment / moderate_tiktok_comment: 내 게시물의 댓글을 읽고, 계정 이름으로 답하고, 좋아요를 누르거나 숨기거나 삭제합니다. TikTok 계정 인증이 연결되어 있어야 합니다.search_tiktok: 공개 TikTok을 키워드로 검색합니다. 리서치 쪽입니다.
운영상 사실 두 가지가 더 있습니다. TikTok 사진 게시물은 업로드가 아니라 URL에서 가져오므로, 이미지를 제공하는 호스트를 TikTok 개발자 포털에서 먼저 검증해야 사진 게시물이 나갈 수 있습니다. 또 초안에는 커버 프레임이 없습니다. 직접 게시에서는 Hermoso가 영상의 가장 좋은 프레임을 커버로 설정하지만, 초안은 TikTok 앱에서 커버를 고릅니다.
자동화하기 전에 알아 둘 TikTok 제한
| 텍스트 | TikTok 영상 캡션은 2,200자, 사진 게시물 캡션은 4,000자, 사진 제목은 90자로 제한됩니다. 게시물을 만들거나 대기열에 넣을 때 강제되므로, 너무 긴 게시물은 전송 중에 몰래 잘리는 대신 여러분이 아직 옆에 있을 때 거부됩니다. |
|---|---|
| 공개 범위 | 전체 공개, 팔로워, 친구, 나만 보기, 또는 초안 중에서 선택합니다. Hermoso는 2026년 8월에 TikTok의 Direct Post 심사를 통과했으므로, 게시물이 프로필에 공개로 올라갈 수 있습니다. TikTok의 규칙은 모든 게시물마다 크리에이터가 공개 범위를 고르고, 미리 선택된 것이 없으며, tiktok_creator_info가 계정에 허용한다고 알려 준 수준 중에서만 고르는 것입니다. 그래서 Hermoso는 기본값을 쓰지 않고 묻으며, 공개 범위를 지정하지 않은 게시물은 업로드 전에 거부합니다. 초안은 앱에서 마무리할 수 있도록 TikTok 받은편지함으로 가며, TikTok 사운드를 추가하는 곳도 여기입니다. 미공개 옵션은 없습니다. 브랜디드 콘텐츠는 비공개(나만 보기) 게시물과 함께 쓸 수 없으며, 그 조합은 대신 해결하지 않고 거부합니다. |
| 캐러셀 | 사진 게시물로 최대 35장의 이미지, 이미지만 가능합니다. 이 숫자는 TikTok의 것입니다. “최대 35개의 사진 콘텐츠 URL을 담는 배열.” 순서가 곧 슬라이드쇼이므로 슬라이드 순서가 결과물입니다. 이미지 한 장이면 거부되는 것이 아니라 한 장짜리 게시물이 됩니다. |
| 어느 계정 | 없음. TikTok은 연결된 계정에 게시합니다. |
Claude에서 해 보기
일상 언어로 요청하세요. 이것은 DSL이 아니라 평범한 문장입니다:
“우리 제품의 15초짜리 훅 변형 2개를 렌더링하고, 첫 번째는 공개로 게시하고 두 번째는 내 TikTok 초안으로 보내 줘.”
이 흐름은 search_tiktok → plan_ad → render_ad → post_to_tiktok 순서로 진행돼요. Gemini CLI는 셸 명령을 실행하기 전에 물어보고, 스킬은 hermoso 명령을 통해 동작하므로, 게시는 승인하기 전에 읽을 수 있는 한 줄로 나타나요. MCP 도구에는 한 번만, 해당 도구는 항상, 또는 서버는 항상 허용 중에서 고를 수 있어요.
Facebook에서의 Gemini CLI: 까다로운 부분
Gemini CLI는 셸 명령을 실행하기 전에 물어보므로, TikTok 게시물은 공개 범위를 포함해 읽을 수 있는 hermoso 명령 한 줄로 나타나요. 바로 게시할 때는 Hermoso가 영상의 가장 좋은 프레임을 커버로 설정해요. 초안은 커버를 지정하지 않으며, 커버는 TikTok 앱에서 고르면 돼요.
Gemini CLI에서 두 가지 설정이 이 방식의 안전성을 정해요. gemini mcp add는 --scope user를 주지 않으면 프로젝트의 .gemini/settings.json에 기록해요. 한 저장소가 항상 한 브랜드로만 실행되어야 할 때 유용해요. 그리고 Hermoso를 --trust와 함께 추가하지 마세요. 이 옵션은 게시 직전의 확인을 포함해 서버의 모든 확인을 건너뛰어요. MCP 도구의 이름은 mcp_hermoso_와 도구 이름이 합쳐져 붙고, --exclude-tools로 특정 도구를 아예 제외할 수 있어요.
게시하기 전에 TikTok 리서치하기
Hermoso에는 Meta에서 쓰는 것과 같은 TikTok 광고 라이브러리 검색이 없으므로, TikTok 리서치는 오가닉입니다. search_tiktok이 키워드로 잘 되는 것을 찾고, analyze_video가 영상을 훅, 비트, 화면 텍스트로 분해해서 패턴을 추측하지 않고 재사용할 수 있게 합니다.
유료 부분
TikTok Ads는 Hermoso가 캠페인을 만들고 읽는 열두 개 유료 플랫폼 중 하나이며, 오가닉 연결과는 별도의 연결입니다. 유기 게시물을 홍보하는 Smart+ 캠페인과 Spark Ads를 포함합니다. 캠페인은 TikTok의 Marketing API로, 게시는 TikTok의 콘텐츠 게시 승인으로 이루어지므로, Hermoso는 각각을 따로 보고하며 하나가 다른 것을 암시하게 두지 않습니다. 실제 돈을 움직이는 것은 확인이 필요한 상태 변경뿐입니다.
Gemini CLI 혼자서는 할 수 없는 일
예산이 있는 에이전트는 영향 범위가 제한되어 있을 때만 쓸모가 있으므로, 울타리는 프롬프트가 아니라 서버에 둡니다. 모든 광고 캠페인, 광고 세트, 광고 그룹, 광고는 일시 중지 상태로 만들어지며, 실제 돈이 움직이는 상태 변경은 명시적인 확인 표시 없이는 실행되지 않습니다. 모든 렌더는 먼저 견적을 받습니다(hermoso_capabilities가 비용이 쓰이기 전에 모델별 정확한 크레딧 비용을 공개합니다). 크레딧은 첫 제공자 호출 전에 예약되고 이후 정확한 비용으로 정산되므로, 전송이 실패하면 환불되며 아무것도 없이 청구되지 않습니다. 삭제도 확인이 필요하며, 에이전트가 무엇을 만들었다고 말하기 전에 모든 캠페인 구조를 광고 플랫폼에서 다시 읽어 옵니다.
일부러 헤드리스로 하지 않는 단계가 하나 있습니다: 계정 연결은 OAuth 승인 화면이므로, 채널은 브라우저에서 한 번 연결합니다. 그 이후의 모든 작업은 도구 호출입니다.
나머지 매트릭스
Gemini CLI에서 다음에 게시: Facebook · Instagram · Threads · YouTube · X · LinkedIn · Pinterest · Bluesky · Telegram. 또는 Gemini CLI가 게시할 수 있는 모든 채널을 확인하세요.
다음에서 TikTok에 게시: 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 스킬 5개가 추가되고, npx -y hermoso auth login으로 한 번 로그인하세요. 로그인은 브라우저를 열고 자격 증명을 직접 저장하므로, 만들 키도 붙여넣을 키도 없어요. Gemini CLI 자체 도구 목록에도 Hermoso 도구를 넣고 싶다면 gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcp가 호스팅 서버를 추가하며, 이 서버는 OAuth로 로그인해요. 그다음 Hermoso 안의 설정 → 커넥터에서 Facebook을 연결하세요. 브라우저에서 열리는 OAuth 동의 화면이에요. 그 뒤로 Gemini CLI는 TikTok 게시를 일반 도구 호출처럼 처리해요.
Claude에서 Facebook에 게시할 때 캡션 글자 수 제한은 얼마인가요?
TikTok 영상 캡션은 2,200자, 사진 게시물 캡션은 4,000자까지 가능합니다. Hermoso는 게시물을 만들거나 예약할 때 이를 적용하므로, ChatGPT는 나중에 아무도 지켜보지 않을 때 실패하는 대신 즉시 알림을 받습니다.
ChatGPT가 게시하기 전에 Facebook을 조사할 수 있나요?
네, 유기적으로 가능합니다. Hermoso에는 TikTok 광고 라이브러리 검색이 없습니다. search_tiktok은 키워드로 잘 되는 것을 찾고, analyze_video는 클립을 훅, 비트, 화면 텍스트로 나눕니다.
Claude로 Facebook에 비공개로 또는 초안으로 게시할 수 있나요?
네. TikTok 게시물은 모든 사람, 팔로워, 친구, 또는 나만 볼 수 있도록 게시하거나, 대신 초안으로 보낼 수 있습니다. TikTok은 계정이 허용하는 수준 중에서 각 게시물의 공개 범위를 크리에이터가 직접 고르도록 하므로, Hermoso는 대신 고르지 않고 묻습니다. Hermoso는 TikTok이 지킬 수 없는 공개 범위를 요청받는 순간 거부하며, 더 약한 설정으로 몰래 게시하지 않습니다.
ChatGPT가 게시뿐 아니라 TikTok 광고도 운영할 수 있나요?
네. TikTok Ads는 Hermoso가 관리하는 열두 개의 유료 플랫폼 중 하나이며, 유기적 TikTok 게시와는 별도로 연결됩니다. 두 부분은 각각 자체 TikTok 승인을 거치며, Hermoso는 하나에서 다른 하나를 추론하지 않고 각각 따로 보고합니다.