CRAFT STUDIO - 비즈니스를 정의하고, 트렌드를 읽고, 에이전트가 콘텐츠를 만듭니다

Showing 25 of 69 from the live probe.

• List Sites

  (관리자 전용) 등록된 사이트(병원) 목록을 조회합니다. 각 사이트의 이름과 사용자 정보를 반환합니다. 관리자가 어떤 사이트들이 있는지 확인하고 site_id를 파악할 때 사용합니다.

• Get Plan

  CRAFT STUDIO에서 특정 콘텐츠 기획(Plan)의 상세 데이터를 조회합니다. 키워드, 제목, 아웃라인, 차별화 전략, SERP 키워드 등 블로그 글 작성에 필요한 모든 정보를 반환합니다.

• List Plans

  CRAFT STUDIO에서 콘텐츠 기획 목록을 조회합니다. 상태별, 채널별 필터링이 가능합니다. 각 기획에는 연결된 채널(블로그/인스타/유튜브 등) 정보가 포함됩니다.

• Update Plan Status

  CRAFT STUDIO의 콘텐츠 기획 상태를 업데이트합니다. planned(기획) → confirmed(확인) → writing(작성중) → producing(제작) → completed(완료) 순서로 진행됩니다.

• Create Content Plan

  새로운 콘텐츠 기획(Plan)을 직접 생성합니다. 키워드와 제목을 지정하여 수동으로 콘텐츠를 생성할 때 사용합니다. 선택적으로 HTML 콘텐츠, 채널, 상태 등을 함께 지정할 수 있습니다.

• Save Content Html

  콘텐츠 기획에 완성된 HTML 콘텐츠를 저장합니다. 기획서를 기반으로 외부에서 생성된 HTML을 해당 Plan ID에 삽입하거나 수정할 때 사용합니다.

• Get Content Html

  콘텐츠 기획에 저장된 HTML 콘텐츠를 조회합니다. 저장된 블로그 글 HTML을 확인하거나 수정 전 현재 내용을 읽어올 때 사용합니다.

• Upload Image

  이미지를 워드프레스 서버에 업로드하고 호스팅 URL을 반환합니다. image_url(외부 URL) 또는 image_data(base64)중 하나를 전달하세요. 반환된 URL을 <img src="...">에 삽입한 뒤 save_content_html로 최종 HTML을 저장하면 이미지가 정상 로드됩니다.\n\n⚠️ description(이미지 설명)은 필수입니다. 이 설명은 곧바로 search_images / find_images_for_content 검색 인덱스로 등록되어, 나중에 이미지가 많아져도 설명만으로 필요한 이미지를 골라 쓸 수 있게 합니다. 설명이 비면 업로드가 거부됩니다. 이미지를 직접 생성·선별한 당신이 가장 정확한 설명 작성자이므로, 무엇이 담겨 있고 어떤 콘텐츠에 쓰기 좋은지 구체적으로 적으세요.

• Create Upload Url

  이미지·영상을 업로드할 일회용 업로드 URL을 발급합니다. base64를 MCP 본문에 싣지 않고 바이너리를 직접 전송하므로 큰 파일도 안정적으로 올라갑니다.\n\n⚠️ description(설명)은 필수이며 이 발급 단계에서 받습니다. 이미지는 검색 인덱스로 등록되고, **영상(mp4·mov·webm, 최대 80MB)은 영상 라이브러리에 자동 등록**되어 응답으로 video_id 를 받습니다.\n\n【사용법】\n1) 이 도구로 description(+tags)과 함께 upload_url을 발급받습니다.\n2) 발급된 URL로 파일 바이너리를 직접 POST합니다(인증 헤더 불필요, 토큰이 곧 서명). 예: curl -sS -X POST --data-binary @video.mp4 "<upload_url>"\n3) 이미지 → {url, image_id} / 영상 → {url, video_id, thumbnail, duration_sec}. 영상은 attach_scene_asset(vi

• Search Images

  업로드된 이미지를 자연어 쿼리로 검색합니다. AI가 분석한 설명, 태그, OCR 텍스트, 분위기 등을 기반으로 FULLTEXT 검색(LIKE 폴백)하여 관련 이미지를 찾습니다. 반환된 url 필드는 외부에서 직접 접근 가능한 공개 URL이므로 <img src="...">에 바로 사용할 수 있습니다.

• Find Images For Content

  블로그 글 제목과 본문 텍스트를 전달하면, 해당 콘텐츠에 적합한 이미지를 검색하여 추천합니다. 내부적으로 제목/키워드를 추출하여 이미지 DB를 검색합니다. 반환된 url은 외부 접근 가능한 공개 URL입니다. 블로그 글에 삽입할 이미지를 선정할 때 사용하세요.

• List Images

  분석 완료된 이미지 목록을 조회합니다. 각 이미지의 설명, 태그, 분위기, URL 등을 반환합니다. 어떤 이미지가 있는지 전체 목록을 확인할 때 사용하세요. url은 외부 접근 가능한 공개 URL입니다.

• Get Image Style Guide

  【이미지 생성 전 반드시 먼저 호출】이 병원/업체가 사람이 직접 지정해 둔 이미지 생성 지침을 하나의 텍스트 블록으로 반환합니다. 반환 내용: 참고 이미지 URL 목록(역할별) + 각 이미지에 사람이 남긴 참고 지시문 + 대표 색상 팔레트 + 피해야 할 예시. 이 결과의 style_guide_text를 이미지 생성 프롬프트 앞에 그대로 붙이면 해당 업체의 스타일이 반영됩니다. 참고 이미지를 실제로 모델에 물려야 할 때는 list_sample_images(include_image_data=true)로 이미지 바이트를 받아오세요.

• List Sample Images

  이 업체가 대시보드에서 직접 지정한 샘플(레퍼런스) 이미지 목록을 반환합니다. 일반 이미지 라이브러리와 달리 "이미지 생성 시 참고하라"고 사람이 골라 둔 것만 나옵니다. 각 항목에는 사람이 쓴 참고 지시문(note)과 역할(role)이 포함됩니다. role: style(화풍/톤) / composition(구도) / brand(브랜드·로고·컬러) / subject(피사체) / negative(피해야 할 예시) ⚠️ include_image_data=true를 주면 이미지 바이트를 base64로 함께 반환합니다. URL을 직접 읽지 못하는 모델에 참조를 물릴 때 사용하세요. 응답이 매우 커지므로 이때는 limit이 자동으로 5로 제한됩니다.

• List Sample Sets

  (폐지된 개념) 샘플 세트 계층은 없어졌습니다 — 샘플 이미지는 카테고리(비즈니스 프로필)로 묶입니다. 하위호환을 위해 이 도구는 샘플을 보유한 카테고리 목록을 세트 형태로 반환합니다.

• Save Sample Image

  이미 라이브러리에 있는 이미지를 샘플(레퍼런스)로 승격하거나 샘플 속성을 수정합니다. upload_image로 방금 올린 이미지를 그대로 참고용 레퍼런스로 등록할 때 사용합니다. 샘플 지정을 해제하려면 is_sample=false를 전달하세요. ⚠️ 샘플은 원칙적으로 사람이 대시보드에서 관리합니다. 사용자가 명시적으로 요청했을 때만 사용하세요.

• Create Zoom Animation

  정지 이미지를 **서서히 줌인/줌아웃되는 움직이는 이미지**로 만듭니다 (켄 번스 효과). 결과는 애니메이션 WebP로 저장되며, 같은 화질의 GIF보다 약 20배 가볍습니다. 라이브러리에 새 이미지로 들어가고 `gif` 태그가 붙습니다. **원본은 그대로 남습니다.** focus_x/focus_y 로 화면의 어느 지점을 향해 줌할지 정합니다. 예를 들어 인물의 얼굴이 왼쪽 위에 있으면 focus_x=0.3, focus_y=0.25 처럼 지정하세요. 생략하면 중앙(0.5, 0.5)입니다. 영상 컷용 소재를 만들 때 유용합니다 — 만든 뒤 attach_scene_asset(scene_id, image_id)로 컷에 붙일 수 있습니다.

• Generate Image

  **프롬프트로 새 이미지를 생성**해 이 업체의 이미지 라이브러리에 바로 저장합니다. 생성된 이미지는 업로드한 이미지와 완전히 동일하게 취급됩니다 — search_images / list_images 로 다시 찾을 수 있고, url 은 외부에서 바로 접근 가능한 공개 주소이며, attach_scene_asset 으로 영상 컷에 붙일 수도 있습니다. ⚠️ **생성 전에 get_image_style_guide 를 먼저 호출하세요.** 반환된 style_guide_text 를 프롬프트 앞에 붙여야 이 업체의 화풍·색감과 어긋나지 않습니다. reference_image_ids 에 샘플 이미지 ID를 넣으면 그 이미지들을 참고해서 생성합니다(최대 4장). list_sample_images 로 후보를 찾으세요. quality 는 low(기본) / medium / high 입니다. **비용과 시간이 함께 올라가므로 시안은 low 로 여러 장 뽑고, 확정된 것만 high 로 다시 만드는 방

• Generate Scene Images

  【영상 4/7 · 프레임 생성】 **콘티의 컷 이미지들을 한 번에 생성**해서 각 컷에 붙입니다. ⭐ 컷마다 **시작 프레임과 끝 프레임 두 장**을 만듭니다. 영상 생성 AI(Runway·Kling·Luma 등)는 이미지 한 장이 아니라 시작·끝 두 장을 받아 그 사이 움직임을 만들어 내기 때문입니다. 끝 프레임은 **시작 프레임을 참고 이미지로 물려서** 생성하므로 같은 장소·인물·화풍이 유지됩니다. 끝 프레임에서 무엇이 달라질지는 컷의 camera_move 로 정해집니다 (zoom_in→더 가까이, pan→오른쪽으로 이동한 구도 등). 직접 지정하려면 save_storyboard 의 motion_prompt 에 문장으로 적으세요. generate_image 를 컷마다 반복 호출할 필요가 없습니다. 이 도구가 자동으로: - 프로젝트의 **화면비에 맞는 크기**를 고르고 (9:16→1024x1536, 16:9→1536x1024) - 이 업체의 **스타일 가이드를 모든 컷에 동

• View Image

  【영상 5/7 · 검수】 **이미지를 직접 봅니다.** 라이브러리의 어떤 이미지든 축소본을 base64 image 콘텐츠로 반환합니다. ⭐ 감독 작업의 핵심 도구입니다. 지금까지는 생성 결과를 URL로만 받아서 확인할 수 없었습니다 — 컷 이미지를 만들었으면 **반드시 이걸로 보고 나서** 다음 판단(승인/재생성/프롬프트 수정)을 하세요. 보지 않고 다음 컷으로 넘어가면 안 맞는 이미지가 영상까지 그대로 갑니다. 용도: 생성된 시작·끝 프레임 검수, 앞뒤 컷의 연결감 비교(두 장을 함께 요청), 세계관 이미지 확인. 응답이 커지므로 한 번에 최대 4장입니다.

• Update Scene

  【영상 3/7 · 콘티 다듬기】 **컷 하나만 부분 수정합니다.** 보낸 필드만 바뀌고 나머지는 그대로입니다. save_storyboard 는 콘티 전체를 교체하므로, 컷 3의 나레이션 한 줄을 고치려고 10개 컷을 다시 보내는 건 위험합니다(현재 상태를 잘못 알고 있으면 다른 컷을 덮어씁니다). 다듬는 단계에서는 이 도구를 쓰세요. duration 을 바꾸면 컷 길이도 자동으로 다시 나뉩니다.

• Generate Frame

  【영상 4/7 · 프레임 수정】 **컷의 뒤(또는 앞) 프레임 한 장을 다시 만듭니다.** 반대쪽 프레임을 참고 이미지로 물려서 생성하므로 두 장이 이어져 보입니다. generate_scene_images 가 일괄 생성이라면, 이건 검수 후 한 장만 고치는 도구입니다. view_image 로 보고 마음에 안 드는 프레임을 end_prompt 를 바꿔 재생성하는 흐름: view_image → 문제 파악 → generate_frame(end_prompt="...") → view_image 로 재확인 ref_image_ids 로 함께 물릴 세계관 이미지를 고를 수 있습니다. 빈 배열이면 반대쪽 프레임만 참고합니다(인물이 없는 컷에 캐릭터가 끼어드는 것을 막을 때).

• Plan Video Render

  【영상 6/7 · 렌더 계획】 **영상 렌더 계획을 만들고 확인합니다.** 키프레임 사이사이가 렌더 단위(컷)가 되고, 각 컷의 연출 방식을 정합니다. ⭐ 판단 규칙은 하나 — **무엇이 움직이는가?** - **카메라만** 움직인다 (전체→간판으로 줌인, 풍경을 훑는 팬) → `effect` **카메라 연출**: 정지 이미지 1장에 서버가 카메라 움직임만 입힙니다. 무료·즉시·안정적. - **피사체가** 움직인다 (사람이 걷는다, 고개를 든다, 물이 흐른다) → `ai_video` **AI 모션**: Seedance 가 시작 프레임부터 실제 움직임을 만듭니다(끝 프레임은 선택 — 주면 결말이 통제됨). 유료·수 분 소요. 주의: 이미지는 어차피 AI 가 만듭니다. 이 선택은 이미지가 아니라 **컷 영상을 만드는 방법**이며, 대부분의 컷은 카메라 연출로 충분합니다. 기본 배정: camera_move 가 zoom_in·zoom_out·pan·tilt·dolly·static → 카

• Set Segment Mode

  【영상 6/7 · 컷 방식】 컷의 연출 방식을 바꿉니다. - `effect`: 정지 이미지에 줌·팬·틸트를 적용합니다. 무료·즉시. - `ai_video`: Seedance가 시작 프레임에서 움직임을 만듭니다. 끝 프레임은 선택이며 주면 결말을 통제합니다. - `ai_ref`: 첫 이미지를 @Image 1 기준 참고로 삼고 motion_prompt에 작성한 새 장면을 생성합니다. 끝 프레임은 없고 visual·작품 설정·카메라 문법을 합치지 않습니다. ref_image_ids는 합성에 정말 필요한 추가 소재가 있을 때만 @Image 2 이후로 붙입니다. 한 장뿐이어도 reference-to-video로 요청합니다. - `video`: 원본 클립을 그대로 잇습니다. **두 프레임 전용 규칙**: visual·작품 설정·gen_basis·ref_image_ids 는 영상 프롬프트에 병합하지 않습니다. motion_prompt의 짧은 피사체 변화와 구조화된 카메라 문법(camera_m

• Render Video

  【영상 7/7 · 렌더】 영상 생산과 조립, 진행 확인을 합니다. **랜더(method="oneshot")**: 범위의 AI 컷을 컷별 독립 태스크로 생성합니다. AI 모션의 시작·끝 프레임 컷은 일반 콘티를 병합하지 않고 짧은 motion_prompt와 구조화된 카메라 문법만 전송합니다. AI 합성(ai_ref)은 끝 프레임 없이 첫 이미지와 추가 참고 소재를 reference-to-video로 전송하며, 참고 이미지가 한 장뿐이어도 같은 경로를 사용합니다. quality(draft/final)와 resolution(480p/720p)은 독립 선택입니다. **조립(method 생략)**: 선택된 컷별 결과물을 이어 최종본을 만듭니다. AI 컷 결과가 없으면 먼저 랜더해야 합니다. 요청은 비동기입니다. action="status"로 상태를 확인하세요.