Danh mục Công cụ MCP

27 công cụ được cung cấp bởi Ayrshare MCP Server — bài đăng, lịch sử, phân tích, bình luận, tin nhắn trực tiếp, profiles, media, generation, webhook và lỗi — nhóm theo miền với phạm vi và mục đích.

MCP Server của Ayrshare cung cấp 27 công cụ, được nhóm bên dưới theo miền. Mỗi công cụ được điều phối trong tiến trình qua chuỗi Ayrshare API thực tế.

​

Phạm vi

Mọi công cụ đều có phạm vi Profile hoặc Account:

• Profile — công cụ chấp nhận đối số profileKey để nhắm tới một sub-profile.
• Account — công cụ không nhận profileKey; nó hoạt động ở cấp độ tài khoản.

Sáu công cụ không nhận đối số profileKey là: create_profile, list_profiles, explain_error, validate_media, generate_post, và recommend_hashtags. Tất cả các công cụ khác chấp nhận profileKey; generate_jwt_social_linking_url bắt buộc phải có. Lưu ý: recommend_hashtags không nhận đối số profileKey nhưng vẫn đọc header Profile-Key của kết nối để chọn tài khoản TikTok đã liên kết của ai để lấy dữ liệu, vì vậy kết quả của nó là cụ thể theo profile.

Khi có cả đối số profileKey theo lệnh gọi và header Profile-Key, đối số thắng. Xem Kết nối & Thiết lập để biết các quy tắc ưu tiên.

​

Bài đăng

Công cụ	Phạm vi	Mục đích
create_post	Profile	Xuất bản đến một hoặc nhiều nền tảng đã liên kết.
validate_post	Profile	Xác thực dry-run, cùng đầu vào như create_post.
get_post	Profile	Lấy một bài đăng theo Ayrshare Post ID.
update_post	Profile	Cập nhật một bài đăng đã lên lịch hoặc đang chờ phê duyệt.
retry_post	Profile	Gửi lại một bài đăng thất bại.

​

Lịch sử

Công cụ	Phạm vi	Mục đích
get_post_history	Profile	Bài đăng được gửi qua Ayrshare.
get_platform_history	Profile	Bài đăng và phân tích trực tiếp từ mạng, bao gồm các bài đăng không thuộc Ayrshare. Đối với tra cứu userId/userName của X/Twitter, hãy chỉ sử dụng API key tài khoản; một đối số profileKey hoặc header Profile-Key ở đó sẽ trả về Lỗi 400.

​

Phân tích

Công cụ	Phạm vi	Mục đích
get_post_analytics	Profile	Số liệu theo bài đăng theo Ayrshare Post ID.
get_post_analytics_by_social_id	Profile	Số liệu theo bài đăng theo Social Post ID gốc.
get_social_network_analytics	Profile	Phân tích toàn tài khoản và nhân khẩu học cho một tài khoản mạng xã hội đã kết nối. Đối với tra cứu userId/userName của X/Twitter, hãy chỉ sử dụng API key tài khoản; một đối số profileKey hoặc header Profile-Key ở đó sẽ trả về Lỗi 400.

​

Bình luận

Công cụ	Phạm vi	Mục đích
get_comments	Profile	Đọc bình luận trên một bài đăng.
add_comment	Profile	Bình luận cấp cao nhất.
reply_comment	Profile	Trả lời một bình luận.

​

Tin nhắn / DM

Công cụ	Phạm vi	Mục đích
get_messages	Profile	Lấy DM cho một nền tảng.
send_message	Profile	Gửi một DM.
get_auto_response	Profile	Đọc cài đặt tự động phản hồi DM.
set_auto_response	Profile	Cấu hình tự động phản hồi DM.

​

Profiles

Công cụ	Phạm vi	Mục đích
list_profiles	Account	Liệt kê các sub-profile.
create_profile	Account	Tạo một sub-profile.
generate_jwt_social_linking_url	Profile	Tạo URL social-linking JWT (yêu cầu profileKey).

​

Media

Công cụ	Phạm vi	Mục đích
validate_media	Account	HEAD-check một URL media có thể truy cập được; trả về contentType.

​

Generate

Công cụ	Phạm vi	Mục đích
generate_post	Account	Bản nháp nội dung bài đăng do AI tạo.
recommend_hashtags	Account	Gợi ý hashtag từ dữ liệu số lượt xem TikTok. Sử dụng tài khoản TikTok đã liên kết trên profile được đặt bởi header Profile-Key; không nhận profileKey theo lệnh gọi.

​

Webhook

Công cụ	Phạm vi	Mục đích
register_webhook	Profile	Đăng ký một webhook.
unregister_webhook	Profile	Hủy đăng ký một webhook.
list_webhooks	Profile	Liệt kê các webhook đã đăng ký.

​

Lỗi

Công cụ	Phạm vi	Mục đích
explain_error	Account	Giải mã một mã lỗi Ayrshare thành nguyên nhân, phân loại và cách khắc phục.

Danh mục này được xác minh với tools/list của server live. Nhiều công cụ hơn được lên kế hoạch (ví dụ: các công cụ Links). Nếu có nghi ngờ, hãy truy vấn tools/list để có tập hợp có thẩm quyền. Danh mục này được duy trì bởi đội ngũ MCP server.