Hermoso는 마케팅 MCP 서버입니다. 하나의 OAuth 엔드포인트를 통해 922+개 도구를 제공하며, 에이전트가 시장에서 이미 달리는 광고를 리서치하고, 완성된 이미지와 영상 광고를 만들고, 게시하고, 그 뒤의 유료 캠페인을 만들 수 있게 해 줍니다. Claude는 연결 하나로 이 모든 것에 접근합니다. 이 페이지는 그중 한 부분, 즉 Claude가 Facebook에서 실제로 무엇을 할 수 있고 Facebook이 무엇을 허용하지 않는지를 다룹니다.
Claude에 Hermoso 연결하기
- 명령 한 줄, 키는 필요 없습니다.
이미 세션 안에 있나요?claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso/plugin marketplace add hermoso-ai/hermoso를 입력한 다음/plugin install hermoso@hermoso를 입력하세요. 이 명령은 Hermoso 스킬 다섯 개(research, ad-from-brand, generate, product-photoshoot, marketing)를 설치하며, 이 스킬들은npx를 통해hermoso명령을 실행합니다. 그래서 세션에 도구 목록이 불러와지지 않고, 실행되기 전까지는 컨텍스트를 전혀 차지하지 않습니다. - 한 번만 로그인하세요.
루프백 주소에서 브라우저 로그인을 엽니다.npx -y hermoso auth logingh와 같은 방식이며, 소유자만 읽을 수 있는 자격 증명을~/.hermoso/config.json에 저장합니다. Claude Code는 Hermoso가 처음 필요할 때 이를 대신 실행합니다. CI, 원격 서버, 컨테이너처럼 그 컴퓨터에 브라우저가 없나요? MCP & CLI → Terminal & API keys에서 키를 만들고npx -y hermoso auth login --token hmk_…를 실행하세요. 키는 실제 지출 권한을 가지므로 비밀번호처럼 다루세요. - 선택 사항: MCP 서버도 함께. Hermoso의 도구를 Claude Code 자체의 도구 목록에도 넣고 싶다면, 로그인한 뒤
claude mcp add hermoso -- npx -y hermoso mcp를 실행하세요. 같은 저장된 자격 증명을 읽으므로.claude.json에 키가 들어가지 않습니다. 스킬만으로도 이것 없이 모든 도구에 닿습니다. - Claude에 무언가를 요청하세요. “가장 가까운 경쟁사 세 곳의 가장 오래 달리는 광고를 찾아서, 가장 좋은 훅을 9:16 영상으로 리믹스해 줘” 또는 “이 렌더를 채널에 올려 줘”. 에이전트가 도구를 고르고, 지출은 당신이 승인합니다.
플러그인과 선택 사항인 MCP 서버는 같은 도구와 같은 계정에 닿습니다. 차이는 컨텍스트입니다. 도구 목록은 입력하기 전에 모든 세션에 불러와지지만, 스킬은 명령이 실행될 때까지 아무 비용도 들지 않습니다.
그다음 Hermoso의 설정 → 커넥터에서 Facebook 자체를 한 번 연결하세요. 이것은 OAuth 승인 화면이라서 브라우저가 필요한 유일한 단계입니다. 그 이후의 모든 작업은 도구 호출입니다.
Claude가 받는 Facebook 도구
post_to_meta: 텍스트, 이미지, 영상, 또는 여러 장 사진 게시물을 Page에 게시합니다.pageId를 받으므로 어느 Page인지 추측할 필요가 없습니다.schedule_post: 같은 게시물을 원하는 시간에 맞춰 대기열에 넣습니다. 다른 모든 채널과 공유하는 하나의 일정표에 올라갑니다.list_meta_pages: 계정에 연결된 Page를 ID와 함께 나열합니다.manage_meta_post: 게시된 게시물의 문구를 수정하거나 삭제합니다.list_meta_comments / reply_to_meta_comment / moderate_meta_comment: 게시물 아래 댓글을 읽고, Page 이름으로 답하며, 있으면 안 되는 댓글은 숨기거나 삭제합니다.meta_page_insights / meta_post_insights: Page 수준과 게시물별 도달, 노출, 참여.upload_meta_asset: 완성된 렌더를 광고 계정의 자산 라이브러리에 넣습니다.
Facebook은 네이티브 원격 예약을 지원하는 유일한 채널이기도 합니다. post_to_meta는 지금부터 10분에서 30일 사이의 scheduleAt을 받고, 시간 설정은 Meta가 직접 처리합니다. Instagram과 Threads는 Meta의 API에 그런 기능이 없으며, 그것을 전달하면 몰래 즉시 게시하는 대신 거부합니다.
자동화하기 전에 알아 둘 Facebook 제한
| 텍스트 | Facebook 게시물은 63,206자까지 가능하며, 사실상 제한이 없습니다. 게시물을 만들거나 대기열에 넣을 때 강제되므로, 너무 긴 게시물은 전송 중에 몰래 잘리는 대신 여러분이 아직 옆에 있을 때 거부됩니다. |
|---|---|
| 공개 범위 | 공개 또는 초안. 초안은 게시되지 않은 실제 Page 게시물로, 검토에 유용합니다. Meta Business Suite에 존재하며 밖에서는 아무도 볼 수 없습니다. 미공개 링크나 비공개 옵션은 없습니다. “Facebook Page 게시물은 공개로 게시되거나, 게시되지 않은 초안으로 보류되거나, 둘 중 하나입니다.” |
| 캐러셀 | 2장 이상, 사진만. Meta는 우리가 확인할 수 있는 attached_media의 최대치를 공개하지 않으므로, Hermoso는 하나를 지어내 Facebook 탓으로 돌리지 않습니다. 유일한 제한은 우리의 30장이며, 거부 메시지는 그것이 누구의 제한인지 말합니다. “Facebook은 attached_media의 문서화된 최대치를 공개하지 않으므로, 이 제한은 그들의 것이 아니라 우리의 것입니다.” 영상은 Facebook 사진 캐러셀에 들어갈 수 없습니다. 이것은 Meta API의 또 다른 한계이며, Hermoso는 클립을 조용히 빼는 대신 거부합니다. |
| 어느 계정 | pageId. 브랜드가 Page를 두 개 이상 연결하면 중요해집니다. 게시 경로는 하나를 대신 고르지 않고 이름으로 거부합니다. 일정이 그 답을 담지 못하면, 그 거부는 몇 시간 뒤 아무도 지켜보지 않을 때 실패로 바뀝니다. |
Claude에서 해 보기
일상 언어로 요청하세요. 이것은 DSL이 아니라 평범한 문장입니다:
“./renders의 mp4를 가져와서 브랜드 목소리로 캡션을 쓰고, 페이지에 게시하지 않은 초안으로 올린 다음, 게시물 ID를 ./out/posts.json에 기록해 줘.”
이 요청은 find_competitors → search_meta_ads → plan_ad → render_ad → list_meta_pages → post_to_meta 순서로 진행됩니다. Claude Code는 도구를 실행하기 전에 묻고, 기록은 터미널에 그대로 남으므로 게시 단계는 y를 누르기 전에 읽을 수 있는 한 줄입니다.
Facebook에서의 Claude Code: 까다로운 부분
이 지점에서 터미널 에이전트는 채팅보다 실제로 낫습니다. 게시물 ID가 구조화된 결과로 돌아오므로, 파일에 기록해 두고 나중에 검사할 수 있습니다. Facebook은 네이티브 원격 예약을 지원하는 유일한 채널이기도 합니다(post_to_meta는 10분에서 30일 사이의 scheduleAt을 받습니다). 그래서 스크립트가 대기열을 직접 들고 있는 대신 시간 설정을 Meta에 맡길 수 있습니다.
플러그인에는 도구 매니페스트가 없으며, 이는 사람이 지켜보지 않는 긴 실행에서 가장 중요합니다. 에이전트는 각 단계마다 hermoso 명령을 호출하고, 모든 명령의 --json 옵션이 검사할 수 있는 기계 출력을 줍니다.
게시하기 전에 Facebook 리서치하기
Meta 광고 라이브러리는 존재하는 가장 풍부한 공개 크리에이티브 아카이브이며, search_meta_ads는 키워드나 페이지로 읽고 Facebook과 Instagram 노출을 모두 다룹니다. pull_competitor_ads와 competitor_teardown이 그 위에 만들어지고, find_competitors는 누구를 겨냥할지 알아냅니다.
유료 부분
Facebook은 Hermoso가 가진 가장 깊은 유료 채널입니다. create_meta_campaign, create_meta_adset, create_meta_ad가 실제 타깃팅으로 전체 구조를 만듭니다. 도시 반경까지의 지역, 관심사, 행동, 맞춤 타깃과 유사 타깃, 노출 위치, 시간대별 노출, 입찰과 비용 상한을 포함합니다. 모든 항목은 호출자가 무시할 수 없이 일시 중지 상태로 만들어지며, 에이전트가 보고하는 요약은 요청한 내용이 아니라 Meta가 실제로 저장한 내용을 다시 읽어 와서 만듭니다. 예산을 확정하기 전에 preview_meta_ad가 노출 위치별로 실제 광고를 링크로 렌더링해 보여 주고, estimate_meta_reach가 타깃팅이 실제로 도달하는 사람 수를 알려 줍니다. 돈을 아끼는 경고 하나: 지역을 비워 둔 광고 세트는 기본으로 미국만 대상이 되며, 다시 읽기 결과가 이를 크게 알려 줍니다.
Claude Code 혼자서는 할 수 없는 일
예산이 있는 에이전트는 영향 범위가 제한되어 있을 때만 쓸모가 있으므로, 울타리는 프롬프트가 아니라 서버에 둡니다. 모든 광고 캠페인, 광고 세트, 광고 그룹, 광고는 일시 중지 상태로 만들어지며, 실제 돈이 움직이는 상태 변경은 명시적인 확인 표시 없이는 실행되지 않습니다. 모든 렌더는 먼저 견적을 받습니다(hermoso_capabilities가 비용이 쓰이기 전에 모델별 정확한 크레딧 비용을 공개합니다). 크레딧은 첫 제공자 호출 전에 예약되고 이후 정확한 비용으로 정산되므로, 전송이 실패하면 환불되며 아무것도 없이 청구되지 않습니다. 삭제도 확인이 필요하며, 에이전트가 무엇을 만들었다고 말하기 전에 모든 캠페인 구조를 광고 플랫폼에서 다시 읽어 옵니다.
일부러 헤드리스로 하지 않는 단계가 하나 있습니다: 계정 연결은 OAuth 승인 화면이므로, 채널은 브라우저에서 한 번 연결합니다. 그 이후의 모든 작업은 도구 호출입니다.
나머지 매트릭스
Claude Code에서 게시하기: Instagram · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky · Telegram. 또는 Claude Code가 게시할 수 있는 모든 채널을 보세요.
Facebook에 게시하기: Claude · ChatGPT · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · Claude Code 마케팅
자주 묻는 질문
Claude에서 Facebook에 게시할 수 있나요?
네, Hermoso의 Claude Code 플러그인을 사용하면 가능합니다. 명령 한 줄: claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso, 또는 세션 안에서 /plugin marketplace add hermoso-ai/hermoso 다음 /plugin install hermoso@hermoso. hermoso CLI를 구동하는 Hermoso 스킬 다섯 개를 설치하므로 세션에 도구 목록이 불러와지지 않습니다. npx -y hermoso auth login으로 한 번 로그인하면 브라우저가 열리고 자격 증명을 직접 저장하므로, 만들 키도 붙여넣을 키도 없습니다. 그러면 Claude Code는 922+개 도구를 쓸 수 있으며, 여기에는 Facebook에 게시하는 도구뿐 아니라 시장에서 이미 돌고 있는 광고를 조사하고 크리에이티브를 처음 렌더링하는 도구도 포함됩니다.
Facebook을 Claude에 어떻게 연결하나요?
두 단계이며 각각 한 번씩만 하면 됩니다. 명령 한 줄: claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso, 또는 세션 안에서 /plugin marketplace add hermoso-ai/hermoso 다음 /plugin install hermoso@hermoso. hermoso CLI를 구동하는 Hermoso 스킬 다섯 개를 설치하므로 세션에 도구 목록이 불러와지지 않습니다. npx -y hermoso auth login으로 한 번 로그인하면 브라우저가 열리고 자격 증명을 직접 저장하므로, 만들 키도 붙여넣을 키도 없습니다. 그다음 Hermoso의 설정 → 커넥터에서 Facebook을 연결하세요. 브라우저에서 열리는 OAuth 동의 화면입니다. 그 뒤로 Claude Code는 일반 도구 호출로 Facebook에 게시합니다.
Claude로 Facebook에 비공개로 또는 초안으로 게시할 수 있나요?
네. Facebook은 실제 초안이 있는 유일한 채널입니다. 게시되지 않은 Page 게시물로, Meta Business Suite에 존재하며 밖에서는 아무도 볼 수 없습니다. Hermoso는 Facebook이 지금 지킬 수 없는 공개 범위를 요청받으면, 몰래 더 약한 것을 게시하는 대신 요청한 시점에 거부합니다.
Claude로 Facebook에 게시하는 데 비용이 얼마인가요?
Facebook 게시에는 크레딧이 들지 않습니다. Meta는 API 호출마다 아무것도 청구하지 않기 때문입니다. 크레딧은 생성에 쓰이며, 게시물에 들어가는 이미지나 영상을 렌더링하는 데 씁니다. 플랜은 월 $29, $69, $149이며, 각각 1,200, 3,000, 7,000 크레딧을 줍니다. Free 플랜을 포함한 모든 플랜에 모든 기능이 들어 있습니다. 예외는 엔터프라이즈 SSO뿐입니다.
Claude에서 Facebook에 게시할 때 캡션 글자 수 제한은 얼마인가요?
Facebook 게시물은 63,206자까지 가능하며, 사실상 제한이 없습니다. Hermoso는 게시물을 만들거나 대기열에 넣을 때 이를 강제하므로, Claude는 나중에 아무도 지켜보지 않을 때 실패하는 대신 즉시 알림을 받습니다.
Claude로 Facebook 게시물을 나중에 예약할 수 있나요?
네. schedule_post는 다른 모든 채널과 함께 쓰는 하나의 일정표에 올리며, 문구를 다르게 해야 하면 채널별 캡션을 붙일 수 있습니다. list_scheduled와 cancel_scheduled로 읽고 취소할 수 있습니다. Facebook은 대기열에 들어갈 수 있는 열한 개 채널 중 하나입니다.