Перейти до основного вмісту
Ayrshare plugin для Claude Code містить конфігурацію MCP Server, команду налаштування, agents, skills та safety hook. Після встановлення ви можете публікувати пости, отримувати історію та аналітику, керувати профілями тощо — безпосередньо з Claude Code. Перед тим, як щось буде опубліковано, агент валідує кожен пост за правилами цільової мережі та просить вас підтвердити, ловлячи легко уникнені відхилення заздалегідь. Історія постів доступна для узгодження з голосом бренду, а аналітику можна прочитати, щоб інформувати наступний пост. Plugin — з відкритим кодом. Дивіться репозиторій для внутрішніх деталей: ayrshare/ayrshare-social-media-api-claude-plugin.

​
Встановлення

1

Додайте marketplace (одноразово)

2

Встановіть plugin

​
Області встановлення (Scopes)

CLI Claude Code називає global scope як --scope user.

​
Облікові дані

Надайте ваш API-ключ Ayrshare одним із цих способів:
  • Запустіть /ayrshare:setup, щоб налаштувати або оновити ключ.
  • Встановіть змінну середовища AYRSHARE_API_KEY.
.mcp.json plugin вже оголошує заголовок Authorization плюс необов’язкові заголовки Profile-Key та X BYOK, кожен з порожнім значенням за замовчуванням (${VAR:-}), тож ви вмикаєте заголовок просто встановивши його змінну середовища (Claude Code підставляє значення при запуску). Щоб націлитися на sub-profile при кожному виклику, встановіть AYRSHARE_PROFILE_KEY (через /ayrshare:setup або блок env вашого settings.json) і перезапустіть Claude Code; вкладений заголовок Profile-Key містить його і залишається порожнім (розглядається як не наданий), коли не встановлено. Щоб націлитися на sub-profile для одного виклику, натомість передайте аргумент інструменту profileKey (без змін конфігурації). Вам не потрібно редагувати вкладений .mcp.json і не слід, оскільки claude plugin update перезаписує його.
MCP-сервер ініціалізується на початку сесії. Перезапустіть Claude Code після встановлення plugin або зміни ключа.

​
X/Twitter BYO credentials

Публікація в X/Twitter потребує ваших власних облікових даних X Developer App (обов’язковий X BYO-key, що набуває чинності 31 березня 2026 року; див. API Overview). Вкладений .mcp.json вже оголошує обидва заголовки X BYOK з порожніми значеннями за замовчуванням, поряд з Authorization і Profile-Key:
Тому ви лише встановлюєте відповідні змінні середовища (X_TWITTER_OAUTH1_API_KEY, X_TWITTER_OAUTH1_API_SECRET) через /ayrshare:setup або env вашого settings.json, потім перезапускаєте Claude Code; ви не редагуєте вкладений .mcp.json (він перезаписується при claude plugin update). Встановіть обидва або жодного: без обох, виклик X/Twitter повертає помилку 419 (x_credentials_required); з встановленим лише одним, повертається помилка 400. Це одна пара ключів на обліковий запис Ayrshare, надсилається з кожним запитом, спрямованим на X (та сама пара для всіх sub-profiles).
Віддаєте перевагу прямому підключенню перед plugin? Ті самі BYO-заголовки можна передати через claude mcp add --header — див. Connect & Setup → X/Twitter BYO credentials.

​
Що поставляється

​
Command

  • /ayrshare:setup — налаштувати або оновити API-ключ Ayrshare.

​
Agents

  • social-manager: публікує, планує та аналізує контент на різних платформах.
  • profile-manager: створює та перераховує профілі і генерує URL для соціального зв’язку JWT для клієнтських профілів під обліковим записом Business.
  • insights-analyst: звітування лише для читання. Витягує метрики та історію постів і підсумовує продуктивність; ніколи не публікує, не коментує, не надсилає повідомлення і не модифікує нічого.

​
Skills

​
Confirmation hook

Hook PreToolUse запитує підтвердження перед будь-якою дією публікації або надсилання. Він охоплює саме ці 7 інструментів:
  • create_post
  • update_post
  • retry_post
  • add_comment
  • reply_comment
  • send_message
  • set_auto_response

​
FAQ

Так. Plugin запускає validate_post для сухого прогону вашого контенту через правила кожної мережі — довжину, формат і вимоги до медіа — перед публікацією, тож ви ловите легко уникнені відхилення заздалегідь.
Так. Hook підтвердження PreToolUse пропонує вам схвалити перед будь-якою дією публікації або надсилання: create_post, update_post, retry_post, add_comment, reply_comment, send_message та set_auto_response.
Так. Skill draft-in-brand-voice читає вашу історію постів, щоб створити чернетки нового тексту в постійному голосі бренду. Він створює лише чернетки — нічого не публікується без вашого підтвердження.
Так. Інструменти аналітики повертають метрики для окремого поста та на рівні облікового запису, щоб ви могли прочитати результати та дозволити їм направляти ваш наступний пост.
API-ключ Ayrshare (ключ плану Business для profiles і sub-profiles) та Claude Code. Налаштуйте ключ за допомогою /ayrshare:setup або змінної середовища AYRSHARE_API_KEY, потім перезапустіть Claude Code.
Так. X/Twitter потребує ваших власних OAuth 1.0a облікових даних, доданих як два заголовки підключення (X-Twitter-OAuth1-Api-Key та X-Twitter-OAuth1-Api-Secret). Див. X/Twitter BYO credentials вище.

​
Наступні кроки

Connect & Setup

Автентифікація, націлювання на профіль і BYO credentials.

Tool Catalog

27 інструментів, згрупованих за доменами, з областю дії та призначенням.