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). |
| 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.
