Plugin Claude Code

Plugin Ayrshare cho Claude Code đóng gói cấu hình MCP Server, một lệnh thiết lập, các agent, các skill và một hook an toàn. Khi được cài đặt, bạn có thể xuất bản bài đăng, lấy lịch sử và phân tích, quản lý profiles, và nhiều hơn nữa — trực tiếp từ Claude Code. Trước khi bất cứ điều gì được đăng, agent sẽ xác thực từng bài đăng theo quy tắc của mạng đích và yêu cầu bạn xác nhận, phát hiện các từ chối có thể tránh được ngay từ đầu. Lịch sử bài đăng có sẵn để khớp với brand voice và phân tích có thể được đọc lại để định hướng cho bài đăng tiếp theo. Plugin là mã nguồn mở. Xem repository để biết chi tiết bên trong: ayrshare/ayrshare-social-media-api-claude-plugin.

Cài đặt

Thêm marketplace (một lần)

claude plugin marketplace add ayrshare/ayrshare-social-media-api-claude-plugin

Cài đặt plugin

claude plugin install ayrshare@ayrshare

Phạm vi cài đặt

Phạm vi	Nơi áp dụng
Global (mặc định)	Mọi dự án trên máy này.
`--scope local`	Dự án hiện tại, không commit vào git.
`--scope project`	Dự án hiện tại, được commit và chia sẻ với đội của bạn.

CLI của Claude Code gọi phạm vi global là --scope user.

Thông tin xác thực

Cung cấp Ayrshare API key của bạn bằng một trong hai cách sau:

Chạy /ayrshare:setup để cấu hình hoặc xoay vòng khóa.
Đặt biến môi trường AYRSHARE_API_KEY.

Tệp .mcp.json được đóng gói của plugin đã khai báo header Authorization cùng với các header Profile-Key và X BYOK tùy chọn, mỗi header có giá trị mặc định rỗng (${VAR:-}), vì vậy bạn kích hoạt một header đơn giản bằng cách đặt biến môi trường tương ứng (Claude Code thay thế các giá trị khi khởi động). Để nhắm tới một sub-profile trên mỗi lệnh gọi, hãy đặt AYRSHARE_PROFILE_KEY (qua /ayrshare:setup hoặc khối env trong settings.json của bạn) và khởi động lại Claude Code; header Profile-Key được đóng gói sẽ mang nó và giữ trống (được coi là không cung cấp) khi không được đặt. Để nhắm tới một sub-profile cho một lệnh gọi duy nhất, hãy truyền một đối số công cụ profileKey (không cần thay đổi cấu hình). Bạn không cần chỉnh sửa .mcp.json được đóng gói và bạn không nên, vì claude plugin update sẽ ghi đè nó.

MCP server khởi tạo khi bắt đầu phiên. Khởi động lại Claude Code sau khi cài đặt plugin hoặc thay đổi khóa của bạn.

Thông tin xác thực BYO cho X/Twitter

Đăng lên X/Twitter yêu cầu thông tin xác thực X Developer App của riêng bạn (yêu cầu bắt buộc X BYO-key, có hiệu lực từ ngày 31 tháng 3 năm 2026; xem Tổng quan API). Tệp .mcp.json được đóng gói đã khai báo cả hai header X BYOK với giá trị mặc định rỗng, bên cạnh Authorization và Profile-Key:

"headers": {
  "Authorization": "Bearer ${AYRSHARE_API_KEY}",
  "Profile-Key": "${AYRSHARE_PROFILE_KEY:-}",
  "X-Twitter-OAuth1-Api-Key": "${X_TWITTER_OAUTH1_API_KEY:-}",
  "X-Twitter-OAuth1-Api-Secret": "${X_TWITTER_OAUTH1_API_SECRET:-}"
}

Vì vậy bạn chỉ cần đặt các biến môi trường tương ứng (X_TWITTER_OAUTH1_API_KEY, X_TWITTER_OAUTH1_API_SECRET) qua /ayrshare:setup hoặc env trong settings.json, rồi khởi động lại Claude Code; bạn không chỉnh sửa .mcp.json được đóng gói (nó bị ghi đè khi claude plugin update). Đặt cả hai hoặc không đặt: nếu không đặt cả hai, một lệnh gọi X/Twitter sẽ trả về lỗi 419 (x_credentials_required); nếu chỉ đặt một, nó trả về lỗi 400. Đây là một cặp khóa cho mỗi tài khoản Ayrshare, được gửi trên mọi yêu cầu nhắm tới X (cùng cặp cho tất cả các sub-profile).

Ưu tiên kết nối thô hơn plugin? Các header BYO tương tự có thể được truyền qua claude mcp add --header — xem Kết nối & Thiết lập → Thông tin xác thực BYO cho X/Twitter.

Nội dung được cung cấp

Lệnh

/ayrshare:setup — cấu hình hoặc xoay vòng Ayrshare API key.

Agents

social-manager: xuất bản, lên lịch và phân tích nội dung trên các nền tảng.
profile-manager: tạo và liệt kê profiles và tạo các URL social-linking JWT cho các profile của khách hàng dưới tài khoản Business.
insights-analyst: báo cáo chỉ đọc. Kéo các số liệu và lịch sử bài đăng và tóm tắt hiệu suất; không bao giờ xuất bản, bình luận, gửi tin nhắn hoặc sửa đổi bất cứ điều gì.

Skills

Skill	Mục đích
`getting-started`	Định hướng và kết nối cho lần sử dụng đầu tiên.
`post`	Tạo, xác thực, cập nhật và thử lại bài đăng.
`history`	Truy xuất lịch sử bài đăng và nền tảng.
`analytics`	Kéo phân tích theo bài đăng và cấp tài khoản.
`comments`	Đọc, thêm và trả lời bình luận.
`messages`	Đọc và gửi tin nhắn trực tiếp và cấu hình tự động phản hồi.
`profiles`	Tạo và liệt kê các sub-profile.
`media`	Xác thực rằng các URL media có thể truy cập được.
`generate`	Bản nháp nội dung bài đăng do AI tạo và đề xuất hashtag.
`webhooks`	Đăng ký, hủy đăng ký và liệt kê các webhook.
`errors`	Giải mã các mã lỗi Ayrshare.
`draft-in-brand-voice`	Soạn thảo nội dung bài đăng theo brand voice nhất quán.
`plan-and-schedule-campaign`	Lên kế hoạch và lên lịch một chiến dịch nhiều bài đăng.

Hook xác nhận

Một hook PreToolUse yêu cầu xác nhận trước bất kỳ hành động xuất bản hoặc gửi nào. Nó bao gồm chính xác 7 công cụ sau:

create_post
update_post
retry_post
add_comment
reply_comment
send_message
set_auto_response

FAQ

Plugin có xác thực bài đăng trước khi xuất bản không?

Có. Plugin chạy validate_post để dry-run nội dung của bạn theo quy tắc của từng mạng — độ dài, định dạng và yêu cầu media — trước khi xuất bản, để bạn phát hiện các từ chối có thể tránh được ngay từ đầu.

Nó có hỏi trước khi đăng lên các tài khoản trực tiếp của tôi không?

Có. Một hook xác nhận PreToolUse yêu cầu bạn phê duyệt trước bất kỳ hành động xuất bản hoặc gửi nào: create_post, update_post, retry_post, add_comment, reply_comment, send_message, và set_auto_response.

Plugin có thể khớp với brand voice của tôi không?

Có. Skill draft-in-brand-voice đọc lịch sử bài đăng của bạn để soạn thảo nội dung mới theo brand voice nhất quán. Nó chỉ tạo bản nháp — không có gì được xuất bản nếu không có xác nhận của bạn.

Tôi có thể đọc phân tích để định hướng bài đăng tiếp theo không?

Có. Các công cụ phân tích trả về các số liệu theo bài đăng và cấp tài khoản, để bạn có thể đọc lại kết quả và để chúng định hướng bài đăng tiếp theo của bạn.

Tôi cần gì để sử dụng plugin?

Một Ayrshare API key (khóa Business plan cho profiles và sub-profiles) và Claude Code. Cấu hình khóa với /ayrshare:setup hoặc biến môi trường AYRSHARE_API_KEY, sau đó khởi động lại Claude Code.

Đăng lên X/Twitter có cần thiết lập thêm không?

Có. X/Twitter yêu cầu thông tin xác thực OAuth 1.0a của riêng bạn, được thêm dưới dạng hai header kết nối (X-Twitter-OAuth1-Api-Key và X-Twitter-OAuth1-Api-Secret). Xem Thông tin xác thực BYO cho X/Twitter ở trên.

Cài đặt

Phạm vi cài đặt

Thông tin xác thực

Thông tin xác thực BYO cho X/Twitter

Nội dung được cung cấp

Lệnh

Agents

Skills

Hook xác nhận

FAQ

Các bước tiếp theo

Kết nối & Thiết lập

Danh mục Công cụ

​Cài đặt

​Phạm vi cài đặt

​Thông tin xác thực

​Thông tin xác thực BYO cho X/Twitter

​Nội dung được cung cấp

​Lệnh

​Agents

​Skills

​Hook xác nhận

​FAQ

​Các bước tiếp theo

Kết nối & Thiết lập

Danh mục Công cụ

Cài đặt

Phạm vi cài đặt

Thông tin xác thực

Thông tin xác thực BYO cho X/Twitter

Nội dung được cung cấp

Lệnh

Agents

Skills

Hook xác nhận

FAQ

Các bước tiếp theo