Hermoso는 마케팅 MCP 서버입니다. 하나의 OAuth 엔드포인트를 통해 922+개 도구를 제공하며, 에이전트가 시장에서 이미 달리는 광고를 리서치하고, 완성된 이미지와 영상 광고를 만들고, 게시하고, 그 뒤의 유료 캠페인을 만들 수 있게 해 줍니다. Claude는 연결 하나로 이 모든 것에 접근합니다. 이 페이지는 그중 한 부분, 즉 Claude가 Facebook에서 실제로 무엇을 할 수 있고 Facebook이 무엇을 허용하지 않는지를 다룹니다.
Claude에 Hermoso 연결하기
- 명령어 한 줄, 키는 필요 없습니다.
Codex는 Hermoso 공개 저장소의 마켓플레이스 파일을 읽고 스킬 다섯 개(research, ad-from-brand, generate, product-photoshoot, marketing)를 설치합니다. 스킬은codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermosonpx를 통해hermoso명령을 실행하므로, 세션에 도구 목록이 로드되지 않고 명령이 실행되기 전까지는 컨텍스트를 전혀 차지하지 않습니다. - 한 번 로그인하세요.
브라우저에서 로그인하며, 소유자만 읽을 수 있는 인증 정보를npx -y hermoso auth login~/.hermoso/config.json에 저장합니다. CI나 컨테이너처럼 브라우저가 없는 환경이라면 MCP & CLI → 터미널 & API 키에서 키를 만들고npx -y hermoso auth login --token hmk_…를 실행하세요. 키에는 실제 지출 권한이 있으므로 비밀번호처럼 다루세요. - 선택 사항: MCP 서버도 추가하세요.
그러면codex mcp add hermoso -- npx -y hermoso mcp~/.codex/config.toml에 서버가 기록되고, 같은 저장된 인증 정보를 읽으므로 파일에 키가 들어가지 않습니다. 호스팅된 엔드포인트를 원하시나요?codex mcp add hermoso --url https://app.hermoso.ai/mcp를 실행한 다음 OAuth 로그인을 위해codex mcp login hermoso를 실행하세요. 스킬은 이 둘 중 무엇이 없어도 모든 도구에 접근합니다. - Claude에 무언가를 요청하세요. “가장 가까운 경쟁사 세 곳의 가장 오래 달리는 광고를 찾아서, 가장 좋은 훅을 9:16 영상으로 리믹스해 줘” 또는 “이 렌더를 채널에 올려 줘”. 에이전트가 도구를 고르고, 지출은 당신이 승인합니다.
Codex는 MCP 서버를 ~/.codex/config.toml, 또는 신뢰된 프로젝트의 .codex/config.toml에 보관하며, 이 파일은 JSON이 아니라 TOML입니다. 복사한 mcpServers 블록은 로드되지 않으며, 직접 작성한다면 항목은 [mcp_servers.hermoso]이고 command = "npx"와 args = ["-y", "hermoso", "mcp"]를 넣어야 합니다. 끝의 mcp는 필수입니다. npx -y hermoso만 입력하면 도움말을 출력하고 종료합니다. Codex는 Claude Code가 쓰는 .claude-plugin 구조와 같은 플러그인 마켓플레이스를 읽으므로, 저장소 하나로 둘 다 설치됩니다.
그다음 Hermoso의 설정 → 커넥터에서 Instagram 자체를 한 번 연결하세요. 이것은 OAuth 승인 화면이라서 브라우저가 필요한 유일한 단계입니다. 그 이후의 모든 작업은 도구 호출입니다.
Claude가 받는 Instagram 도구
post_to_meta:target: "instagram"으로 Instagram에 게시합니다. Instagram은 시각 채널이며 API도 그렇게 판단합니다. 게시물에는 이미지나 영상이 있어야 합니다.schedule_post: 공유 일정표에 대기열로 넣습니다. 문구가 Facebook이나 LinkedIn 버전과 달라야 하면 채널별 캡션을 붙일 수 있습니다.list_meta_comments / reply_to_meta_comment / moderate_meta_comment: 게시물 아래 댓글을 읽고, 답하고, 관리합니다.meta_page_insights / meta_post_insights: 계정별, 게시물별 도달, 노출, 저장, 참여.search_instagram: 공개 Instagram 릴스를 키워드로 검색합니다. 게시가 아니라 리서치용입니다.
Instagram에 대해 자동화하기 전에 알아 둘 사실 두 가지. Meta의 API에는 네이티브 Instagram 예약이 없으므로, 예약은 Instagram의 것이 아니라 Hermoso의 대기열입니다. Instagram에 Facebook용 scheduleAt을 넘기면, 몰래 지금 게시하는 대신 거부합니다. 그리고 게시된 뒤에는 Instagram 캡션을 수정할 수 없습니다. Meta가 게시된 게시물에서 바꾸게 해 주는 것은 댓글 허용 여부뿐입니다. 삭제는 지원됩니다. manage_meta_post가 일반 게시물, 스토리, 릴스, 캐러셀 앨범 전체를 지울 수 있지만, 앨범에서 카드 한 장만 빼내지는 않습니다.
자동화하기 전에 알아 둘 Instagram 제한
| 텍스트 | Instagram 캡션은 2,200자로 제한됩니다. 게시물을 만들거나 대기열에 넣을 때 강제되므로, 너무 긴 게시물은 전송 중에 몰래 잘리는 대신 여러분이 아직 옆에 있을 때 거부됩니다. |
|---|---|
| 공개 범위 | 공개만 가능합니다. Meta의 Content Publishing API는 즉시 게시하거나 아예 게시하지 않으며, Instagram에는 “미공개, 비공개 또는 초안 게시물이 없습니다.” Instagram에서 검토 단계를 원한다면, 호출 뒤가 아니라 호출 전에 해야 합니다. |
| 캐러셀 | 슬라이드 2장에서 10장, 이미지와 영상을 섞을 수 있습니다. 이 상한은 Hermoso가 강제하는 기능 표에 인용된 Meta 자체의 한도입니다. “캐러셀은 이미지, 영상, 또는 둘의 혼합 10개로 제한됩니다.” 하한 2는 우리 기준입니다. 한 장짜리는 어느 플랫폼에서도 캐러셀이 아니기 때문입니다. 슬라이드 한 장을 요청하면 거부되지 않고 일반 게시물로 게시됩니다. |
| 어느 계정 | pageId. Instagram은 연결된 Facebook Page를 통해 게시하므로, 같은 식별 필드로 선택합니다. |
Claude에서 해 보기
일상 언어로 요청하세요. 이것은 DSL이 아니라 평범한 문장입니다:
“무인 실행: 오늘의 제품 사진으로 슬라이드 네 장짜리 캐러셀을 만들고, 캡션은 2,200자 이내로 하여 Instagram에 게시한 다음, 퍼머링크를 출력하고 종료해 줘.”
이 작업은 search_instagram → plan_ad → render_ad → post_to_meta(target: "instagram") 순서로 진행됩니다. 대화형으로 쓰면 Codex가 실행 전에 호출을 보여 줍니다. 비대화형으로 쓰면 확인해 줄 사람이 없으므로, 게시하거나 지출하는 모든 단계는 그 점을 고려해 설계해야 합니다.
Facebook에서의 Codex: 까다로운 부분
무인 파이프라인에는 사람이 개입하는 단계가 하나 필요합니다. Instagram은 게시된 캡션을 API로 수정할 수 없습니다. Codex가 타이머로 돌고 있다면 검토를 게시 앞에 두세요. 만들어서 보관해 두고, 승인되면 게시합니다. 삭제만이 되돌리는 방법입니다. manage_meta_post는 일반 게시물, 스토리, 릴스, 캐러셀 앨범 전체를 삭제할 수 있지만, 삭제하면 좋아요와 댓글도 함께 사라집니다.
무인 실행이라면 전체 도구 매니페스트보다 --json을 붙인 hermoso CLI를 쓰세요. 컨텍스트를 훨씬 적게 차지하고 검증하기도 쉽습니다.
게시하기 전에 Instagram 리서치하기
search_meta_ads는 하나의 라이브러리이므로 Facebook뿐 아니라 Instagram 노출도 다룹니다. 오가닉은 search_instagram이 공개 릴스를 키워드로 검색하며, 이 포맷이 실제로 움직이는 곳입니다. 프로필과 해시태그 조회는 fetch_social_data와 search_instagram_hashtag로 합니다.
유료 부분
Instagram 노출은 Facebook과 같은 Meta 캠페인 구조로 구매합니다. create_meta_campaign → create_meta_adset → create_meta_ad이며, 노출 위치는 플랫폼별, 위치별로 고를 수 있습니다. preview_meta_ad가 지출 전에 노출 위치별 실제 렌더 광고를 보여 주고, meta_insights는 결과를 나이, 성별, 노출 위치, 국가별로 나눠 보여 줍니다. 그 분석이 다음 크리에이티브의 방향을 정합니다.
Codex 혼자서는 할 수 없는 일
예산이 있는 에이전트는 영향 범위가 제한되어 있을 때만 쓸모가 있으므로, 울타리는 프롬프트가 아니라 서버에 둡니다. 모든 광고 캠페인, 광고 세트, 광고 그룹, 광고는 일시 중지 상태로 만들어지며, 실제 돈이 움직이는 상태 변경은 명시적인 확인 표시 없이는 실행되지 않습니다. 모든 렌더는 먼저 견적을 받습니다(hermoso_capabilities가 비용이 쓰이기 전에 모델별 정확한 크레딧 비용을 공개합니다). 크레딧은 첫 제공자 호출 전에 예약되고 이후 정확한 비용으로 정산되므로, 전송이 실패하면 환불되며 아무것도 없이 청구되지 않습니다. 삭제도 확인이 필요하며, 에이전트가 무엇을 만들었다고 말하기 전에 모든 캠페인 구조를 광고 플랫폼에서 다시 읽어 옵니다.
일부러 헤드리스로 하지 않는 단계가 하나 있습니다: 계정 연결은 OAuth 승인 화면이므로, 채널은 브라우저에서 한 번 연결합니다. 그 이후의 모든 작업은 도구 호출입니다.
나머지 매트릭스
Codex에서 게시: Facebook · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky · Telegram. 또는 Codex가 게시할 수 있는 모든 곳을 보세요.
다음에서 Instagram에 게시: Claude · ChatGPT · Claude Code · Cursor · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · 명령줄에서 광고 만들기
자주 묻는 질문
Claude에서 Facebook에 게시할 수 있나요?
네, Hermoso의 Codex 플러그인으로 가능합니다. codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso를 실행하면 Hermoso의 스킬이 설치되고, 이어서 npx -y hermoso auth login으로 한 번 로그인하세요. 로그인은 브라우저를 열고 인증 정보를 직접 저장하므로 키를 만들거나 붙여넣을 필요가 없습니다. MCP 서버도 쓰려면 codex mcp add hermoso -- npx -y hermoso mcp를 실행하세요. 그러면 Codex에 922개 이상의 도구가 생기며, Facebook에 게시하는 도구뿐 아니라 시장에서 이미 돌고 있는 광고를 조사하고 크리에이티브를 렌더링하는 도구도 포함됩니다.
Facebook을 Claude에 어떻게 연결하나요?
두 단계이며 각각 한 번씩만 하면 됩니다. codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso를 실행하면 Hermoso의 스킬이 설치되고, 이어서 npx -y hermoso auth login으로 한 번 로그인하세요. 로그인은 브라우저를 열고 인증 정보를 직접 저장하므로 키를 만들거나 붙여넣을 필요가 없습니다. MCP 서버도 쓰려면 codex mcp add hermoso -- npx -y hermoso mcp를 실행하세요. 그다음 Hermoso의 설정 → 커넥터에서 Facebook을 연결하세요. 브라우저에서 OAuth 동의 화면이 열립니다. 그 뒤로 Codex는 Instagram 게시를 일반 도구 호출로 처리합니다.
Claude로 Instagram에 캐러셀을 게시할 수 있나요?
네, 슬라이드 2장에서 10장까지 가능하며, 이미지와 영상을 섞을 수 있습니다. 10은 Hermoso가 만든 한도가 아니라 Meta가 공개한 한도입니다. Claude는 어느 쪽이든 같은 게시 도구를 호출하며, 캐러셀을 실을 수 없는 채널은 실제 이유와 함께 거부됩니다.
Claude로 Facebook에 게시하는 데 비용이 얼마인가요?
Instagram 게시에는 크레딧이 들지 않습니다. Meta는 API 호출마다 아무것도 청구하지 않기 때문입니다. 크레딧은 렌더 자체에 씁니다. 플랜은 월 $29, $69, $149이며, 각각 1,200, 3,000, 7,000 크레딧을 줍니다. Free 플랜을 포함한 모든 플랜에 모든 기능이 들어 있습니다. 예외는 엔터프라이즈 SSO뿐입니다.
Claude에 Instagram 비밀번호를 줘야 하나요?
아니요. Instagram은 브라우저의 OAuth 승인 화면을 통해 Hermoso에 한 번 연결하고, 그 뒤로 Claude는 도구 호출로 접근합니다. 계정을 연결하는 것은 헤드리스로 할 수 없는 유일한 단계이며, 그 뒤로는 어떤 것도 비밀번호를 요구하지 않고, 모델에 자격 증명이 넘어가지 않습니다.
Claude로 Instagram 게시물을 나중에 예약할 수 있나요?
네. schedule_post는 다른 모든 채널과 함께 쓰는 하나의 일정표에 올리며, 문구를 다르게 해야 하면 채널별 캡션을 붙일 수 있습니다. list_scheduled와 cancel_scheduled로 읽고 취소할 수 있습니다. Facebook은 대기열에 들어갈 수 있는 열한 개 채널 중 하나입니다.