Buzzmark

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

Một máy chủ. Mọi ứng dụng MCP.

Buzzmark giao tiếp qua MCP bằng Streamable HTTP, với đăng nhập OAuth 2.1 hoặc khóa API. Có 24 công cụ, cùng quy tắc như ứng dụng và không có cách nào đăng ngay lập tức.

URL máy chủ: https://buzzmark.ai/mcp

Cách kết nối

	Cách kết nối
Giao thức truyền tải	MCP qua Streamable HTTP, tại URL máy chủ ở trên.
Đăng nhập	OAuth 2.1 với PKCE (S256). Máy khách tự đăng ký hoặc cung cấp URL siêu dữ liệu của mình. Yêu cầu đầu tiên nhận được phản hồi 401 kèm siêu dữ liệu tài nguyên, để máy khách tự tìm máy chủ ủy quyền.
Không cần đăng nhập	Khóa API từ trang ứng dụng AI trong Buzzmark, được gửi dưới dạng mã thông báo Bearer. Khóa chỉ hiển thị một lần; Buzzmark chỉ lưu dấu vân tay của khóa.
Phạm vi	Một phạm vi duy nhất, buzz. Các phạm vi mà ứng dụng yêu cầu ngoài phạm vi này sẽ bị bỏ qua, không bị từ chối.
Mã thông báo	Mã thông báo truy cập có hiệu lực 1 giờ, mã thông báo làm mới có hiệu lực 90 ngày và được luân phiên khi sử dụng. Mã ủy quyền có hiệu lực 10 phút và chỉ dùng được một lần; lần sử dụng thứ hai sẽ đóng quyền cấp phép.
Giới hạn	30 lệnh gọi mỗi phút và 1.000 lệnh gọi mỗi ngày cho tài khoản của bạn, tính trên mọi ứng dụng và khóa. Việc viết nội dung và tạo ảnh cũng được tính vào hạn mức hằng tháng của gói.
Nhật ký kiểm tra	Mỗi lệnh gọi ghi lại công cụ và kết quả, không bao giờ ghi lại đối số hoặc câu trả lời.

Tham khảo công cụ

Đọc danh mục riêng của máy chủ tại thời điểm build để danh mục khớp với những gì máy chủ phản hồi.

Liệt kê bộ mạng xã hội (list_social_sets), chỉ đọc

Các bộ mạng xã hội của người dùng: mỗi bộ là một nhóm tài khoản mạng xã hội đã kết nối, có hồ sơ Hive (giọng thương hiệu), múi giờ và các khung giờ đăng bài hằng tuần riêng. Hãy bắt đầu từ đây: hầu hết công cụ khác đều cần social_set_id và ID tài khoản lấy từ câu trả lời này.

Đầu vào: Không nhận đầu vào.

Liệt kê hồ sơ thương hiệu (list_brand_profiles), chỉ đọc

Các hồ sơ thương hiệu của người dùng (Buzzmark gọi chúng là hồ sơ Hive): thông tin Buzzmark biết về từng thương hiệu, gồm giọng điệu, sắc thái, đối tượng và sản phẩm. Công cụ viết nội dung sẽ viết theo giọng của hồ sơ thương hiệu; truyền ID của hồ sơ dưới dạng hive_profile_id hoặc bỏ qua để dùng hồ sơ riêng của bộ mạng xã hội.

Đầu vào: Không nhận đầu vào.

Liệt kê bài đăng (list_posts), chỉ đọc

Các Buzz trong Buzzmark, mới nhất trước: bản nháp, đã lên lịch, đã đăng hoặc thất bại. Văn bản được cắt còn 400 ký tự; get_post trả về toàn bộ Buzz.

Đầu vào	Kiểu
status	một trong các giá trị "draft", "scheduled", "published", "failed", "all"	Không bắt buộc	Mặc định là "all"
social_set_id	số	Không bắt buộc
limit	số, từ 1 đến 50	Không bắt buộc	Mặc định là 20

Lấy bài đăng (get_post), chỉ đọc

Một Buzz đầy đủ: mọi phần của chuỗi bài đăng cùng văn bản và ảnh, bình luận đầu tiên, các tài khoản nhận bài, bộ mạng xã hội và hồ sơ thương hiệu, trạng thái và thời gian lên lịch. Dùng công cụ này sau list_posts, vốn cắt văn bản còn 400 ký tự, hoặc để đọc bản nháp trước khi thay đổi bằng save_draft. Công cụ này không có lượt thích hay số liệu khác: get_post_stats cung cấp các số liệu đó cho bài đăng đã đăng.

Đầu vào	Kiểu
post_id	số	Bắt buộc	ID của Buzz, lấy từ list_posts hoặc câu trả lời của save_draft.

Viết bài đăng theo giọng thương hiệu (write_posts)

Buzz viết từ 1 đến 5 bài đăng mới dựa trên một ý tưởng, theo giọng của hồ sơ Hive, tuân thủ quy tắc viết của Buzzmark và bước kiểm tra sau khi viết. Mọi câu trả lời đều được lưu trong Thư viện của người dùng trên Buzzmark. Không có nội dung nào được lưu thành bản nháp: hãy truyền văn bản bạn muốn lưu cho save_draft. Dùng công cụ này cho bài đăng chưa tồn tại; để thay đổi bài đăng đã có, dùng rewrite_post; để tạo văn bản riêng cho từng nền tảng từ một bản nháp đã lưu, dùng adapt_for_platforms.

Đầu vào	Kiểu
idea	văn bản, tối đa 2.000 ký tự	Bắt buộc	Nội dung bài đăng, diễn đạt theo lời của người dùng.
hive_profile_id	số	Không bắt buộc
social_set_id	số	Không bắt buộc	Bộ mạng xã hội có hồ sơ Hive dùng để viết bài đăng, khi bỏ qua hive_profile_id. Không bắt buộc nếu tài khoản chỉ có một bộ.
platform	văn bản	Không bắt buộc	ID nền tảng của Buzzmark (x, linkedin, instagram, threads, facebook, tiktok, bluesky) để viết nội dung.
format	một trong các giá trị "post", "thread"	Không bắt buộc	Mặc định là "post"
count	số, từ 1 đến 5	Không bắt buộc	Mặc định là 3
with_picture_brief	có hoặc không	Không bắt buộc	Thêm mô tả ngắn về ảnh vào mỗi bài đăng để dùng với create_image. Mặc định là false

Lưu bản nháp (save_draft)

Tạo một bản nháp Buzz hoặc cập nhật bản nháp hiện có (post_id). Bản nháp vẫn là bản nháp: không có nội dung nào được đăng hoặc lên lịch. Cung cấp văn bản cho một bài đăng hoặc thread cho nhiều bài. Công cụ cho biết những gì nền tảng sẽ từ chối (độ dài, thiếu ảnh, thẻ LinkedIn mà LinkedIn không tìm thấy) để có thể sửa trước khi dùng schedule_post. Gắn thẻ: trên X, Threads, Instagram và TikTok, viết @handle. Trên LinkedIn, viết liên kết hồ sơ hoặc trang trong ngoặc vuông, @[https://www.linkedin.com/company/] hoặc @[https://www.linkedin.com/in/], và LinkedIn sẽ hiển thị tên riêng của liên kết đó; trên mọi nền tảng khác, tên đó sẽ hiển thị dưới dạng văn bản thuần. Trên Facebook, lượt nhắc tên vẫn là văn bản thuần. Với hồ sơ thương hiệu có tài khoản (list_brand_profiles sẽ hiển thị các tài khoản đó), không cần làm những việc trên: chỉ cần viết tên thương hiệu, và khi bài đăng được lên lịch, lượt nhắc tên đầu tiên sẽ được gắn thẻ trên mỗi nền tảng có tài khoản của thương hiệu. first_comment thêm một bình luận được đăng bên dưới bài đăng ngay khi bài được đăng, trên LinkedIn, Instagram, Facebook và Threads: nơi để đặt liên kết hoặc hashtag, giúp nội dung bài đăng chính luôn gọn gàng.

Đầu vào	Kiểu
post_id	số	Không bắt buộc	Cập nhật bản nháp này thay vì tạo bản mới.
text	văn bản, tối đa 10.000 ký tự	Không bắt buộc
thread	danh sách văn bản, tối đa 25	Không bắt buộc	Một thread: mỗi bài đăng là một chuỗi. Thay thế text.
social_set_id	số	Không bắt buộc	ID bộ mạng xã hội từ list_social_sets. Không bắt buộc nếu tài khoản chỉ có một bộ.
hive_profile_id	số	Không bắt buộc
account_ids	danh sách số, tối đa 20	Không bắt buộc	Các tài khoản nhận bài, tài khoản đầu tiên là tài khoản chính. Mặc định: các tài khoản mặc định của bộ.
first_comment	văn bản, tối đa 5.000 ký tự	Không bắt buộc	Bình luận được đăng bên dưới bài đăng ngay sau khi bài được đăng, trên LinkedIn, Instagram (không áp dụng cho story), Facebook và Threads; các nền tảng khác sẽ bỏ qua. Tối đa 500 ký tự trên Threads, 1.250 trên LinkedIn, 2.200 trên Instagram, 5.000 trên Facebook. Chuỗi rỗng sẽ xóa bình luận; bỏ qua để giữ nguyên bình luận hiện có của bản nháp.

Lên lịch bài đăng (schedule_post)

Lên lịch cho một bản nháp vào thời điểm cụ thể, thời điểm tốt nhất hoặc khung giờ đăng bài trống tiếp theo của bộ mạng xã hội. Không bao giờ đăng ngay lập tức. Với "best_time", Buzzmark chọn giờ trống sớm nhất mà các bài đăng trên những tài khoản này thường đạt hiệu quả tốt nhất, dựa trên số liệu chỉ Buzzmark lưu giữ (LinkedIn không cho phép ứng dụng AI sử dụng số liệu của mình), rồi trả về thời điểm đã chọn. Thời gian theo múi giờ của bộ, trừ khi có kèm độ lệch múi giờ. Khi bộ bật tính năng giờ đăng tự nhiên (theo thông tin từ list_social_sets), bài đăng sẽ được đăng sớm hoặc muộn hơn vài phút so với thời gian đã nêu; câu trả lời sẽ cho biết thời gian thực tế. Nếu vai trò của người dùng trong tổ chức yêu cầu phê duyệt trước, bản nháp sẽ được gửi đi phê duyệt thay thế (sent_for_approval trong câu trả lời) và được đăng sau khi một đồng đội phê duyệt. Để lên lịch nhiều bản nháp cùng lúc, dùng schedule_posts.

Đầu vào	Kiểu
post_id	số	Bắt buộc
when	văn bản	Bắt buộc	"best_time" (Buzzmark chọn thời điểm tốt nhất còn trống sớm nhất cho các tài khoản này), "next_slot" hoặc ngày và giờ: "2026-10-02T09:00" theo múi giờ của bộ, hoặc ISO 8601 có độ lệch múi giờ.
account_ids	danh sách số, tối đa 20	Không bắt buộc	Mặc định: các tài khoản đã lưu trong bản nháp, nếu không thì dùng các tài khoản mặc định của bộ.

Lên lịch nhiều bài đăng (schedule_posts)

Lên lịch tối đa 25 bản nháp cùng lúc, mỗi bản vào thời điểm riêng, thời điểm tốt nhất hoặc khung giờ trống tiếp theo; ví dụ các bản nháp được lưu bằng create_weekly_content_plan (ngày và giờ của mỗi bản là khung giờ của bản đó). Không bao giờ đăng ngay lập tức. Mỗi bản nháp được kiểm tra riêng: bản nào không thể đăng sẽ được báo cáo, còn các bản khác vẫn được lên lịch. Nếu vai trò của người dùng yêu cầu phê duyệt trước, các bản nháp sẽ được gửi đi phê duyệt thay thế.

Đầu vào	Kiểu
posts	danh sách đối tượng, tối đa 25	Bắt buộc	Mỗi bản nháp kèm thời gian (post_id, when, account_ids tùy chọn).

Dời bài đăng đã lên lịch (reschedule_post)

Dời bài đăng đã lên lịch sang ngày và giờ mới theo múi giờ của bộ, giữ nguyên chính xác thời gian đã chọn. Không bao giờ đăng ngay lập tức. Văn bản, ảnh và tài khoản vẫn giữ nguyên.

Đầu vào	Kiểu
post_id	số	Bắt buộc
when	văn bản	Bắt buộc	Ngày và giờ: "2026-10-02T09:00" theo múi giờ của bộ, hoặc ISO 8601 có độ lệch múi giờ.

Gỡ bài đăng khỏi lịch (unschedule_post)

Gỡ bài đăng đã lên lịch khỏi lịch và đưa trở lại bản nháp, giữ nguyên văn bản, ảnh và tài khoản để có thể chỉnh sửa hoặc lên lịch lại. Không có nội dung nào bị xóa. Ảnh mà hàng đợi đăng bài đang giữ sẽ được sao chép vào Buzzmark trước; nếu không thể sao chép ảnh nào đó, bài đăng vẫn giữ nguyên lịch.

Đầu vào	Kiểu
post_id	số	Bắt buộc

Xóa bản nháp (delete_draft)

Xóa vĩnh viễn một bản nháp. Không thể xóa bài đăng đã lên lịch hoặc đã đăng tại đây: trước tiên, dùng unschedule_post để đưa bài đã lên lịch trở lại bản nháp.

Đầu vào	Kiểu
post_id	số	Bắt buộc

Kiểm tra bài đăng theo giọng thương hiệu (check_post)

Chấm điểm từ 0 đến 100 về mức độ bài đăng giống với thương hiệu, kèm nhận xét ngắn, một điểm hiệu quả hoặc chưa phù hợp và tối đa ba chỉnh sửa giúp nâng điểm, mỗi chỉnh sửa là toàn bộ bài đăng được viết lại. Kiểm tra bất kỳ văn bản nào, kể cả văn bản được viết trong cuộc trò chuyện này, hoặc một bản nháp (post_id), với điểm số được lưu bên cạnh bản nháp trong Buzzmark. Không thay đổi nội dung bài đăng. Dùng công cụ này để đánh giá một bài đăng trước khi đăng; để xem hiệu quả của các bài đã đăng, dùng get_post_stats; để tìm điểm chung giữa chúng, dùng get_insights.

Đầu vào	Kiểu
text	văn bản, tối đa 10.000 ký tự	Không bắt buộc	Bài đăng cần kiểm tra. Bỏ qua để kiểm tra bản nháp được chỉ định bằng post_id.
post_id	số	Không bắt buộc
platform	văn bản	Không bắt buộc	ID nền tảng của Buzzmark mà bài đăng dành cho. Mặc định: tài khoản đầu tiên của bản nháp.
hive_profile_id	số	Không bắt buộc	ID hồ sơ thương hiệu từ list_brand_profiles. Mặc định: hồ sơ riêng của bộ mạng xã hội.
social_set_id	số	Không bắt buộc	ID bộ mạng xã hội từ list_social_sets. Không bắt buộc nếu tài khoản chỉ có một bộ.

Viết lại bài đăng (rewrite_post), chỉ đọc

Buzz viết lại bài đăng theo một cách và đưa ra tối đa ba phiên bản để lựa chọn, theo giọng thương hiệu và tuân thủ quy tắc viết của Buzzmark. Không có nội dung nào được lưu: hãy chuyển phiên bản người dùng chọn cho save_draft. Dùng công cụ này để thay đổi một bài đăng hiện có theo một cách; để tạo bài đăng mới từ một ý tưởng, dùng write_posts; để viết lại bản nháp đã lưu cho mọi nền tảng mà bản nháp sẽ đăng lên và lưu các phiên bản đó vào bản nháp, dùng adapt_for_platforms. Các thao tác: match_hive (viết theo giọng thương hiệu), fix_grammar (chỉ sửa chính tả và ngữ pháp), sharpen (rõ ràng, súc tích hơn), sting (tăng sức nặng), trim (rút ngắn còn khoảng một nửa), remix (dùng cách diễn đạt mới), expand (thêm một chi tiết cụ thể), structure (các dòng ngắn, dễ đọc lướt), warmer (ấm áp hơn), thread_hook (bài mở đầu của một thread), emoji, emoji_bullets, announcement (trình bày như tin tức), for_platform (viết lại theo cách nền tảng diễn đạt), custom (làm theo chỉ dẫn của người dùng).

Đầu vào	Kiểu
action	một trong các giá trị "match_hive", "fix_grammar", "sharpen", "sting", "trim", "remix", "expand", "structure", "warmer", "thread_hook", "emoji", "emoji_bullets", "announcement", "for_platform", "custom"	Bắt buộc
text	văn bản, tối đa 10.000 ký tự	Không bắt buộc	Bài đăng cần viết lại. Bỏ qua để viết lại một phần của bản nháp (post_id, part).
post_id	số	Không bắt buộc
part	số, từ 0 đến 24	Không bắt buộc	Bài đăng nào trong chuỗi, bắt đầu từ 0. Mặc định là 0
platform	văn bản	Không bắt buộc	ID nền tảng Buzzmark. Cần thiết cho for_platform; nếu không, giá trị này đặt độ dài mà bản viết lại sẽ giữ lại.
instruction	văn bản, tối đa 600 ký tự	Không bắt buộc	Dành cho custom: cách viết lại theo lời của người dùng.
hive_profile_id	số	Không bắt buộc	ID hồ sơ thương hiệu từ list_brand_profiles. Mặc định: hồ sơ của bộ mạng xã hội.
social_set_id	số	Không bắt buộc	ID bộ mạng xã hội từ list_social_sets. Không bắt buộc khi tài khoản chỉ có một bộ.

Tạo phiên bản cho từng nền tảng từ bản nháp (adapt_for_platforms)

Viết lại bản nháp theo cách đọc của từng nền tảng mà bài đăng sẽ xuất hiện (hoặc các nền tảng được nêu tên), rồi lưu các phiên bản đó vào bản nháp, giống như Spread thực hiện trong ứng dụng: tài khoản đầu tiên của bản nháp giữ nguyên bài đăng, mỗi nền tảng khác có văn bản riêng nhưng dùng chung hình ảnh. Phiên bản đã lưu trước đó cho một trong các nền tảng này sẽ bị thay thế. Chỉ áp dụng cho một bài đăng, không áp dụng cho chuỗi bài. Phiên bản LinkedIn giữ nguyên các thẻ LinkedIn dưới dạng @[link]; câu trả lời sẽ cảnh báo về mọi thẻ mà LinkedIn không tìm thấy. Dùng sau khi đã viết bản nháp và thêm các tài khoản vào đó; để thay đổi chính bài đăng, hãy dùng rewrite_post (hành động for_platform sẽ viết lại cho một nền tảng mà không lưu), còn để tạo bài đăng mới, hãy dùng write_posts.

Đầu vào	Kiểu
post_id	số	Bắt buộc
platforms	danh sách văn bản, tối đa 8	Không bắt buộc	ID nền tảng Buzzmark trong số các tài khoản của bản nháp. Mặc định: mọi nền tảng sau tài khoản đầu tiên.

Ý tưởng bài đăng từ tin tức và đối thủ cạnh tranh (get_post_ideas)

Ý tưởng bài đăng cho một thương hiệu từ Scout của Buzzmark: tin tức trong tuần thuộc lĩnh vực của thương hiệu, mỗi chủ đề kèm lý do vì sao chủ đề đó quan trọng vào lúc này, các nguồn tin và hai hoặc ba góc khai thác để đăng, cùng với các góc khai thác từ đối thủ cạnh tranh nếu Scout đã đọc nội dung của họ. Trả về kết quả đọc mới nhất của Scout cùng ngày đọc. Khi có refresh, hoặc khi Scout chưa từng đọc tin tức cho thương hiệu này, Scout sẽ đọc lại tin tức trước (tối đa một phút, được tính là một lần chạy Scout). Chỉ đưa ra ý tưởng: hãy dùng write_posts để soạn thành bài đăng.

Đầu vào	Kiểu
social_set_id	số	Không bắt buộc	ID bộ mạng xã hội từ list_social_sets. Không bắt buộc khi tài khoản chỉ có một bộ.
hive_profile_id	số	Không bắt buộc	ID hồ sơ thương hiệu từ list_brand_profiles. Mặc định: hồ sơ của bộ mạng xã hội.
refresh	có hoặc không	Không bắt buộc	Mặc định là false

Điều gì hiệu quả trong tháng này (get_insights)

Những điểm chung trong các bài đăng của thương hiệu trong 30 ngày qua khi chúng có kết quả tốt hơn hoặc kém hơn bài đăng trung bình của thương hiệu, tối đa một phát hiện và hai hành động được trình bày bằng câu văn đơn giản. Bài đăng LinkedIn được đọc riêng và phát hiện về chúng được lưu trong Buzzmark, vì LinkedIn không cho phép ứng dụng AI truy cập số liệu của mình. Mỗi phát hiện nêu rõ số liệu làm căn cứ (ví dụ: các bài đăng mở đầu bằng câu hỏi có mức độ tương tác cao gấp 2,3 lần bài đăng trung bình, dựa trên 5 trong số 19 bài đăng có số liệu) và một ý tưởng để áp dụng. Bài đăng được so sánh theo nền tảng, việc mở đầu bằng con số hay câu hỏi, độ dài, loại bài đăng, ngày trong tuần và thời điểm trong ngày. Chỉ đọc tối đa một lần mỗi ngày: cùng một câu trả lời sẽ được trả về cho đến khi số liệu thay đổi. Cần có 8 bài đăng có số liệu trong 30 ngày; nếu ít hơn, công cụ sẽ cho biết hiện có bao nhiêu bài. Dùng công cụ này để tìm hiểu nên làm gì nhiều hơn; để xem từng bài đăng và số liệu của bài đó, dùng get_post_stats; để tìm ngày và giờ tốt nhất trong tuần, dùng get_best_times; còn để đánh giá bản nháp trước khi đăng, dùng check_post.

Đầu vào	Kiểu
social_set_id	số	Không bắt buộc	Bộ mạng xã hội có hồ sơ thương hiệu cần đọc, nếu bỏ qua hive_profile_id. Không bắt buộc khi tài khoản chỉ có một bộ.
hive_profile_id	số	Không bắt buộc	ID hồ sơ thương hiệu từ list_brand_profiles. Mặc định: hồ sơ của bộ mạng xã hội, nếu không có thì dùng hồ sơ thương hiệu mặc định của tài khoản.

Thời điểm đăng tốt nhất (get_best_times), chỉ đọc

Các bài đăng đã xuất bản của bộ mạng xã hội đạt kết quả tốt nhất vào những thời điểm nào: 6 khung giờ và ngày trong tuần hiệu quả nhất theo múi giờ của bộ, xếp từ tốt nhất trở xuống; mỗi khung giờ cho biết số bài đăng và mức độ tương tác trung bình trên mỗi bài (lượt thích + bình luận + lượt chia sẻ hoặc đăng lại, lấy giá trị lớn hơn, + lượt lưu). Khung giờ có bài đăng không nhận được tương tác nào sẽ bị loại, vì vậy bộ chưa có tương tác sẽ không có khung giờ nào. Công cụ cho biết múi giờ của bộ và số bài đăng đã đọc. Bài đăng LinkedIn không được tính vì LinkedIn không cho phép ứng dụng AI truy cập số liệu của mình; bộ chỉ đăng lên LinkedIn sẽ nhận các khung giờ gợi ý từ một nghiên cứu công khai và các khung giờ đăng riêng của bộ. Để đăng vào thời điểm tốt nhất trên bất kỳ nền tảng nào, kể cả LinkedIn, hãy dùng schedule_post với when "best_time" để Buzzmark chọn thời điểm. Để xem kết quả của từng bài đăng, dùng get_post_stats; để biết các bài đăng có điểm gì chung, dùng get_insights.

Đầu vào	Kiểu
social_set_id	số	Không bắt buộc	ID bộ mạng xã hội từ list_social_sets. Không bắt buộc khi tài khoản chỉ có một bộ.
days	số, từ 14 đến 180	Không bắt buộc	Số ngày bài đăng đã xuất bản cần đọc, tính lùi từ hiện tại. Từ 14 đến 180, mặc định là 90.

Kết quả của các bài đăng gần đây (get_post_stats), chỉ đọc

Các bài đăng đã xuất bản của bộ mạng xã hội trong những ngày gần đây, được xếp hạng theo mức độ tương tác (lượt thích + bình luận + lượt chia sẻ hoặc đăng lại, lấy giá trị lớn hơn, + lượt lưu), tốt nhất trước. Mỗi bài đăng đi kèm nền tảng, thời điểm đăng theo múi giờ của bộ, nội dung, liên kết, mức độ tương tác, thông tin bài đăng có được đăng qua Buzzmark hay không và các số liệu; câu trả lời cũng cộng tổng số liệu của tất cả bài đăng trong khoảng thời gian đó. LinkedIn không cho phép ứng dụng AI truy cập số liệu của mình, vì vậy bài đăng LinkedIn được liệt kê riêng trong numbers_in_buzzmark_only, mới nhất trước, kèm thời điểm đăng, liên kết và nơi xem số liệu trong Buzzmark; các bài này không được tính vào tổng. Các số liệu gồm lượt hiển thị, phạm vi tiếp cận, lượt xem, lượt thích, bình luận, lượt chia sẻ, lượt lưu và lượt nhấp, dùng thuật ngữ riêng của nền tảng nếu có (replies, reposts, bookmarks, videoViews và upvotes). Số liệu mà nền tảng không báo cáo sẽ bị bỏ qua, không bao giờ hiển thị là 0. Dùng công cụ này để xem bài đăng nào hiệu quả nhất và hơn bao nhiêu; để biết các bài đăng có điểm gì chung, dùng get_insights; để tìm ngày và giờ tốt nhất trong tuần, dùng get_best_times; để xem bản nháp và bài đăng đã lên lịch, dùng list_posts; còn để xem đầy đủ một Buzz, dùng get_post.

Đầu vào	Kiểu
social_set_id	số	Không bắt buộc	ID bộ mạng xã hội từ list_social_sets. Không bắt buộc khi tài khoản chỉ có một bộ.
days	số, từ 1 đến 180	Không bắt buộc	Số ngày bài đăng đã xuất bản cần đọc, tính lùi từ hiện tại. Từ 1 đến 180, mặc định là 30.
limit	số, từ 1 đến 30	Không bắt buộc	Số bài đăng cần trả về, xếp từ tốt nhất trở xuống. Từ 1 đến 30, mặc định là 10. Tổng số liệu vẫn tính tất cả bài đăng trong khoảng thời gian đó.

Tạo hình ảnh (create_image)

Tạo hình ảnh bằng mô hình hình ảnh của Buzzmark và lưu vào Thư viện của người dùng. Nếu có post_id, hình ảnh cũng được thêm vào bản nháp đó. Hình ảnh sử dụng màu sắc của hồ sơ Hive; nếu nêu tên một sản phẩm Hive, ảnh thật của sản phẩm sẽ được dùng làm ảnh tham chiếu. Sử dụng một trong số tín dụng tạo ảnh của tháng; ảnh tạo thất bại hoặc bị từ chối sẽ không bị tính. Mất khoảng một phút.

Đầu vào	Kiểu
prompt	văn bản, tối đa 3.000 ký tự	Bắt buộc	Mô tả nội dung hình ảnh. Mặc định là ảnh chụp.
hive_profile_id	số	Không bắt buộc
product	văn bản, tối đa 200 ký tự	Không bắt buộc	Tên sản phẩm chính xác như trong hồ sơ Hive để dùng ảnh sản phẩm.
platforms	danh sách văn bản, tối đa 8	Không bắt buộc	Nơi đăng để chọn tỷ lệ khung hình (Instagram và Threads 4:5, TikTok 2:3, các nền tảng khác hình vuông). Mặc định: các nền tảng của bản nháp.
post_id	số	Không bắt buộc	Bản nháp cần thêm hình ảnh vào.
part	số, từ 0 đến 24	Không bắt buộc	Bài đăng nào trong chuỗi, bắt đầu từ 0. Mặc định là 0

Thêm hình ảnh hoặc video từ liên kết (add_media_from_url)

Sao chép hình ảnh hoặc video từ một liên kết https công khai vào Thư viện của người dùng trong Buzzmark; nếu có post_id, nội dung đó cũng được thêm vào bản nháp. Buzzmark lưu bản sao riêng, vì vậy bài đăng không phụ thuộc vào việc liên kết còn hoạt động hay không. Chấp nhận JPG, PNG, WebP, GIF, MP4 hoặc MOV: hình ảnh tối đa 10 MB, video tối đa 200 MB. Công cụ sẽ cho biết nội dung nào bị nền tảng từ chối, giống như create_image.

Đầu vào	Kiểu
url	văn bản, tối đa 2.000 ký tự	Bắt buộc	Liên kết https công khai trỏ thẳng đến tệp, không phải trang hiển thị tệp đó.
post_id	số	Không bắt buộc	Bản nháp cần thêm nội dung vào. Nếu không có, nội dung chỉ được thêm vào Thư viện.
part	số, từ 0 đến 24	Không bắt buộc	Bài đăng nào trong chuỗi, bắt đầu từ 0. Mặc định là 0

Lấy liên kết tải lên (create_upload_link)

Dùng cho hình ảnh hoặc video nằm trên máy tính hay điện thoại của người dùng, không có liên kết công khai. Trả về hai cách tải lên, cả hai đều dùng cho một tệp: upload_page là trang Buzzmark để gửi cho người dùng, nơi họ chọn tệp và tệp được thêm thẳng vào bản nháp (truyền post_id); còn nếu có file_name, upload_url dành cho ứng dụng có thể tự đọc tệp (như terminal hoặc hệ thống tệp): PUT byte của tệp lên đó với tiêu đề Content-Type mà câu trả lời cung cấp, sau đó gọi add_uploaded_media với upload_id. Chấp nhận JPG, PNG, WebP, GIF, MP4 hoặc MOV: hình ảnh tối đa 10 MB, video tối đa 200 MB.

Đầu vào	Kiểu
file_name	văn bản, tối đa 120 ký tự	Không bắt buộc	Tên tệp kèm phần mở rộng, như "launch.png", khi ứng dụng này tự tải tệp lên. Bỏ qua để chỉ lấy trang dành cho người dùng.
post_id	số	Không bắt buộc	Bản nháp cần thêm tệp vào. Nếu không có, tệp chỉ được thêm vào Thư viện.
part	số, từ 0 đến 24	Không bắt buộc	Bài đăng nào trong chuỗi, bắt đầu từ 0. Mặc định là 0

Thêm hình ảnh hoặc video đã tải lên (add_uploaded_media)

Sau khi tệp được PUT lên upload_url của create_upload_link: sao chép tệp vào Thư viện của người dùng trong Buzzmark; nếu có post_id, tệp cũng được thêm vào bản nháp. Công cụ sẽ cho biết nội dung nào bị nền tảng từ chối, giống như add_media_from_url. upload_id có hiệu lực trong 55 phút.

Đầu vào	Kiểu
upload_id	văn bản, tối đa 2.000 ký tự	Bắt buộc	upload_id từ create_upload_link.
post_id	số	Không bắt buộc	Bản nháp cần thêm nội dung vào. Nếu không có, nội dung chỉ được thêm vào Thư viện.
part	số, từ 0 đến 24	Không bắt buộc	Bài đăng nào trong chuỗi, bắt đầu từ 0. Mặc định là 0

Thêm hình ảnh hoặc video từ cuộc trò chuyện này (add_media_from_chat)

Hình ảnh hoặc video người dùng đính kèm trong cuộc trò chuyện này: sao chép vào Thư viện của họ trong Buzzmark; nếu có post_id, nội dung đó cũng được thêm vào bản nháp. Công cụ sẽ cho biết nội dung nào bị nền tảng từ chối. Chấp nhận JPG, PNG, WebP, GIF, MP4 hoặc MOV: hình ảnh tối đa 10 MB, video tối đa 200 MB.

Đầu vào	Kiểu
file	đối tượng	Bắt buộc	Tệp người dùng đính kèm trong cuộc trò chuyện.
post_id	số	Không bắt buộc	Bản nháp cần thêm nội dung vào. Nếu không có, nội dung chỉ được thêm vào Thư viện.
part	số, từ 0 đến 24	Không bắt buộc	Bài đăng nào trong chuỗi, bắt đầu từ 0. Mặc định là 0

Lên kế hoạch cho tuần (create_weekly_content_plan)

Kế hoạch cho 7 ngày tới của một bộ mạng xã hội: mục đích của tuần, 2 đến 4 trụ cột nội dung và một bài đăng sẵn sàng chỉnh sửa cho mỗi khung giờ đăng, mỗi bài có ngày, giờ, nền tảng, ý tưởng hình ảnh và lý do đăng. Kế hoạch được xây dựng dựa trên hồ sơ Hive của bộ, các khung giờ đăng, thời điểm đăng hiệu quả nhất, hiệu quả của các bài đăng gần đây và những gì đã được lên lịch. Số liệu LinkedIn không được dùng để viết kế hoạch: sau đó, Buzzmark chuyển từng bài chỉ dành cho LinkedIn sang khung giờ hiệu quả nhất trong ngày đó trên LinkedIn. Cần có tài khoản đã kết nối; nếu có ít hơn 8 bài đăng đã xuất bản kèm số liệu, kế hoạch sẽ dựa nhiều hơn vào giọng điệu thương hiệu và thông lệ của các nền tảng, đồng thời nêu rõ điều đó. Kế hoạch được lưu trong Library. Trước tiên, hãy hỏi người dùng xem họ có muốn các bài đăng ở dạng bản nháp không: với save_as_drafts, mỗi bài đăng cũng trở thành bản nháp, rồi schedule_posts sẽ đưa tất cả vào các khung giờ của chúng chỉ trong một lần. Mỗi bài đăng được lên kế hoạch được tính là một Buzz viết thay bạn. Quá trình này mất tối đa một phút.

Đầu vào	Kiểu
social_set_id	number	Không bắt buộc	ID bộ mạng xã hội từ list_social_sets. Không bắt buộc nếu tài khoản chỉ có một bộ.
goal	text, tối đa 600 ký tự	Không bắt buộc	Mục tiêu của tuần, theo lời người dùng: ra mắt sản phẩm, sự kiện, tăng số lượt đặt chỗ.
start	text	Không bắt buộc	Ngày đầu tiên, YYYY-MM-DD theo múi giờ của bộ. Mặc định: ngày mai.
save_as_drafts	yes or no	Không bắt buộc	Mặc định false

Các hướng dẫn chúng tôi xuất bản

Mỗi hướng dẫn so sánh các công cụ dựa trên thông tin mà từng công cụ công bố. Buzzmark là một trong số đó và mỗi trang đều nêu rõ đơn vị tạo ra công cụ.

• Các máy chủ MCP mạng xã hội tốt nhất: Thông tin mỗi công cụ công bố về máy chủ MCP của mình: gói dịch vụ, các ứng dụng AI được nêu tên và API.

Câu hỏi về máy chủ

Những ứng dụng nào đã được thử nghiệm?

Claude, ChatGPT, Grok và Cursor đều có trang riêng. Mọi ứng dụng hỗ trợ MCP qua Streamable HTTP với OAuth 2.1 hoặc tiêu đề Bearer đều sẽ hoạt động; ứng dụng chỉ hỗ trợ stdio cần có cầu nối.

Vì sao không có công cụ đăng ngay?

Để chủ tài khoản có quyền quyết định cuối cùng. schedule_post yêu cầu thời gian đăng cách hiện tại ít nhất 5 phút hoặc khung giờ đăng trống tiếp theo, và có thể thu hồi Buzz đã lên lịch trong ứng dụng.

Lỗi xuất phát từ đâu?

Mỗi thông báo từ chối là một câu do Buzzmark viết, nêu lý do và cách xử lý: giới hạn của nền tảng, thiếu hình ảnh hoặc bộ chưa có hàng đợi. Không có thông báo nào từ nhà cung cấp được chuyển đến ứng dụng.

Có cả REST API không?

Chưa có. Hiện tại, máy chủ MCP là cách để các ứng dụng AI kết nối và có trong mọi gói dịch vụ.

Thiết lập trong

• Buzzmark trong Claude: Một lần nhấn trong thư mục của Claude hoặc một lệnh trong Claude Code.
• Buzzmark trong ChatGPT: Một lần nhấn trong mục plugin của ChatGPT.
• Buzzmark trong Grok: Một trình kết nối tùy chỉnh tại grok.com, kèm đăng nhập.
• Buzzmark trong Cursor: Một khối cấu hình, kèm đăng nhập hoặc khóa API.