Buzzmark

npx add-mcp 'https://buzzmark.ai/mcp'

하나의 서버. 모든 MCP 앱.

Buzzmark는 Streamable HTTP를 통해 MCP를 제공하며, OAuth 2.1 로그인 또는 API 키를 지원합니다. 도구 24개, 앱과 동일한 규칙을 적용하며, 즉시 게시할 수는 없습니다.

서버 URL: https://buzzmark.ai/mcp

연결 방식

	연결 방식
전송	위 서버 URL에서 Streamable HTTP를 통한 MCP.
로그인	PKCE(S256)를 사용하는 OAuth 2.1. 클라이언트는 즉석에서 등록하거나 메타데이터 URL을 제공할 수 있습니다. 첫 요청에 리소스 메타데이터가 포함된 401 응답이 반환되므로 클라이언트가 직접 인증 서버를 찾습니다.
로그인 없이 사용	Buzzmark의 AI 앱 페이지에서 발급한 API 키를 Bearer 토큰으로 전송합니다. 키는 한 번만 표시되며, Buzzmark에는 지문만 저장됩니다.
범위	범위는 하나, buzz입니다. 앱이 이 범위를 넘어 요청하는 범위는 거부하지 않고 제외합니다.
토큰	액세스 토큰은 1시간, 갱신 토큰은 90일 동안 유효하며 사용 시마다 교체됩니다. 인증 코드는 10분 동안 유효하고 한 번만 사용할 수 있습니다. 두 번째로 사용하면 권한 부여가 종료됩니다.
제한	모든 앱과 키를 합산해 계정당 분당 30회, 하루 1,000회 호출할 수 있습니다. 글 작성과 이미지 생성은 요금제의 월간 할당량에도 포함됩니다.
감사 로그	각 호출의 도구와 결과를 기록하며, 인수나 응답은 기록하지 않습니다.

도구 참조

빌드 시 서버 자체 카탈로그에서 읽으므로 서버가 실제로 응답하는 내용과 일치합니다.

소셜 세트 목록 (list_social_sets), 읽기 전용

사용자의 소셜 세트입니다. 각 세트는 연결된 소셜 계정 그룹으로, 자체 Hive 프로필(브랜드 보이스), 시간대, 주간 게시 슬롯을 갖습니다. 여기서 시작하세요. 대부분의 다른 도구는 이 응답에 포함된 social_set_id와 계정 ID를 사용합니다.

입력: 입력이 필요하지 않습니다.

브랜드 프로필 목록 (list_brand_profiles), 읽기 전용

사용자의 브랜드 프로필(Buzzmark에서는 Hive 프로필이라고 부름)입니다. 각 브랜드의 보이스, 어조, 대상 고객, 제품 등 Buzzmark가 파악한 정보를 담고 있습니다. 글 작성 도구는 브랜드 프로필의 보이스로 글을 작성합니다. 해당 ID를 hive_profile_id로 전달하거나, 생략하여 소셜 세트 자체의 프로필을 사용하세요.

입력: 입력이 필요하지 않습니다.

게시물 목록 (list_posts), 읽기 전용

Buzzmark의 Buzz를 최신순으로 표시합니다. 초안, 예약됨, 게시됨, 실패 상태가 포함됩니다. 텍스트는 400자로 잘립니다. 전체 Buzz를 보려면 get_post를 사용하세요.

입력	유형
status	"draft", "scheduled", "published", "failed", "all" 중 하나	선택 사항	기본값 "all"
social_set_id	숫자	선택 사항
limit	숫자, 1~50	선택 사항	기본값 20

게시물 가져오기 (get_post), 읽기 전용

Buzz 하나의 전체 내용을 가져옵니다. 텍스트와 이미지가 포함된 스레드의 모든 부분, 첫 댓글, 게시 대상 계정, 소셜 세트와 브랜드 프로필, 상태, 예약 시간을 확인할 수 있습니다. 텍스트가 400자로 잘리는 list_posts를 사용한 뒤 전체 내용을 확인하거나, save_draft로 수정하기 전에 초안을 읽을 때 사용하세요. 좋아요 수나 기타 수치는 포함되지 않습니다. 게시된 게시물의 수치는 get_post_stats에서 확인할 수 있습니다.

입력	유형
post_id	숫자	필수	Buzz의 ID. list_posts 또는 save_draft의 응답에서 가져옵니다.

브랜드 보이스로 게시물 작성 (write_posts)

아이디어를 바탕으로 Hive 프로필의 보이스와 Buzzmark의 작성 규칙 및 사후 검사를 적용해 새 게시물 1~5개를 작성합니다. 모든 응답은 Buzzmark의 사용자 라이브러리에 저장됩니다. 초안으로 저장되지는 않습니다. 저장할 텍스트를 save_draft에 전달하세요. 아직 존재하지 않는 게시물을 작성할 때 사용하세요. 기존 게시물을 수정하려면 rewrite_post를, 저장된 초안에 플랫폼별 텍스트를 지정하려면 adapt_for_platforms를 사용하세요.

입력	유형
idea	텍스트, 최대 2,000자	필수	게시물의 주제를 사용자의 표현으로 작성합니다.
hive_profile_id	숫자	선택 사항
social_set_id	숫자	선택 사항	hive_profile_id를 생략했을 때 게시물을 작성할 Hive 프로필이 속한 소셜 세트입니다. 계정에 세트가 하나뿐이면 선택 사항입니다.
platform	텍스트	선택 사항	작성 대상 Buzzmark 플랫폼 ID(x, linkedin, instagram, threads, facebook, tiktok, bluesky)입니다.
format	"post", "thread" 중 하나	선택 사항	기본값 "post"
count	숫자, 1~5	선택 사항	기본값 3
with_picture_brief	예 또는 아니요	선택 사항	create_image에 사용할 이미지 설명을 각 게시물에 추가합니다. 기본값 false

초안 저장 (save_draft)

Buzz 초안을 만들거나 기존 초안(post_id)을 업데이트합니다. 초안은 초안 상태로 유지됩니다. 게시되거나 예약되지 않습니다. 게시물 하나의 텍스트를 제공하거나, 여러 게시물의 경우 thread를 제공하세요. schedule_post 전에 수정할 수 있도록 플랫폼에서 거부할 만한 사항(길이, 이미지 누락, LinkedIn에서 찾을 수 없는 태그)을 알려줍니다. 태그 지정: X, Threads, Instagram, TikTok에서는 @handle을 작성하세요. LinkedIn에서는 프로필 또는 페이지 링크를 대괄호 안에 작성합니다. @[https://www.linkedin.com/company/] 또는 @[https://www.linkedin.com/in/]처럼 입력하면 LinkedIn에서 해당 이름을 표시합니다. 다른 모든 플랫폼에서는 그 이름이 일반 텍스트로 표시됩니다. Facebook에서는 멘션이 일반 텍스트로 유지됩니다. 계정이 연결된 브랜드 프로필(list_brand_profiles에서 확인 가능)은 별도의 태그 형식이 필요하지 않습니다. 이름을 작성하면 게시물 예약 시 해당 프로필이 계정을 보유한 각 플랫폼에서 첫 번째 멘션이 태그됩니다. first_comment는 게시물이 게시되는 즉시 LinkedIn, Instagram, Facebook, Threads에 댓글을 추가합니다. 게시물 본문을 깔끔하게 유지하면서 링크나 해시태그를 넣을 수 있습니다.

입력	유형
post_id	숫자	선택 사항	새 초안을 만드는 대신 이 초안을 업데이트합니다.
text	텍스트, 최대 10,000자	선택 사항
thread	텍스트 목록, 최대 25개	선택 사항	스레드입니다. 게시물마다 문자열 하나를 지정합니다. text를 대체합니다.
social_set_id	숫자	선택 사항	list_social_sets에서 가져온 소셜 세트 ID입니다. 계정에 세트가 하나뿐이면 선택 사항입니다.
hive_profile_id	숫자	선택 사항
account_ids	숫자 목록, 최대 20개	선택 사항	게시 대상 계정입니다. 첫 번째 계정이 대표 계정입니다. 기본값: 세트의 기본 계정.
first_comment	텍스트, 최대 5,000자	선택 사항	게시물이 게시된 직후 LinkedIn, Instagram(스토리 제외), Facebook, Threads에 추가할 댓글입니다. 다른 플랫폼에서는 생략됩니다. Threads는 최대 500자, LinkedIn은 1,250자, Instagram은 2,200자, Facebook은 5,000자까지 허용됩니다. 빈 문자열을 지정하면 댓글이 삭제됩니다. 생략하면 초안의 기존 댓글이 유지됩니다.

게시물 예약 (schedule_post)

초안을 지정한 시간, 최적 시간 또는 소셜 세트의 다음 빈 게시 슬롯에 예약합니다. 즉시 게시하지는 않습니다. "best_time"을 지정하면 Buzzmark가 자체적으로 보유한 수치(LinkedIn은 AI 앱에서 해당 수치를 허용하지 않음)를 바탕으로 이 계정들의 게시 성과가 가장 좋은 가장 빠른 빈 시간을 선택하고, 선택한 시간을 응답으로 반환합니다. 시간대 오프셋이 지정되지 않은 시간은 세트의 시간대를 따릅니다. 세트에서 자연스러운 게시 시간이 활성화되어 있으면(list_social_sets에서 확인 가능), 지정한 시간보다 몇 분 앞뒤로 게시될 수 있습니다. 응답에는 실제 게시 시간이 표시됩니다. 조직에서 사용자의 역할상 사전 승인이 필요한 경우 초안은 승인 요청으로 전송되며(응답의 sent_for_approval), 팀원이 승인하면 게시됩니다. 여러 초안을 한 번에 예약하려면 schedule_posts를 사용하세요.

입력	유형
post_id	숫자	필수
when	텍스트	필수	"best_time"(Buzzmark가 이 계정들에 가장 빠른 최적 시간을 선택), "next_slot" 또는 날짜와 시간: 세트의 시간대 기준 "2026-10-02T09:00", 혹은 오프셋이 포함된 ISO 8601 형식.
account_ids	숫자 목록, 최대 20개	선택 사항	기본값: 초안에 저장된 계정. 없으면 세트의 기본 계정.

여러 게시물 예약 (schedule_posts)

최대 25개의 초안을 한 번에 예약합니다. 각 초안은 지정한 시간, 최적 시간 또는 다음 빈 슬롯에 예약할 수 있습니다. 예를 들어 create_weekly_content_plan으로 저장한 초안은 각각의 날짜와 시간이 해당 초안의 슬롯이 됩니다. 즉시 게시하지는 않습니다. 각 초안을 개별적으로 확인합니다. 게시할 수 없는 초안은 별도로 보고하고 나머지는 계속 예약합니다. 사용자의 역할상 사전 승인이 필요한 경우 초안은 승인 요청으로 전송됩니다.

입력	유형
posts	객체 목록, 최대 25개	필수	각 초안과 해당 시간(post_id, when, 선택적 account_ids)입니다.

예약 게시물 시간 변경 (reschedule_post)

예약된 게시물의 시간을 세트의 시간대 기준 새 날짜와 시간으로 변경하며, 지정한 시간을 그대로 유지합니다. 즉시 게시하지는 않습니다. 텍스트, 이미지, 계정은 변경되지 않습니다.

입력	유형
post_id	숫자	필수
when	텍스트	필수	날짜와 시간입니다. 세트의 시간대 기준 "2026-10-02T09:00" 또는 오프셋이 포함된 ISO 8601 형식입니다.

게시물 예약 취소 (unschedule_post)

예약된 게시물을 캘린더에서 초안으로 되돌립니다. 텍스트, 이미지, 계정은 그대로 유지되므로 수정하거나 다시 예약할 수 있습니다. 아무것도 삭제되지 않습니다. 게시 대기열에 보관된 이미지는 먼저 Buzzmark에 복사됩니다. 복사할 수 없는 이미지가 있으면 게시물은 예약 상태로 유지됩니다.

입력	유형
post_id	숫자	필수

초안 삭제 (delete_draft)

초안을 영구 삭제합니다. 예약되었거나 게시된 게시물은 여기서 삭제할 수 없습니다. 예약된 게시물을 초안으로 되돌리려면 먼저 unschedule_post를 사용하세요.

입력	유형
post_id	숫자	필수

브랜드 보이스에 맞춰 게시물 확인 (check_post)

게시물이 브랜드 보이스와 얼마나 일치하는지 0~100점으로 평가합니다. 간단한 평가와 함께 잘된 점 또는 어긋난 점 한 가지, 점수를 높일 수 있는 수정안 최대 세 가지를 제공합니다. 각 수정안은 게시물 전체를 다시 작성한 형태입니다. 이 채팅에서 작성한 텍스트를 포함해 어떤 텍스트든 확인할 수 있으며, 초안(post_id)을 확인하면 점수가 Buzzmark에 함께 저장됩니다. 게시물은 변경되지 않습니다. 게시 전에 게시물 하나를 평가하려면 이 도구를 사용하세요. 게시된 게시물의 성과는 get_post_stats에서, 여러 게시물의 공통점은 get_insights에서 확인할 수 있습니다.

입력	유형
text	텍스트, 최대 10,000자	선택 사항	확인할 게시물입니다. 생략하면 post_id로 지정한 초안을 확인합니다.
post_id	숫자	선택 사항
platform	텍스트	선택 사항	게시 대상 Buzzmark 플랫폼 ID입니다. 기본값: 초안의 첫 번째 계정.
hive_profile_id	숫자	선택 사항	list_brand_profiles에서 가져온 브랜드 프로필 ID입니다. 기본값: 소셜 세트 자체의 프로필.
social_set_id	숫자	선택 사항	list_social_sets에서 가져온 소셜 세트 ID입니다. 계정에 세트가 하나뿐이면 선택 사항입니다.

게시물 다시 작성 (rewrite_post), 읽기 전용

Buzz가 게시물을 한 가지 방식으로 다시 작성하고, 선택할 수 있도록 최대 세 가지 버전을 제공합니다. 브랜드 보이스와 Buzzmark의 작성 규칙을 적용합니다. 아무것도 저장되지 않습니다. 사용자가 선택한 버전을 save_draft에 전달하세요. 이미 존재하는 게시물 하나를 한 가지 방식으로 수정할 때 사용하세요. 아이디어를 바탕으로 새 게시물을 작성하려면 write_posts를 사용하고, 저장된 초안을 게시 대상 플랫폼별로 다시 작성해 각 버전을 초안에 저장하려면 adapt_for_platforms를 사용하세요. 작업: match_hive(브랜드 보이스에 맞춤), fix_grammar(맞춤법과 문법만 수정), sharpen(더 명확하고 간결하게), sting(더 강렬하게), trim(분량을 약 절반으로 줄임), remix(새로운 표현으로 작성), expand(구체적인 세부 사항 하나 추가), structure(짧은 문장으로 나누어 훑어보기 쉽게 구성), warmer(더 따뜻한 어조로), thread_hook(스레드의 첫 게시물), emoji(이모지 추가), emoji_bullets(이모지 글머리 기호 사용), announcement(뉴스 형식으로 구성), for_platform(플랫폼에 맞는 문체로 다시 작성), custom(사용자의 지시 따르기).

입력	유형
action	"match_hive", "fix_grammar", "sharpen", "sting", "trim", "remix", "expand", "structure", "warmer", "thread_hook", "emoji", "emoji_bullets", "announcement", "for_platform", "custom" 중 하나	필수
text	텍스트, 최대 10,000자	선택 사항	다시 쓸 게시물입니다. 초안의 일부(post_id, part)를 다시 쓰려면 생략하세요.
post_id	숫자	선택 사항
part	숫자, 0~24	선택 사항	스레드에서 다시 쓸 게시물의 순서(0부터). 기본값 0
platform	텍스트	선택 사항	Buzzmark 플랫폼 ID입니다. for_platform에 필요하며, 그 외에는 다시 쓸 때 유지할 길이를 설정합니다.
instruction	텍스트, 최대 600자	선택 사항	custom의 경우: 사용자가 원하는 방식으로 다시 쓰는 방법입니다.
hive_profile_id	숫자	선택 사항	list_brand_profiles의 브랜드 프로필 ID. 기본값: 소셜 세트 자체의 프로필.
social_set_id	숫자	선택 사항	list_social_sets의 소셜 세트 ID. 계정에 세트가 하나만 있으면 선택 사항입니다.

플랫폼별 초안 버전 만들기 (adapt_for_platforms)

각 플랫폼의 특성에 맞게(또는 지정한 플랫폼에 맞게) 초안을 다시 쓰고, Spread가 앱에서 하는 것처럼 해당 버전을 초안에 저장합니다. 초안의 첫 번째 계정에는 게시물 자체가 유지되고, 나머지 플랫폼에는 같은 사진과 함께 각 플랫폼 전용 텍스트가 저장됩니다. 해당 플랫폼에 이전에 저장한 버전이 있으면 대체됩니다. 단일 게시물에서만 작동하며 스레드에서는 작동하지 않습니다. LinkedIn 버전은 LinkedIn 태그를 @[link]로 유지합니다. LinkedIn에서 찾을 수 없는 태그가 있으면 응답에서 알려줍니다. 초안을 작성하고 계정을 지정한 뒤 사용하세요. 게시물 자체를 변경하려면 rewrite_post를 사용하세요(for_platform 작업은 저장하지 않고 한 플랫폼용으로 다시 씁니다). 새 게시물에는 write_posts를 사용하세요.

입력	유형
post_id	숫자	필수
platforms	텍스트 목록, 최대 8개	선택 사항	초안의 계정에 포함된 Buzzmark 플랫폼 ID입니다. 기본값: 첫 번째 계정 이후의 모든 플랫폼.

뉴스와 경쟁사에서 게시물 아이디어 얻기 (get_post_ideas)

Buzzmark의 Scout가 브랜드를 위해 제안하는 게시물 아이디어입니다. 해당 업계의 이번 주 뉴스와 각 주제가 지금 중요한 이유, 출처, 게시물로 활용할 수 있는 두세 가지 관점이 포함됩니다. Scout가 경쟁사 콘텐츠를 읽은 경우 경쟁사에서 얻은 관점도 포함됩니다. Scout가 가장 최근에 읽은 내용과 날짜를 답합니다. refresh를 지정하거나 Scout가 이 브랜드의 뉴스를 읽은 적이 없으면 먼저 뉴스를 다시 읽습니다(최대 1분 소요, Scout 실행 1회로 계산). 아이디어만 제공하므로 게시물로 작성하려면 write_posts를 사용하세요.

입력	유형
social_set_id	숫자	선택 사항	list_social_sets의 소셜 세트 ID. 계정에 세트가 하나만 있으면 선택 사항입니다.
hive_profile_id	숫자	선택 사항	list_brand_profiles의 브랜드 프로필 ID. 기본값: 소셜 세트 자체의 프로필.
refresh	예 또는 아니요	선택 사항	기본값 false

이번 달에 효과가 있었던 것 (get_insights)

지난 30일 동안 브랜드 게시물이 평균 게시물보다 더 나은 성과 또는 더 낮은 성과를 낸 경우의 공통점을 최대 한 가지 발견 사항과 두 가지 실행 방안으로 간결하게 설명합니다. LinkedIn은 AI 앱에서 수치를 허용하지 않으므로 LinkedIn 게시물은 별도로 분석하며, 발견 사항은 Buzzmark에 저장됩니다. 각 발견 사항에는 근거가 되는 수치(예: 질문으로 시작한 게시물 19개 중 측정된 5개 게시물의 참여도가 평균 게시물보다 2.3배 높았습니다)와 실행 아이디어가 포함됩니다. 게시물은 플랫폼, 숫자나 질문으로 시작하는지 여부, 길이, 게시물 유형, 요일 및 시간대를 기준으로 비교합니다. 하루에 최대 한 번만 읽습니다. 수치가 바뀔 때까지 같은 답변이 반환됩니다. 지난 30일 동안 수치가 있는 게시물이 8개 이상 필요하며, 그보다 적으면 현재 게시물 수를 알려줍니다. 무엇을 더 해야 할지 알아보려면 사용하세요. 개별 게시물과 수치는 get_post_stats, 최적의 요일과 시간은 get_best_times, 게시 전 초안 평가는 check_post를 사용하세요.

입력	유형
social_set_id	숫자	선택 사항	hive_profile_id를 생략한 경우 브랜드 프로필을 읽을 소셜 세트입니다. 계정에 세트가 하나만 있으면 선택 사항입니다.
hive_profile_id	숫자	선택 사항	list_brand_profiles의 브랜드 프로필 ID. 기본값: 소셜 세트 자체의 프로필, 없으면 계정의 기본 브랜드 프로필.

게시하기 좋은 시간 (get_best_times), 읽기 전용

소셜 세트에서 직접 게시한 게시물의 성과가 가장 좋았던 시간입니다. 세트의 시간대를 기준으로 가장 성과가 좋은 요일 및 시간대 6개를 순서대로 표시하며, 각 시간대의 게시물 수와 게시물당 평균 참여도(좋아요 + 댓글 + 공유 또는 리포스트 중 더 큰 값 + 저장)를 제공합니다. 게시물의 참여도가 전혀 없는 시간대는 제외되므로 아직 참여도가 없는 세트에는 시간대가 표시되지 않습니다. 세트의 시간대와 읽은 게시물 수도 알려줍니다. LinkedIn은 AI 앱에서 수치를 허용하지 않으므로 LinkedIn 게시물은 집계하지 않습니다. LinkedIn에만 게시하는 세트에는 공개 연구의 기본 시간대와 자체 게시 시간대가 제공됩니다. LinkedIn을 포함한 모든 플랫폼에서 최적의 시간에 게시하려면 schedule_post에서 when을 "best_time"으로 지정하면 Buzzmark가 시간을 선택합니다. 개별 게시물의 성과는 get_post_stats, 게시물의 공통점은 get_insights를 사용하세요.

입력	유형
social_set_id	숫자	선택 사항	list_social_sets의 소셜 세트 ID. 계정에 세트가 하나만 있으면 선택 사항입니다.
days	숫자, 14~180	선택 사항	현재 시점부터 거슬러 올라가 읽을 게시물의 기간(일)입니다. 14~180일, 기본값 90일.

최근 게시물의 성과 (get_post_stats), 읽기 전용

지난 며칠 동안 소셜 세트에서 게시한 게시물을 참여도(좋아요 + 댓글 + 공유 또는 리포스트 중 더 큰 값 + 저장) 순으로 정렬해 성과가 좋은 순서대로 표시합니다. 각 게시물에는 플랫폼, 세트의 시간대를 기준으로 한 게시 시각, 텍스트, 링크, 참여도, Buzzmark에서 게시했는지 여부, 수치가 포함됩니다. 또한 기간 내 모든 게시물의 수치를 합산합니다. LinkedIn은 AI 앱에서 수치를 허용하지 않으므로 LinkedIn 게시물은 numbers_in_buzzmark_only에 최신순으로 별도 표시됩니다. 게시 시각, 링크, Buzzmark에서 수치를 확인할 위치가 포함되며 합계에서는 제외됩니다. 수치는 노출, 도달, 조회, 좋아요, 댓글, 공유, 저장 및 클릭입니다. 플랫폼에 고유한 용어가 있는 경우 해당 용어(답글, 리포스트, 북마크, videoViews 및 upvotes)를 사용합니다. 플랫폼에서 보고하지 않는 수치는 0으로 표시하지 않고 생략합니다. 어떤 게시물의 성과가 가장 좋았고 차이가 얼마나 났는지 확인하려면 사용하세요. 공통점은 get_insights, 최적의 요일과 시간은 get_best_times, 초안 및 예약 게시물은 list_posts, 전체 Buzz는 get_post를 사용하세요.

입력	유형
social_set_id	숫자	선택 사항	list_social_sets의 소셜 세트 ID. 계정에 세트가 하나만 있으면 선택 사항입니다.
days	숫자, 1~180	선택 사항	현재 시점부터 거슬러 올라가 읽을 게시물의 기간(일)입니다. 1~180일, 기본값 30일.
limit	숫자, 1~30	선택 사항	반환할 게시물 수입니다. 성과가 좋은 순서로 표시됩니다. 1~30개, 기본값 10개. 합계에는 기간 내 모든 게시물이 포함됩니다.

이미지 만들기 (create_image)

Buzzmark의 이미지 모델로 이미지를 만들어 사용자의 Library에 저장합니다. post_id가 있으면 해당 초안에도 추가됩니다. 이미지는 Hive 프로필의 색상을 반영하며, Hive 제품 이름을 지정하면 실제 제품 사진을 참고 이미지로 사용합니다. 이번 달 이미지 크레딧을 사용합니다. 이미지 생성에 실패하거나 거부된 경우에는 크레딧이 차감되지 않습니다. 약 1분 정도 걸립니다.

입력	유형
prompt	텍스트, 최대 3,000자	필수	이미지에 담을 내용입니다. 기본값은 사진입니다.
hive_profile_id	숫자	선택 사항
product	텍스트, 최대 200자	선택 사항	사진을 사용하려는 경우 Hive 프로필에 등록된 제품 이름을 정확히 입력합니다.
platforms	텍스트 목록, 최대 8개	선택 사항	이미지가 게시될 플랫폼입니다. 이미지 비율을 결정합니다(Instagram 및 Threads 4:5, TikTok 2:3, 그 외 정사각형). 기본값: 초안의 플랫폼.
post_id	숫자	선택 사항	이미지를 추가할 초안입니다.
part	숫자, 0~24	선택 사항	스레드에서 다시 쓸 게시물의 순서(0부터). 기본값 0

링크에서 이미지 또는 동영상 추가 (add_media_from_url)

공개 https 링크에서 이미지 또는 동영상을 복사해 Buzzmark의 사용자 Library에 저장합니다. post_id가 있으면 해당 초안에도 추가됩니다. Buzzmark가 자체 사본을 보관하므로 링크가 계속 유지될 필요가 없습니다. JPG, PNG, WebP, GIF, MP4 또는 MOV를 지원합니다. 이미지는 최대 10MB, 동영상은 최대 200MB입니다. create_image와 마찬가지로 플랫폼에서 거부할 수 있는 항목을 알려줍니다.

입력	유형
url	텍스트, 최대 2,000자	필수	파일로 바로 연결되는 공개 https 링크입니다. 파일을 보여주는 페이지 링크는 사용할 수 없습니다.
post_id	숫자	선택 사항	파일을 추가할 초안입니다. 지정하지 않으면 Library에만 추가됩니다.
part	숫자, 0~24	선택 사항	스레드에서 다시 쓸 게시물의 순서(0부터). 기본값 0

업로드 링크 받기 (create_upload_link)

사용자의 컴퓨터나 휴대전화에 있는 이미지 또는 동영상처럼 공개 링크가 없는 파일에 사용합니다. 파일 하나를 업로드하는 두 가지 방법을 제공합니다. upload_page는 사용자에게 보낼 Buzzmark 페이지로, 사용자가 파일을 선택하면 초안에 바로 추가됩니다(post_id를 전달하세요). file_name을 지정하면 파일을 직접 읽을 수 있는 앱(터미널 또는 파일 시스템)용 upload_url도 제공됩니다. 응답에 표시된 Content-Type 헤더와 함께 파일 바이트를 해당 URL로 PUT한 다음 add_uploaded_media를 upload_id와 함께 호출하세요. JPG, PNG, WebP, GIF, MP4 또는 MOV를 지원합니다. 이미지는 최대 10MB, 동영상은 최대 200MB입니다.

입력	유형
file_name	텍스트, 최대 120자	선택 사항	앱에서 직접 업로드할 때 파일 확장자를 포함한 파일 이름입니다(예: "launch.png"). 생략하면 사용자용 페이지만 가져옵니다.
post_id	숫자	선택 사항	파일을 추가할 초안입니다. 지정하지 않으면 Library에만 추가됩니다.
part	숫자, 0~24	선택 사항	스레드에서 다시 쓸 게시물의 순서(0부터). 기본값 0

업로드한 이미지 또는 동영상 추가 (add_uploaded_media)

파일을 create_upload_link의 upload_url로 PUT한 뒤 사용합니다. 파일을 복사해 Buzzmark의 사용자 Library에 저장하며, post_id가 있으면 해당 초안에도 추가합니다. add_media_from_url과 마찬가지로 플랫폼에서 거부할 수 있는 항목을 알려줍니다. upload_id는 55분 동안 유효합니다.

입력	유형
upload_id	텍스트, 최대 2,000자	필수	create_upload_link에서 받은 upload_id입니다.
post_id	숫자	선택 사항	파일을 추가할 초안입니다. 지정하지 않으면 Library에만 추가됩니다.
part	숫자, 0~24	선택 사항	스레드에서 다시 쓸 게시물의 순서(0부터). 기본값 0

이 채팅에서 이미지 또는 동영상 추가 (add_media_from_chat)

사용자가 이 채팅에 첨부한 이미지 또는 동영상입니다. 파일을 복사해 Buzzmark의 사용자 Library에 저장하며, post_id가 있으면 해당 초안에도 추가합니다. 플랫폼에서 거부할 수 있는 항목을 알려줍니다. JPG, PNG, WebP, GIF, MP4 또는 MOV를 지원합니다. 이미지는 최대 10MB, 동영상은 최대 200MB입니다.

입력	유형
file	객체	필수	사용자가 채팅에 첨부한 파일입니다.
post_id	숫자	선택 사항	파일을 추가할 초안입니다. 지정하지 않으면 Library에만 추가됩니다.
part	숫자, 0~24	선택 사항	스레드에서 다시 쓸 게시물의 순서(0부터). 기본값 0

한 주 계획하기 (create_weekly_content_plan)

소셜 세트의 향후 7일 계획: 이번 주의 목표, 콘텐츠 기둥 2~4개, 게시 시간대마다 바로 편집할 수 있는 게시물 하나씩. 각 게시물에는 게시 요일, 시간, 플랫폼, 이미지 아이디어와 게시 이유가 포함됩니다. 세트의 Hive 프로필, 게시 시간대, 최적 게시 시간, 최근 게시물의 성과, 이미 예약된 게시물을 바탕으로 작성합니다. LinkedIn 수치는 작성에 사용하지 않습니다. 대신 Buzzmark가 LinkedIn 전용 게시물을 작성한 뒤 해당 요일의 LinkedIn 최적 시간대로 옮깁니다. 연결된 계정이 필요합니다. 수치가 있는 게시물이 8개 미만이면 브랜드의 목소리와 각 플랫폼의 관례를 바탕으로 작성하고, 그 사실을 알립니다. Library에 저장됩니다. 먼저 사용자에게 게시물을 초안으로 저장할지 물어보세요. save_as_drafts를 사용하면 모든 게시물이 초안으로도 저장되고, schedule_posts를 사용하면 한 번에 모두 해당 시간대에 예약됩니다. 계획된 게시물 하나당 Buzz 하나가 작성됩니다. 최대 1분이 걸립니다.

입력	유형
social_set_id	숫자	선택 사항	list_social_sets에서 가져온 소셜 세트 ID. 계정에 세트가 하나만 있으면 생략할 수 있습니다.
goal	텍스트, 최대 600자	선택 사항	출시, 이벤트, 예약 증가 등 이번 주에 이루고 싶은 일을 사용자의 표현으로 작성합니다.
start	텍스트	선택 사항	세트의 시간대 기준 첫날, YYYY-MM-DD. 기본값: 내일.
save_as_drafts	예 또는 아니요	선택 사항	기본값 false

게시하는 가이드

각 가이드는 각 도구가 공개한 사실을 바탕으로 도구를 비교합니다. Buzzmark도 그중 하나이며, 모든 페이지에 제작자가 표시됩니다.

• 최고의 소셜 미디어 MCP 서버: 각 도구가 MCP 서버에 대해 공개한 내용: 요금제, 언급된 AI 앱, API.

서버 관련 질문

어떤 클라이언트에서 테스트했나요?

Claude, ChatGPT, Grok, Cursor에는 각각 전용 페이지가 있습니다. Streamable HTTP와 OAuth 2.1 또는 Bearer 헤더를 사용하는 MCP 클라이언트라면 작동해야 합니다. stdio만 지원하는 앱에는 브리지가 필요합니다.

지금 바로 게시하는 도구가 없는 이유는 무엇인가요?

최종 결정권을 소유자에게 남겨두기 위해서입니다. schedule_post는 최소 5분 이후의 시간이나 다음 빈 게시 시간대를 필요로 하며, 예약된 Buzz는 앱에서 취소할 수 있습니다.

오류는 어디에서 발생하나요?

모든 거부 메시지는 Buzzmark가 작성한 문장으로, 이유와 해결 방법을 알려줍니다. 플랫폼의 제한, 누락된 이미지, 대기열이 없는 세트 등이 그 예입니다. 제공업체의 메시지는 앱에 전달되지 않습니다.

REST API도 있나요?

아직 없습니다. 현재 AI 앱은 MCP 서버를 통해 연결하며, 모든 요금제에서 사용할 수 있습니다.

다음에서 설정하기

• Claude에서 Buzzmark: Claude 디렉터리에서 한 번 누르거나 Claude Code에서 명령어 하나를 실행합니다.
• ChatGPT에서 Buzzmark: ChatGPT 플러그인에서 한 번 누릅니다.
• Grok에서 Buzzmark: grok.com에서 로그인하여 사용자 지정 커넥터 하나를 설정합니다.
• Cursor에서 Buzzmark: 로그인 또는 API 키를 사용해 설정 블록 하나를 추가합니다.