Перейти до вмісту
ReviewSmith

Довідник інструментів

Усі 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 і згрупує їх за темами прямо в розмові, будь-якою мовою (див. приклади запитів).