Orshot-HQ/orshot-openclaw

Orshot: 템플릿으로부터 비디오, PDF 및 이미지 자동 생성 및 소셜 미디어 게시

Orshot은 템플릿으로부터 이미지, PDF 및 비디오를 자동 생성하기 위한 API입니다. Orshot Studio에서 템플릿을 한 번 디자인하거나(Canva 또는 Figma에서 가져오기) 호출할 때마다 새 텍스트, 이미지 및 비디오로 렌더링하고 결과를 동일한 요청으로 연결된 소셜 계정에 게시할 수 있습니다. 렌더링은 결정론적입니다. 동일한 템플릿과 동일한 데이터는 항상 동일한 출력을 제공합니다.

• 문서: https://orshot.com/docs (문서 URL에 .md를 추가하면 마크다운 형식으로 볼 수 있음)
• 호스팅 MCP 서버: https://mcp.orshot.com/mcp (100개 이상의 orshot_* 도구)
• REST 베이스: https://api.orshot.com/v1
• 무료 플랜: 월 100 크레딧, 신용카드 불필요.

먼저 연결 (MCP, 붙여넣을 키 없음)

호스팅된 MCP 서버가 가장 빠른 경로이며, 인라인 미리보기, 시각적 게시 카드 및 디자인 검사를 반환하는 유일한 방법입니다. 추가한 후 브라우저에서 사용자의 Orshot 계정으로 로그인하면 아래의 모든 도구가 작동합니다.

openclaw mcp add orshot --url https://mcp.orshot.com/mcp --transport streamable-http --auth oauth
openclaw mcp login orshot

아직 Orshot 계정이 없으신가요? 로그인 페이지에서 가입할 수 있습니다. 무료 플랜은 월 100 크레딧으로 시작합니다. Claude Code: claude mcp add --transport http orshot https://mcp.orshot.com/mcp. Cursor, Windsurf, VS Code, Codex 및 ChatGPT는 동일한 URL을 원격 MCP 서버로 사용합니다.

orshot_get_account로 확인합니다. 프로필, 워크스페이스 및 크레딧을 반환합니다. 구독이 비활성 상태이거나 플랜 한도에 도달했다고 표시되면 인증 오류가 아니라 청구 상태입니다. 사용자를 워크스페이스 청구 페이지(https://orshot.com/pricing)로 안내하고 재시도를 중단합니다.

헤드리스 대체: API 키를 사용한 REST. 에이전트가 MCP를 실행할 수 없는 경우에만 사용하십시오(예: 크론 작업, 서버 측 스크립트, n8n).

export ORSHOT_API_KEY=...   # 워크스페이스 설정 > API 키
curl -s https://api.orshot.com/v1/me -H "Authorization: Bearer $ORSHOT_API_KEY"

둘 중 하나가 작동할 때까지 진행하지 마십시오.

할 수 있는 일

각 줄은 먼저 MCP 도구 이름, 다음으로 REST 경로를 나타냅니다.

• 데이터로 모든 템플릿 렌더링: OG 이미지, 광고 크리에이티브, 인증서, 인보이스, 캐러셀, 릴스. orshot_render_template 또는 POST /v1/studio/render.
• 간략한 설명으로 Studio 템플릿 생성 및 개선(인라인 미리보기 및 디자인 검사 포함). orshot_create_template_design, orshot_update_template_design, orshot_patch_template_elements (먼저 orshot://template-design-spec을 읽으십시오. orshot-social-media-content 스킬에 제작 규칙이 있습니다).
• 진정한 비디오 렌더링: 요소별 애니메이션 및 전환, 브랜드 키트의 사운드트랙, 유료 렌더링 전에 무료 모션 미리보기. 동일한 렌더 도구에 format: "mp4"를 사용합니다.
• 바로 사용 가능한 유틸리티 템플릿으로 시작: 트윗 스크린샷, 웹사이트 스크린샷, 막대형 및 비교 차트, 앱 스토어 스크린샷, 전화 목업, 배경 제거. orshot_render_library_template 또는 POST /v1/generate/:renderType.
• 하나의 디자인을 한 번의 호출로 모든 소셜 형식으로 리사이즈(스마트 리사이즈). 렌더링에 size 및 extraSizes를 사용합니다.
• 인증서 목록과 같은 개인 맞춤형 변형 일괄 렌더링. orshot_batch_render_template.
• 브랜드 일관성 유지: 브랜드 키트의 색상, 글꼴, 이미지, 비디오 및 오디오. orshot_get_brand_kit, orshot_import_brand_website.
• 구성: 폴더, 템플릿 공유, 클라이언트 워크스페이스 간 전환. orshot_list_template_folders, orshot_set_active_workspace.
• OG 이미지 및 임베드를 위한 서명된 동적 URL 발행. orshot_create_dynamic_url 또는 POST /v1/signed-url/create.
• 소셜 미디어 게시물 초안 작성, 예약 및 게시, 사용자의 자체 참여 데이터에서 게시하기 가장 좋은 시간 학습, 도달 범위 및 참여 분석 읽기. orshot_publish_social_post, orshot_get_best_time_to_post, orshot_get_social_analytics. orshot-social-media-scheduler 스킬이 전체 루프를 수행합니다.
• 예약에 따라 콘텐츠를 계속 생성하는 자동화 워크플로우 구축 및 실행. orshot_create_workflow, orshot_run_workflow.

이러한 도구에 직접 매핑되는 예시 프롬프트:

• "출시 템플릿을 'We just shipped'라는 제목의 OG 이미지로 렌더링해줘"
• "헤드라인, 부제목 및 제품 이미지가 있는 Instagram 게시물 템플릿을 만들어줘"
• "내 출시 디자인을 한 번의 호출로 Instagram 스토리, 정사각형 및 OG용으로 리사이즈해줘"
• "이 40명의 이름 목록에 대한 인증서를 PDF로 생성해줘"
• "이 트윗의 스크린샷을 찍어줘" / "orshot.com을 이미지로 캡처해줘" / "이 숫자로 막대 차트를 만들어줘"
• "이 렌더링을 가장 좋은 시간에 Instagram에 게시하고 지난주 게시물 성과를 보여줘"

핵심 워크플로우

1. 연결 (위 참조).
2. 템플릿 찾기. orshot_list_studio_templates (이름 및 태그로 검색) 또는 GET /v1/studio/templates/all?page=1&limit=10. 템플릿이 아직 없나요? 2,000개 이상의 라이브러리 템플릿(orshot_list_library_templates)을 사용하거나 orshot_create_template_design으로 디자인하십시오.
3. 파라미터 읽기. orshot_get_studio_template_modifications 또는 GET /v1/studio/templates/:id. 수정 사항은 레이어 이름이 아닌 parameterId로 키가 지정됩니다. 키를 추측하지 마십시오.
4. 렌더링. modifications와 함께 orshot_render_template 또는 response: { type: "url", format: "png" }와 함께 POST /v1/studio/render.
5. 전달 또는 게시. 사용자에게 출력 URL을 보여줍니다. 동일한 호출에서 소셜에 게시하려면 publish를 추가하십시오.
6. 자동화. 호출을 사용자가 이미 실행 중인 n8n, Make, Zapier 또는 크론 작업에 넣거나 Orshot Workflow를 구축하십시오.
7. 확인. orshot_list_workspace_logs 또는 GET /v1/workspace/logs는 렌더링과 source를 보여줍니다. 완료되었다고 말하기 전에 출력을 표시하십시오.

에이전트를 위한 안전 규칙

• 워크스페이스에서 무언가를 내보내기 전에 확인하십시오. 소셜 게시물 게시, 워크플로우 실행(크레딧을 소비하고 전달 또는 게시할 수 있음), 템플릿, 워크플로우 또는 브랜드 에셋 삭제에는 명시적인 승인이 필요합니다. 무엇을, 어디에, 언제 게시할 것인지 말하십시오.
• 소셜 게시물은 기본적으로 초안으로 설정하십시오. "준비", "초안", "먼저 확인하겠습니다"는 status: "draft"를 의미합니다. 초안은 게시될 때까지 아무에게도 도달하지 않습니다.
• 대량 작업 전에 비용을 표시하십시오. 렌더링은 크레딧을 소비하고, .prompt 수정은 AI 크레딧을 소비하며, 각 연결된 소셜 계정은 유료 애드온입니다. 수백 개의 렌더링 루프 전에 이 점을 말하십시오.
• API 키를 채팅, 파일 또는 URL에 절대 붙여넣지 마십시오. 환경 변수에서 읽으십시오. 키가 전혀 없는 MCP를 선호하십시오.
• 스스로 "정리"하기 위해 아무 것도 삭제하지 마십시오.

일반적인 주의사항 (렌더링 전에 읽으십시오)

1. 수정 사항은 레이어 이름이 아닌 parameterId로 키가 지정됩니다. 값이 무시되면 키가 잘못된 것입니다. 추측하지 말고 템플릿을 가져오십시오.
2. 여러 페이지 템플릿에는 pageN@ 접두사가 필요합니다. "page1@title", "page2@title". "title"만 사용하면 페이지 1에만 적용됩니다.
3. Studio templateId는 정수입니다. 유틸리티 templateId는 문자열입니다. (/v1/generate/:renderType은 "website-screenshot"과 같은 슬러그를 사용합니다.)
4. 비디오 출력에 비디오 레이어가 필요하지 않습니다. format: "mp4", "webm" 또는 "gif"는 모든 템플릿을 렌더링합니다. 긴 비디오 렌더링은 response.mode: "async"를 사용하고 orshot_get_render_job 또는 GET /v1/studio/render-jobs/:id를 폴링해야 합니다. 그렇지 않으면 클라이언트 시간이 초과됩니다.
5. 수정 사항의 이미지 및 비디오 URL은 공개되어야 합니다. 렌더러가 서버 측에서 가져옵니다. localhost, 만료된 서명된 URL 및 인증이 필요한 URL은 실패합니다.
6. 스타일 재정의는 parameterId에 점 표기법을 사용합니다: "title.fontSize": "48px".
7. 응답 모양은 페이지 수에 따라 다릅니다. 한 페이지: data는 객체입니다(data.content). 여러 페이지: data는 { page, content }의 배열입니다.
8. base64와 binary는 결합되지 않습니다. binary는 하나의 파일을 스트리밍합니다.
9. 크레딧과 AI 크레딧은 별개입니다. .prompt 수정은 AI 크레딧을 추가로 소비합니다.
10. 429 오류 시 Retry-After를 사용하여 백오프하십시오.
11. PDF는 소셜에 게시할 수 없습니다. 이미지는 TikTok 또는 YouTube(비디오 전용)에 게시할 수 없습니다. 비디오는 Google Business에 게시할 수 없습니다.
12. 소셜 계정 ID는 숫자입니다. 동일한 플랫폼의 두 계정은 다른 ID를 갖습니다. 항상 ID로 게시하고 플랫폼 이름으로 게시하지 마십시오.
13. 소셜 게시는 유료 애드온입니다. 무료 플랜 워크스페이스는 계정을 연결할 수 없습니다. 게시 자체는 추가 크레딧을 소비하지 않습니다.

렌더링 필수 요소

전체 필드 참조: references/render-configuration.md 및 references/api-reference.md.

await fetch("https://api.orshot.com/v1/studio/render", {
  method: "POST",
  headers: { "Content-Type": "application/json", Authorization: `Bearer ${apiKey}` },
  body: JSON.stringify({
    templateId: 123,
    modifications: {
      title: "Launch day",             // 텍스트
      hero_image: "https://.../a.png", // 이미지 URL
      "title.fontSize": "56px",        // 스타일 재정의
      "page2@title": "Slide two",      // 여러 페이지
    },
    response: { type: "url", format: "png", size: "instagram-story",
                extraSizes: ["1080x1080", "1200x630"] },
  }),
});

동일한 객체가 MCP를 통한 orshot_render_template의 입력입니다.

• format: png, jpg, webp, pdf, mp4, webm, gif.
• size는 다른 사전 설정 또는 WIDTHxHEIGHT로 디자인을 렌더링합니다. extraSizes는 한 번의 호출로 추가 복사본을 추가합니다(스마트 리사이즈). 사전 설정: orshot://formats.
• response.mode: "async"는 작업을 반환합니다. 폴링하거나 webhook_url을 전달하십시오. 비디오에 사용하십시오.
• 한 번에 여러 변형: orshot_batch_render_template 또는 REST를 통해 렌더 호출을 반복합니다.
• 서명된 URL: 키를 노출하지 않고 임베드할 수 있는 렌더 URL을 위한 POST /v1/signed-url/create.

헤드리스 사용을 위한 SDK: npm install [email protected], pip install orshot==0.2.0, composer require rishimohan/orshot:0.2.0, gem install orshot -v 0.2.0.

import { Orshot } from "orshot";
const orshot = new Orshot(apiKey); // 환경에서 읽기
const res = await orshot.renderFromTemplate({
  templateId: "open-graph-image-1",
  modifications: { title: "Hello World" },
  responseType: "url",
  responseFormat: "png",
});

소셜 게시 (간단 버전)

Orshot은 13개 이상의 플랫폼으로 렌더링을 게시합니다: X, Instagram, Facebook, LinkedIn, TikTok, YouTube, Pinterest, Reddit, Bluesky, Threads, Telegram, Snapchat, Google Business. orshot-social-media-scheduler 스킬이 예약, 초안, 분석 및 최적 시간을 처리합니다. 다음은 핵심입니다.

1. 계정. orshot_list_social_accounts 또는 GET /v1/social/accounts?include_health=true. 계정은 대시보드(워크스페이스 > 소셜 > 계정)에서 사람이 연결합니다. API는 계정을 연결할 수 없습니다. 빈 목록은 사용자를 그곳으로 보내야 함을 의미합니다.
2. 렌더링 및 게시를 한 번의 호출로. 렌더링에 publish를 추가하십시오:

publish: {
  accounts: [1, 3],
  content: "캡션, 최대 5000자",
  status: "draft",                       // "published" (기본값) | "draft" | "scheduled"
  // scheduled_for: "2026-11-01T14:00:00Z", timezone: "America/New_York",
  platformOptions: { "3": { firstComment: "https://orshot.com" } },
  tiktokSettings: { autoAddMusic: true }, // TikTok 사진 캐러셀
}

여러 페이지 템플릿은 자동으로 캐러셀로 게시됩니다. 응답은 계정별 status, url 및 error가 있는 publish[]를 전달합니다. 실패한 게시는 렌더링을 차단하지 않습니다.

3. 기존 미디어 URL 게시. orshot_publish_social_post 또는 POST /v1/social/publish (media_urls 사용).
4. 보류된 게시물. orshot_list_social_posts, orshot_get_social_post (시각적 카드), orshot_update_social_post, orshot_publish_social_draft, orshot_discard_social_post. REST: GET|PATCH|DELETE /v1/social/posts/:id, POST /v1/social/posts/:id/publish.
5. 분석 및 최적 시간. orshot_get_social_analytics, orshot_get_social_analytics_daily, orshot_get_social_followers, orshot_get_best_time_to_post. REST: GET /v1/social/analytics, /daily, /accounts, /insights.

일반적인 레시피

모든 배포에서 OG 이미지

response: { type: "url", format: "png", size: "og-image" }
// <meta property="og:image" content={data.content} />

CSV에서 대량 생성(인증서, 인보이스, 배지): 행당 하나의 수정 사항 세트와 함께 orshot_batch_render_template (format: "pdf") 또는 POST /v1/studio/render 반복.

주간 소셜 그래픽, 검토를 위해 초안으로 게시: publish.status: "draft"로 렌더링한 후 사용자가 승인하면 orshot_publish_social_draft.

하나의 디자인, 모든 크기: extraSizes: ["1080x1920", "1080x1080", "1200x630"].

TikTok, Instagram 또는 LinkedIn 캐러셀: orshot-carousel 스킬 참조.

반복 파이프라인: references/recurring-automation.md. 사용자가 이미 실행 중인 워크스페이스 로그의 source(n8n, Make, Zapier, SDK)를 확인하고 추가하십시오. 아무것도 실행하지 않는 경우에만 Orshot Workflow를 제공하십시오.

참조 파일

필요할 때 읽으십시오. 기본적으로 로드되지 않습니다.

파일	사용 시기
references/api-reference.md	모든 REST 엔드포인트: 렌더링, 템플릿, 서명된 URL, 브랜드 에셋, 동적 URL, 폴더, 워크플로우
references/render-configuration.md	수정 유형, 비디오 옵션, 비동기 작업, 애니메이션, 오디오, 스마트 리사이즈, 응답 유형, 크레딧
references/template-design-spec.md	API를 통해 템플릿을 생성하거나 편집하기 위한 요소 스키마
references/recurring-automation.md	n8n, Make, Zapier, Pipedream, cron 및 Orshot Workflow 플레이북
references/integrations-and-errors.md	통합 목록, 오류 코드, 모범 사례
references/oauth-developer-apps.md	OAuth를 사용하여 Orshot에서 타사 앱 구축
references/embed.md	화이트 라벨 편집기 임베드(iframe, React, Vue)
references/migration.md	Bannerbear, Placid, Templated, Creatomate 또는 유사 서비스에서 마이그레이션

모든 문서 페이지는 마크다운으로 제공됩니다: https://orshot.com/docs/<path>.md. MCP 서버는 또한 orshot://template-design-spec 및 orshot://formats를 제공합니다.

빠른 참조

# 연결
openclaw mcp add orshot --url https://mcp.orshot.com/mcp --transport streamable-http --auth oauth && openclaw mcp login orshot
curl -s https://api.orshot.com/v1/me -H "Authorization: Bearer $ORSHOT_API_KEY"   # REST 확인

# 템플릿
GET  /v1/studio/templates/all?page=1&limit=2

…

[번역을 위해 잘렸습니다]