Каталог інструментів MCP

Ayrshare MCP Server надає 33 інструменти, згруповані нижче за доменами. Кожен інструмент диспетчеризується в межах процесу через реальний ланцюжок Ayrshare API.

Область дії

Кожен інструмент має область дії Profile або Account:

Profile — інструмент приймає аргумент profileKey для націлювання на sub-profile.
Account — інструмент не приймає profileKey; він працює на рівні акаунту.

Шість інструментів, які не приймають аргумент profileKey: create_profile, list_profiles, explain_error, validate_media, generate_post та recommend_hashtags. Усі інші інструменти приймають profileKey; generate_jwt_social_linking_url вимагає його. Примітка: recommend_hashtags не приймає аргумент profileKey, але все ж читає заголовок Profile-Key підключення, щоб визначити, з чийого підключеного акаунту TikTok брати дані, тож його результати є специфічними для профілю. Коли одночасно присутні аргумент profileKey виклику та заголовок Profile-Key, перевагу має аргумент. Див. Connect & Setup для правил пріоритету.

Публікації

Інструмент	Область	Призначення
`create_post`	Profile	Публікація на одну або кілька підключених платформ.
`validate_post`	Profile	Валідація без запуску, ті самі вхідні дані, що й у `create_post`.
`get_post`	Profile	Отримати публікацію за Ayrshare Post ID.
`update_post`	Profile	Оновити заплановану публікацію або таку, що очікує на схвалення.
`retry_post`	Profile	Повторно надіслати невдалу публікацію.

Історія

Інструмент	Область	Призначення
`get_post_history`	Profile	Публікації, надіслані через Ayrshare.
`get_platform_history`	Profile	Публікації та аналітика безпосередньо з мережі, включно з публікаціями, не пов’язаними з Ayrshare. Для пошуку `userId`/`userName` в X/Twitter використовуйте лише API Key акаунту; наявність аргументу `profileKey` або заголовка `Profile-Key` повертає Error 400.

Аналітика

Інструмент	Область	Призначення
`get_post_analytics`	Profile	Метрики окремої публікації за Ayrshare Post ID.
`get_post_analytics_by_social_id`	Profile	Метрики окремої публікації за нативним Social Post ID.
`get_social_network_analytics`	Profile	Аналітика та демографія на рівні акаунту для підключеного соціального акаунту. Для пошуку `userId`/`userName` в X/Twitter використовуйте лише API Key акаунту; наявність аргументу `profileKey` або заголовка `Profile-Key` повертає Error 400.

Коментарі

Інструмент	Область	Призначення
`get_comments`	Profile	Читати коментарі до публікації.
`add_comment`	Profile	Коментар верхнього рівня.
`reply_comment`	Profile	Відповісти на коментар.

Повідомлення / DM

Інструмент	Область	Призначення
`get_messages`	Profile	Отримати DM для платформи.
`send_message`	Profile	Надіслати DM.
`get_auto_response`	Profile	Читати налаштування автовідповіді DM.
`set_auto_response`	Profile	Налаштувати автовідповідь DM.

Профілі

Інструмент	Область	Призначення
`list_profiles`	Account	Список sub-profiles.
`create_profile`	Account	Створити sub-profile.
`generate_jwt_social_linking_url`	Profile	Створити JWT-URL прив’язки соціальних акаунтів (потребує `profileKey`).

Медіа

Інструмент	Область	Призначення
`validate_media`	Account	HEAD-перевірка доступності URL медіа; повертає `contentType`.

Генерація

Інструмент	Область	Призначення
`generate_post`	Account	AI-чернетка тексту публікації.
`recommend_hashtags`	Account	Пропозиції хештегів на основі даних про перегляди TikTok. Використовує підключений акаунт TikTok у профілі, заданому заголовком `Profile-Key`; не приймає `profileKey` на рівні виклику.

Вебхуки

Інструмент	Область	Призначення
`register_webhook`	Profile	Зареєструвати вебхук.
`unregister_webhook`	Profile	Скасувати реєстрацію вебхука.
`list_webhooks`	Profile	Список зареєстрованих вебхуків.

Оголошення

Інструменти для оголошень потребують доповнення Ads. Без нього вони повертають Error 403: Ads is not enabled. Please subscribe to Ads in the Account page. (code 399). Кожен інструмент приймає аргумент platform: facebook або instagram.

Інструмент	Область	Призначення
`list_ad_accounts`	Profile	Список рекламних акаунтів, з яких може витрачати кошти підключений акаунт.
`search_ad_targeting`	Profile	Пошук параметрів таргетингу: `interests`, `regions` або `cities`.
`list_ads`	Profile	Список просуваних оголошень за кампанією, акаунтом, оголошенням або публікацією.
`update_ad`	Profile	Призупинити, відновити або вивести оголошення з обігу. Статус також встановлюється для його набору оголошень і кампанії, тому інші оголошення в них теж змінюються, окрім кампанії або набору оголошень, до яких просування було приєднано через `attachTo`; оголошення показується лише тоді, коли обидва активні. `status` приймає `ACTIVE`, `PAUSED`, `DELETED` або `ARCHIVED`, повністю великими або повністю малими літерами (`paused` працює, `Paused` — ні). Змінює реальні рекламні витрати.
`get_ad_history`	Profile	Історія витрат і ефективності просуваних оголошень.
`boost_post`	Profile	Просунути опубліковану публікацію як оголошення. Приймає `postId` або `socialPostId`, `accountId` з `list_ad_accounts`, `goal` і `budget` (з `attachTo.adSetId` не передавайте `budget` і `targeting`). Налаштування, які має лише одна платформа, розміщуються в `platformOptions`; на Facebook та Instagram `platformOptions.<platform>.adName` і `.bidAmount` обов’язкові, окрім `.bidAmount` з `attachTo.adSetId`. Витрачає реальні гроші. Якщо не вказано інше, оголошення активне, починає показуватися одразу й не має дати завершення. Надішліть `idempotencyKey` і використайте його повторно з тими самими аргументами під час повторного виклику. Тоді повторний виклик поверне перший результат, а не створить друге оголошення.

Помилки

Інструмент	Область	Призначення
`explain_error`	Account	Розшифрувати код помилки Ayrshare на причину, класифікацію та виправлення.

Цей каталог перевірено відносно tools/list живого сервера. Плануються додаткові інструменти (наприклад, інструменти для Links). У разі сумнівів запитайте tools/list для авторитетного набору. Каталог підтримується командою MCP server.

Get Started

API Endpoints

Multiple Users

Dashboard

Additional

Каталог інструментів MCP

Область дії

Публікації

Історія

Аналітика

Коментарі

Повідомлення / DM

Профілі

Медіа

Генерація

Вебхуки

Оголошення

Помилки

​Область дії

​Публікації

​Історія

​Аналітика

​Коментарі

​Повідомлення / DM

​Профілі

​Медіа

​Генерація

​Вебхуки

​Оголошення

​Помилки

Область дії

Публікації

Історія

Аналітика

Коментарі

Повідомлення / DM

Профілі

Медіа

Генерація

Вебхуки

Оголошення

Помилки