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의 설정 → 커넥터에서 핸들과 Bluesky 앱 비밀번호로 Bluesky를 한 번 연결하세요. 동의 화면은 없습니다. 앱 비밀번호는 Bluesky 자체 설정에서 만들며, 실제 비밀번호에 영향을 주지 않고 그곳에서 취소할 수 있습니다.
Claude가 받는 Bluesky 도구
post_to_bluesky: 연결된 계정으로 게시물을 올립니다. 최대 300자, 대체 텍스트가 있는 이미지 최대 4장, 또는 선택적 자막 트랙이 있는 MP4 영상 1개입니다. 미디어 없이 링크만 있으면 미리보기 카드가 붙으며, Bluesky가 가져오지 않으므로 Hermoso가 만듭니다.schedule_post: 다른 모든 채널과 공유하는 캘린더에 대기열로 넣으며, 300자 제한은 실행 시점이 아니라 대기열에 넣을 때 확인됩니다.list_bluesky_posts: 계정 자체의 최근 게시물을 AT-URI와 실시간 수치와 함께 보여 줍니다. 리포스트는 표시되므로, 다른 사람의 게시물이 내 것으로 잘못 읽히지 않습니다.bluesky_post_metrics / bluesky_account: 게시물별 좋아요, 리포스트, 답글, 인용, 북마크와, 내 계정 또는 공개 계정의 팔로워, 팔로잉, 게시물 수입니다.list_bluesky_convos / read_bluesky_dm / send_bluesky_dm: 다이렉트 메시지를 읽고 답합니다. 계정이 팔로우하지 않는 사람이 보낸 메시지 요청도 포함됩니다.manage_bluesky_convo / react_to_bluesky_dm / mark_bluesky_convo_read: 요청을 수락하고, 대화를 음소거, 잠금, 나가기 하며, 이모지 하나로 반응하고, 읽지 않음 표시를 지웁니다.delete_bluesky_post: 게시물을 삭제합니다. 먼저 아무것도 삭제하지 않고 무엇이 삭제될지 다시 읽어 보여 주는 호출이 한 번 있습니다.
Bluesky는 로그인 화면이 아니라 앱 비밀번호로 연결합니다. Bluesky 설정에서 만든 뒤 핸들과 함께 설정 → 커넥터에 붙여넣으세요. 만들 때 다이렉트 메시지 접근을 체크하세요. 그렇지 않으면 DM 도구가 이 비밀번호로는 채팅할 수 없다고 알려 주는데, 이는 연결이 고장 난 것이 아니라 비밀번호의 속성입니다. Hermoso가 보내기 전에 확인하는 Bluesky 규칙이 두 가지 더 있습니다. 영상에는 Bluesky 계정의 확인된 이메일이 필요하고, 링크 카드와 이미지는 한 게시물에 함께 들어갈 수 없습니다. 게시에는 크레딧이 들지 않습니다. Bluesky는 호출마다 요금을 받지 않기 때문입니다.
자동화하기 전에 알아 둘 Bluesky 제한
| 텍스트 | Bluesky 게시물은 300자와, 별도로 3,000바이트로 제한됩니다. 그래서 이모지가 많은 게시물은 300자 미만이어도 너무 길 수 있습니다. 이 제한은 게시물을 만들거나 예약할 때 적용되므로, 글자 수를 넘은 게시물은 나가는 도중 몰래 잘리는 대신 여러분이 아직 옆에 있을 때 거부됩니다. |
|---|---|
| 공개 범위 | 공개만 가능합니다. Bluesky 게시물은 AT Protocol의 공개 기록이며, 일부 공개, 비공개, 초안 형태는 없습니다. 검토는 호출 후가 아니라 호출 전에 합니다. |
| 캐러셀 | 이미지 2~4장, 이미지만. 네 장은 Bluesky 자체의 숫자이며, 이미지 임베드에 대한 AT Protocol 렉시콘에서 나온 것입니다. 다섯 장은 버려지지 않고 거부됩니다. 영상은 클립 하나만 담는 다른 임베드이고, 게시물에는 임베드가 하나만 들어갈 수 있으므로, Bluesky 게시물은 이미지, 영상 1개, 링크 카드 중 하나입니다. |
| 어느 계정 | 보통은 없습니다. 브랜드가 Bluesky 계정을 둘 이상 연결한 경우에만 account가 어느 계정인지 지정합니다. 여러 개인데 지정하지 않으면 추측하지 않고 이름을 밝혀 거부합니다. |
Claude에서 해 보기
일상 언어로 요청하세요. 이것은 DSL이 아니라 평범한 문장입니다:
“무인 실행: 새 태그마다 릴리스 페이지로 가는 링크 카드를 붙인 300자 이내 Bluesky 업데이트를 하나 게시하고, 게시물 URL을 JSON으로 출력해 줘.”
이 작업은 get_brand → generate_image → post_to_bluesky → bluesky_post_metrics 순서로 진행됩니다. 대화형으로 쓰면 Codex가 실행 전에 호출을 보여 줍니다. 비대화형으로 쓰면 확인해 줄 사람이 없으므로, 게시하거나 지출하는 모든 단계는 그 점을 고려해 설계해야 합니다.
Facebook에서의 Codex: 까다로운 부분
Bluesky 영상에는 어떤 재시도로도 풀리지 않는 함정이 있습니다. 이메일이 확인되지 않은 계정의 영상은 Bluesky가 처리하지 않습니다. Hermoso는 이를 실패한 업로드가 아니라 원인을 밝힌 거부로 알려 주며, 이것은 Bluesky 계정의 설정 값이므로 다시 연결해도 해결되지 않습니다. 작업을 영상에 연결하기 전에 이메일을 한 번 확인하세요. 텍스트와 이미지 게시물에는 이런 제한이 없습니다.
무인 실행이라면 전체 도구 매니페스트보다 --json을 붙인 hermoso CLI를 쓰세요. 컨텍스트를 훨씬 적게 차지하고 검증하기도 쉽습니다.
게시하기 전에 Bluesky 리서치하기
Bluesky 광고 라이브러리도 Bluesky 검색도 Hermoso에는 없으므로, 그곳의 경쟁사 조사는 한 가지 정직한 기능으로 좁혀집니다. bluesky_account는 공개 계정의 팔로워, 팔로잉, 게시물 수를 읽으므로, 경쟁사의 규모를 가늠하고 주 단위로 추이를 추적하기에 충분합니다. 나머지 조사 기능(Meta, Google, LinkedIn 광고 라이브러리, 유기적 TikTok, Instagram, YouTube, Reddit, Threads)은 그대로입니다.
유료 부분
Hermoso에는 Bluesky 광고 제품이 없으며, 있는 것처럼 말하지 않습니다. 여기서 Bluesky는 유기적 채널입니다. 게시, 예약, 읽기, 답글, 측정을 합니다. 유료 도구는 Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads, AppLovin Ads를 다룹니다.
Codex 혼자서는 할 수 없는 일
예산이 있는 에이전트는 영향 범위가 제한되어 있을 때만 쓸모가 있으므로, 울타리는 프롬프트가 아니라 서버에 둡니다. 모든 광고 캠페인, 광고 세트, 광고 그룹, 광고는 일시 중지 상태로 만들어지며, 실제 돈이 움직이는 상태 변경은 명시적인 확인 표시 없이는 실행되지 않습니다. 모든 렌더는 먼저 견적을 받습니다(hermoso_capabilities가 비용이 쓰이기 전에 모델별 정확한 크레딧 비용을 공개합니다). 크레딧은 첫 제공자 호출 전에 예약되고 이후 정확한 비용으로 정산되므로, 전송이 실패하면 환불되며 아무것도 없이 청구되지 않습니다. 삭제도 확인이 필요하며, 에이전트가 무엇을 만들었다고 말하기 전에 모든 캠페인 구조를 광고 플랫폼에서 다시 읽어 옵니다.
한 단계는 의도적으로 여러분이 직접 해야 합니다. Bluesky 앱 비밀번호를 만들고 한 번 연결하는 것입니다. 그 이후는 모두 도구 호출입니다.
나머지 매트릭스
Codex에서 게시: Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Telegram. 또는 Codex가 게시할 수 있는 모든 곳을 보세요.
다음에서 Bluesky에 게시: 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를 실행하세요. 그다음 Bluesky 설정에서 앱 비밀번호를 만들고(DM 도구가 필요하면 다이렉트 메시지 접근 권한을 체크하세요), 핸들과 함께 Hermoso의 설정 → 커넥터에 붙여넣으세요. 그 뒤로 Codex는 Bluesky 게시를 일반 도구 호출로 처리합니다.
Claude에서 Facebook에 게시할 때 캡션 글자 수 제한은 얼마인가요?
Bluesky 게시물은 300자와 3,000바이트로 제한됩니다. 그래서 이모지가 많은 게시물은 300자 미만이어도 거부될 수 있습니다. Hermoso는 어떤 제한이 적용되었는지, 그리고 얼마나 초과했는지 알려 줍니다. 게시물을 만들거나 예약할 때 제한을 적용하므로, Claude는 나중에 아무도 지켜보지 않을 때 실패하는 대신 즉시 알림을 받습니다.
Claude로 Bluesky 게시물을 나중에 예약할 수 있나요?
네. schedule_post는 다른 모든 채널과 함께 쓰는 하나의 일정표에 올리며, 문구를 다르게 해야 하면 채널별 캡션을 붙일 수 있습니다. list_scheduled와 cancel_scheduled로 읽고 취소할 수 있습니다. Facebook은 대기열에 들어갈 수 있는 열한 개 채널 중 하나입니다.
Claude로 Facebook에 비공개로 또는 초안으로 게시할 수 있나요?
아니요. Bluesky 게시물은 AT Protocol의 공개 기록이며 일부 공개, 비공개, 초안 형태가 없습니다. 따라서 검토는 호출 전에 해야 합니다. Hermoso는 Bluesky가 지킬 수 없는 공개 범위를 요청받는 순간 거부하며, 더 약한 설정으로 몰래 게시하지 않습니다.
Claude로 Facebook에 게시하는 데 비용이 얼마인가요?
Bluesky에 게시하는 데는 크레딧이 들지 않습니다. Bluesky는 호출마다 요금을 받지 않습니다. 크레딧은 크리에이티브 생성에 쓰입니다. 플랜은 월 $29, $69, $149이며 각각 1,200, 3,000, 7,000 크레딧을 제공하고, Free 플랜을 포함한 모든 플랜에서 모든 기능을 쓸 수 있습니다. 예외는 엔터프라이즈 SSO뿐입니다.