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의 설정 → 커넥터에서 Pinterest 자체를 한 번 연결하세요. 이것은 OAuth 승인 화면이라서 브라우저가 필요한 유일한 단계입니다. 그 이후의 모든 작업은 도구 호출입니다.
Claude가 받는 Pinterest 도구
list_pinterest_boards: 비밀 보드를 포함한 계정의 보드를 ID와 함께 보여 줍니다.create_pinterest_board: 새 보드를 만듭니다.post_to_pinterest: 지정한 보드에 이미지 또는 영상 Pin을 만듭니다. 제목, 설명, 대상 링크, 대체 텍스트를 함께 넣을 수 있습니다.schedule_post: Pin을 대기열에 넣으며,boardId를 함께 보냅니다.list_pinterest_ads_campaigns / pinterest_ads_report: 유료 쪽을 읽습니다.
Pinterest 워크플로를 계획하기 전에 알아야 할 제한: 이 앱은 Trial 접근 권한을 가지며, Pinterest는 Trial에서 프로덕션 Pin 생성을 거부합니다. 첫 실제 Pin에서 확인된 그들의 말입니다. “Trial 접근 권한을 가진 앱은 프로덕션에서 Pin을 만들 수 없습니다.” 보드와 조회는 Trial에서도 작동합니다(보드 목록, 보드 생성, Pin 읽기). Hermoso의 오류는 다시 연결하라고 하지 않고 접근 등급을 명시합니다. 다시 연결해도 해결되지 않기 때문입니다. Standard 접근 권한으로 업그레이드하면 Pin 생성이 풀리며, 이 업그레이드는 심사 중입니다. 같은 등급이 유료 쪽도 제한합니다. Trial에서는 Pinterest가 광고 계정을 전혀 노출하지 않습니다.
자동화하기 전에 알아 둘 Pinterest 제한
| 텍스트 | Pin 설명은 800자, Pin 제목은 100자로 제한됩니다. 이 제한은 게시물을 만들거나 예약할 때 적용되므로, 글자 수를 넘은 게시물은 나가는 도중 몰래 잘리는 대신 여러분이 아직 옆에 있을 때 거부됩니다. |
|---|---|
| 공개 범위 | 공개이며, 제어하는 것은 Pin이 아니라 보드입니다. Pin은 보드의 공개 또는 비밀 상태를 물려받으므로, “비공개로 올리기”는 비밀 보드를 고르는 것으로 표현됩니다. 그래서 보드는 기본값이 아니라 필수 인수입니다. |
| 캐러셀 | 이미지 2~5장, 이미지만 가능. 두 경계값은 Pinterest 자체의 v5 OpenAPI에서 가져온 것입니다(minItems: 2, maxItems: 5). Pinterest가 공개하는 기계 판독 가능한 유일한 출처이며, 개발자 사이트는 가져와도 아무것도 주지 않는 클라이언트 렌더링 앱입니다. 여러 영상을 지원하는 출처는 없으므로, 비디오 슬라이드는 버려지지 않고 거부됩니다. |
| 어느 계정 | boardId는 게시 시점이 아니라 대기열에 넣을 때 거부되는 유일한 신원 필드입니다. 이를 빼면 아무것도 예약되지 않습니다. “잘못된 보드의 Pin은 공개적인 실수이므로, 우리가 대신 고르지 않습니다.” |
Claude에서 해 보기
일상 언어로 요청하세요. 이것은 DSL이 아니라 평범한 문장입니다:
“제품 라인마다 보드를 하나씩 만들고, 각 보드에 제목과 설명이 있는 세로형 Pin을 다섯 개씩 생성한 다음, 전체 계획을 게시할 준비가 되도록 ./out/pinterest.json에 써 줘.”
이 작업은 list_pinterest_boards → plan_ad → generate_image → post_to_pinterest 순서로 진행됩니다. Claude Code는 도구를 실행하기 전에 확인을 요청하고, 대화 기록이 터미널에 그대로 보이므로 게시 단계는 y를 누르기 전에 읽어 볼 수 있는 한 줄입니다.
Facebook에서의 Claude Code: 까다로운 부분
지금은 모든 것을 준비하되 Pin 직전에서 멈추는 스크립트가 알맞은 형태입니다. 보드 읽기와 쓰기는 Trial 액세스에서 되지만, Pin 생성은 Pinterest가 프로덕션에서 직접 거부합니다. 또한 boardId는 Hermoso가 게시 시점이 아니라 enqueue 시점에 거부하는 유일한 식별 필드입니다. “잘못된 보드의 Pin은 공개적인 실수이므로, 저희가 대신 고르지 않습니다.”
플러그인에는 도구 매니페스트가 없으며, 이는 사람이 지켜보지 않는 긴 실행에서 가장 중요합니다. 에이전트는 각 단계마다 hermoso 명령을 호출하고, 모든 명령의 --json 옵션이 검사할 수 있는 기계 출력을 줍니다.
게시하기 전에 Pinterest 리서치하기
Pinterest 광고 라이브러리는 없으므로, Pinterest에서의 경쟁사 조사를 Hermoso가 한다고 주장하지 않습니다. 그곳에서 게시할 크리에이티브는 스튜디오의 나머지 기능으로 충분히 다룰 수 있습니다. make_template_ad와 이미지 모델이 Pinterest가 보상하는 세로형의 텍스트 중심 정지 이미지를 만듭니다.
유료 부분
기존 Pin을 홍보하는 광고 하나를 위한 캠페인, 광고 그룹, 광고 도구가 있으며, 삭제 대신 보관합니다. Pinterest의 ADS API에는 삭제 동사가 없기 때문입니다. 유기적 Pin과 보드는 delete_pinterest_pin과 delete_pinterest_board로 삭제할 수 있지만, 유료 객체는 보관만 가능합니다. 그러나 Pin 생성을 막는 같은 Trial 등급은 광고 계정도 노출하지 않으므로, Standard 접근 권한이 나오기 전까지 광고 쓰기는 사용할 수 없습니다. 이것이 정직한 현재 상태이며, 마감일에 발견하기보다 여기서 한 문장으로 말하는 편이 낫습니다.
Claude Code 혼자서는 할 수 없는 일
예산이 있는 에이전트는 영향 범위가 제한되어 있을 때만 쓸모가 있으므로, 울타리는 프롬프트가 아니라 서버에 둡니다. 모든 광고 캠페인, 광고 세트, 광고 그룹, 광고는 일시 중지 상태로 만들어지며, 실제 돈이 움직이는 상태 변경은 명시적인 확인 표시 없이는 실행되지 않습니다. 모든 렌더는 먼저 견적을 받습니다(hermoso_capabilities가 비용이 쓰이기 전에 모델별 정확한 크레딧 비용을 공개합니다). 크레딧은 첫 제공자 호출 전에 예약되고 이후 정확한 비용으로 정산되므로, 전송이 실패하면 환불되며 아무것도 없이 청구되지 않습니다. 삭제도 확인이 필요하며, 에이전트가 무엇을 만들었다고 말하기 전에 모든 캠페인 구조를 광고 플랫폼에서 다시 읽어 옵니다.
일부러 헤드리스로 하지 않는 단계가 하나 있습니다: 계정 연결은 OAuth 승인 화면이므로, 채널은 브라우저에서 한 번 연결합니다. 그 이후의 모든 작업은 도구 호출입니다.
나머지 매트릭스
Claude Code에서 게시: Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Bluesky · Telegram. 또는 Claude Code가 게시할 수 있는 모든 곳을 보세요.
다음에서 Pinterest에 게시: 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로 Instagram에 캐러셀을 게시할 수 있나요?
원칙적으로는 가능합니다. Pinterest 자체의 v5 OpenAPI 기준으로 이미지 2~5장, 이미지만 가능합니다. 실제로는 이 앱이 Trial 접근 권한을 가지는 동안 프로덕션에서 Pin 생성 자체가 막혀 있습니다. Claude는 어떤 경우든 같은 게시 도구를 호출하며, 캐러셀을 실을 수 없는 채널은 실제 이유와 함께 거부됩니다.
Claude로 Pinterest 게시물을 나중에 예약할 수 있나요?
네. schedule_post는 다른 모든 채널과 함께 쓰는 하나의 일정표에 올리며, 문구를 다르게 해야 하면 채널별 캡션을 붙일 수 있습니다. list_scheduled와 cancel_scheduled로 읽고 취소할 수 있습니다. Facebook은 대기열에 들어갈 수 있는 열한 개 채널 중 하나입니다.
Claude에 Pinterest 비밀번호를 줘야 하나요?
아니요. Instagram은 브라우저의 OAuth 승인 화면을 통해 Hermoso에 한 번 연결하고, 그 뒤로 Claude는 도구 호출로 접근합니다. 계정을 연결하는 것은 헤드리스로 할 수 없는 유일한 단계이며, 그 뒤로는 어떤 것도 비밀번호를 요구하지 않고, 모델에 자격 증명이 넘어가지 않습니다.
Claude로 Facebook에 게시하는 데 비용이 얼마인가요?
Pinterest는 API 호출마다 비용을 부과하지 않으므로 게시에는 크레딧이 들지 않습니다. 크레딧은 Pin 크리에이티브를 생성하는 데 쓰입니다. 플랜은 월 $29, $69, $149이며 각각 1,200, 3,000, 7,000 크레딧을 제공하고, Free 플랜을 포함한 모든 플랜에서 모든 기능을 쓸 수 있습니다. 예외는 엔터프라이즈 SSO뿐입니다.