Довідник інструментів
Усі MCP-інструменти ReviewSmith для Claude, ChatGPT та інших клієнтів — параметри, результати й які з них змінюють дані.
Інструменти читання нічого не змінюють. Інструменти запису лише додають дані всередині ReviewSmith.
Деструктивні інструменти перезаписують чи видаляють дані або змінюють щось публічне чи незворотне (відповідь у Google, повідомлення
клієнтам), тож ШІ-клієнти просять вашого підтвердження перед запуском. Списки посторінкові
(cursor / next_cursor).
Читання
| Інструмент | Що робить | Основні параметри |
|---|---|---|
list_locations |
Локації з робочим простором клієнта, джерелом, станом синхронізації й тим, чи можна публікувати відповіді | client_id, include_inactive |
list_reviews |
Відгуки від найновіших із фільтрами; відгуки Google повторно завантажуються, якщо вони старші за 30 хвилин | location_id, client_id, since, until, rating_min, rating_max, unreplied_only, source, query, cursor, limit (до 50) |
get_review |
Один відгук повністю: оригінал і переклад, відповідь і її статус у Google, чернетки, відповідні шаблони | review_id |
get_review_stats |
Актуальні показники за локаціями: власні середня оцінка й кількість відгуків від Google, а також підрахунки за останніми відгуками, отриманими в цьому запиті (розподіл, без відповіді, частка відповідей, медіанний час відповіді). Платні тарифи також бачать активність команди (чернетки, схвалення, публікації, запити, переходи). Нічого не зберігається | location_id, client_id, sample_size, activity_days |
get_brand_voice |
Тон, списки «завжди/ніколи», підпис, контакт для незадоволених клієнтів, мови й приклади | location_id |
list_reply_templates |
Ваші шаблони відповідей із фільтром за оцінкою й мовою | rating, language, cursor |
list_reply_drafts |
Чернетки та їхній статус (чернетка, схвалено, опубліковано, помилка) | status, location_id, cursor |
list_review_requests |
Кампанії запитів на відгуки й статус за отримувачами (контакти замасковано) | campaign_id, status, cursor |
preview_review_requests |
Перевіряє список отримувачів на відповідність правилам і показує, хто отримає повідомлення, без надсилання | ті самі, що в send_review_requests |
get_review_link |
Коротке посилання на відгук, посилання Google для відгуку, URL QR-кодів і посилання для месенджерів | location_id |
get_usage |
Ваш тариф, місячні ліміти й використання | — |
Запис
| Інструмент | Що робить | Основні параметри |
|---|---|---|
create_reply_template |
Створює шаблон зі змінними {reviewer_name}, {business_name}, {signature}, {contact} |
name, text, rating_min, rating_max, language |
import_library_templates |
Копіює готові шаблони для вашої галузі з публічної бібліотеки | industry, language |
sync_reviews |
Завантажує нові відгуки з Google зараз, не чекаючи планової синхронізації | location_id |
Деструктивні (з підтвердженням)
| Інструмент | Що робить | Ліміт |
|---|---|---|
save_reply_draft |
Зберігає чи оновлює чернетку відповіді, може позначити її схваленою (з погодженням колегою автор не може схвалити власну чернетку). Перевіряє ліміт розміру Google і голос бренду. Параметри: review_id, text, approve |
— |
update_brand_voice |
Оновлює голос бренду (для всієї організації чи однієї локації). Параметри: tone, always, never, signature, contact, languages, examples, location_id |
— |
publish_reply |
Публікує чернетку чи текст як публічну відповідь власника в Google (замінює наявну). Підтвердження виклику фіксується як ваше схвалення; з погодженням колегою публікуються лише схвалені колегою чернетки | replies |
delete_reply |
Видаляє публічну відповідь власника в Google | — |
send_review_requests |
Надсилає запити на відгуки email чи SMS або створює посилання для месенджерів після перевірки правил; потрібно consent_confirmed: true |
requests |
delete_reply_template |
Видаляє шаблон відповіді | — |
Помилки
Помилки короткі й зрозумілі, наприклад: quota_exceeded (з посиланням на зміну тарифу),
feature_not_available, google_not_connected, google_not_approved, google_auth, not_found,
compliance_blocked (із конкретним правилом), consent_not_confirmed, teammate_approval_required,
client_authorization_required, reply_not_supported_for_source (відгуки з CSV і Facebook: скопіюйте
відповідь і опублікуйте її на тій платформі).
Аналіз тем
Окремого серверного інструмента для тем немає: правила Google не дозволяють агрегувати вміст відгуків у
збережені набори даних. Попросіть асистента — він прочитає останні відгуки через list_reviews і
згрупує їх за темами прямо в розмові, будь-якою мовою (див. приклади запитів).