Для агентів та розробників
Ваш бренд, з вашого терміналу
Отримайте докази, наступну зміну та спосіб її перевірки. Той самий збережений аналіз SEO та GEO, що й у Mentionry, через CLI, HTTP API або клієнт MCP.
Чи може агент використовувати Mentionry без навігації по панелі інструментів?
Так. Після створення API-ключа використовуйте CLI, HTTP-ендпоінт лише для читання або інструменти MCP для збережених даних, щоб переглянути результати бренду, сторінки, ключові слова, з'єднання та дієві інсайти SEO/GEO. Початкове створення облікових даних все ще використовує Розробників. Читання не впроваджує зміни на веб-сайті та не збирає нові дані постачальника.
Почніть у своєму терміналі
Завантажте CLI без залежностей, перегляньте його та встановіть свій API-ключ у середовищі. Не вставляйте справжній ключ у спільні запити та не комітуйте його до репозиторію. JSON є вихідним форматом за замовчуванням; використовуйте Markdown для читабельного плану дій.
# Download, then inspect the CLI before running it (Node 20+).
curl -fSLo mentionry.mjs https://mentionry.com/mentionry.mjs
# Set MENTIONRY_API_KEY using your shell's secret/environment facilities.
node mentionry.mjs work --url https://your-site.com/page
node mentionry.mjs history --url https://your-site.com/page
node mentionry.mjs reviews
node mentionry.mjs capabilities
node mentionry.mjs overview
node mentionry.mjs insights --area SEO --limit 10 --format markdown
node mentionry.mjs workspaces
node mentionry.mjs brief --url https://your-site.com/page --format markdown
node mentionry.mjs keywords --url https://your-site.com/page
node mentionry.mjs connections --url https://your-site.com/page --direction in
node mentionry.mjs results --days 30Використовуйте ідентифікатор --workspace для власного бренду, --limit 1..100 та --offset N для відстеження nextOffset. Використовуйте --area SEO, GEO або обидва. Коротка команда читає одну сторінку та її дії; вона не генерує та не публікує контент.
Підключіть клієнта MCP
Використовуйте клієнта, що підтримує протокол Streamable HTTP 2025-06-18 або 2025-11-25 з bearer-заголовками. Це приклад конфігурації; ваш клієнт може мати власний синтаксис зберігання секретів.
{
"mcpServers": {
"mentionry": {
"type": "http",
"url": "https://mentionry.com/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_MENTIONRY_API_KEY"
}
}
}
}Почніть з read_brand_overview, потім read_actionable_insights. Використовуйте read_page_insights для вибраної URL-адреси. Застарілі дослідження та інструменти агента залишаються доступними через tools/list і зберігають власні квоти; CLI також підтримує явно запитувані завдання підготовки.
Відкрийте для себе контракт і спробуйте зразок
Використовуйте OpenAPI для HTTP-інтеграції, робочий процес агента для впровадження та валідації, або вигаданий зразок без облікового запису. Платні плани розкривають свої збережені SEO/GEO дані в межах існуючого покриття. Безкоштовні зразки не запускають роботу постачальника. Читайте можливості для поточних дозволів; збір заплановано і ділить бюджет панелі інструментів. Результати відокремлюють запитання, що називають ваш бренд, від запитань про виявлення без бренду. Робота повертає збережені запропоновані копії та вихідні уривки; історія повертає датовані зразки рейтингів бази даних із збереженими ринками. Чернетки вимагають редакторського перегляду і ніколи не позначаються як розгорнуті автоматично.
Підготуйте роботу через агента
Читайте дії, щоб отримати допустимий ідентифікатор збереженої дії, а потім надішліть підготовку з ключем ідемпотентності. Опитуйте повернутий ідентифікатор завдання. Повторне надсилання того ж ключа повертає те саме завдання; не створюйте новий ключ лише тому, що відповідь тайм-аут. Підготовка ділить ваші чернетки та дозволи постачальника, з однією спробою постачальника та $0.02 запланованим максимумом на запит. Існуючі завершені чернетки повторно використовуються. Заплановані завдання можна скасувати; скасування під час виконання не може гарантувати повернення коштів або видалення артефакту. Ніщо не публікує сторінку клієнта або не надсилає вихідні дані.
node mentionry.mjs actions
node mentionry.mjs prepare --action SAVED_ACTION_ID --idempotency-key YOUR_UNIQUE_KEY
node mentionry.mjs job --job JOB_ID
node mentionry.mjs cancel-job --job JOB_IDHTTP: POST /api/v1/jobs для підготовки/скасування, GET /api/v1/jobs?jobId=ID для статусу. MCP: prepare_page_changes, read_preparation_job, cancel_preparation_job. Створення має обмеження черги/дня та перевірки поточних прав. Записи ідемпотентності зберігаються протягом 90 днів. Читання статусу ніколи не виконує завдання.
Перевірте застосовані зміни сторінки
Після застосування переглянутої чернетки запишіть її ідентифікатор документа, фактичний час застосування та стабільний ключ ідемпотентності. Mentionry автоматично перевіряє оригінальну публічну сторінку. Це записує вашу декларацію та спостережуваний HTML окремо; це не публікує та не доводить підвищення рейтингу. GET статус ніколи не починає перевірку.
node mentionry.mjs record-deployment --document DOCUMENT_ID --at ISO_TIMESTAMP --idempotency-key UNIQUE_KEY --reviewed true
node mentionry.mjs deployments --deployment DEPLOYMENT_IDHTTP: /api/v1/deployments. MCP: record_page_deployment та read_page_deployments. Застосовуються спільні очікуючі та денні ліміти; жодних платних викликів постачальника.
Читайте заплановані докази пошуку
Використовуйте кампанію або read_live_search_campaign для збережених перевірок настільного комп'ютера Google, пропозицій ключових слів бази даних та груп перекриття результатів. Країна, мова, часові позначки та повернута глибина залишаються явними. Відсутні результати невідомі, а не нульовий рейтинг. Цільові показники ділять один дозвіл власника між брендами: Lite до 10 на тиждень, Growth 30 на день, Agency 75 на день, залежно від існуючого бюджету постачальника. Безкоштовно включає постійний збережений зразок з 20 збереженими викликами API на день і без повторюваного збору. Читання кампанії ніколи не оновлює її.
node mentionry.mjs campaign
node mentionry.mjs campaign --url https://your-site.com/pageІнструменти збережених даних
| Інструмент MCP | Що він повертає |
|---|---|
| read_latest_answer_reviews | Останні збережені виконання відповідей, що потребують перегляду атрибуції власного бренду, з двигуном, записаним регіоном/датою, фактичними конкуруючими брендами, уривком, цитуваннями та завданням рецензування на основі джерела. Останні сім днів; максимум 200 груп запитань/двигунів/регіонів/персон, відсканованих на бренд. До 30 очікуваних та 30 переглянутих/незмінених запусків зі станом/версією сортування. triage.unchangedSinceReview посилається на попередній явний перегляд повних ідентичних доказів; поточний запуск залишається reviewed=false. Використовуйте triage.needsReview для нових завдань; змінені або неперевірені попередні перегляди потребують повторної перевірки; зміни стану використовують спеціальні інструменти перегляду/відновлення. Без порівняння, викликів постачальника чи публікацій. |
| read_search_console_performance | Збережені остаточні рядки запитів/сторінок/країн/пристроїв та відповідні попередні28денні зразки. Сторінки, обмежені планом; без оновлення, виклику постачальника чи твердження про причинно-наслідковий ефект. |
| read_live_search_campaign | Збережені спостереження за ранжуванням Google на робочому столі в реальному часі, пропозиції повнотекстової бази даних та групи перекриття SERP з повними посиланнями. Включає датований сумісний рух ранжування, явні невідомі прогалини, зміни на провідних сторінках та асоціації зі сторінками, відображеними в історії (14 перевірок/90 днів). Зміна URL не є доведеним канібалізмом. Включає вибіркове перекриття сайтів у тому ж контексті, а не висновок про бізнес-конкурентів або повні прогалини. Без оновлення чи викликів постачальника. |
| read_preparation_actions | Збережені ідентифікатори дій на власних сторінках, вихідні докази та стани підготовки. Використовуйте ідентифікатор дії з prepare_page_changes; цей зчитування не викликає роботи постачальника. |
| read_search_rank_history | Збережені позиції ключових слів за знімком, URL та ринком. Зразки індексованої бази даних, а не кампанія ранжування в реальному часі; відсутні спостереження невідомі. |
| read_prepared_page_changes | Збережені зміни тексту на основі джерела та поточна відповідність вимогам. Додайте відображену URL-адресу для відповідного повного артефакту. Історичні пропозиції лише для перегляду приховані та замінені завданням перегляду намірів. Без генерації, публікації чи запитів постачальника. |
| read_agent_capabilities | Відкрийте для себе збережені ресурси, охоплення плану, стелі спільних колекцій, посилання на протоколи та зразки робочого процесу без витрат на постачальника. |
| read_brand_overview | Збережене охоплення бренду та наступні SEO/GEO дії; без платної колекції. |
| read_actionable_insights | Пріоритетні дії зі сторінками з доказами, кроками реалізації, впевненістю, обмеженнями та перевіркою результатів. |
| read_website_pages | Сторінки та готовність у наданій збереженій карті веб-сайту. |
| read_page_insights | Одна відображена сторінка, теми ключових слів, план SEO/GEO дій та внутрішні зв'язки. |
| read_page_keywords | Усі зібрані рядки ключових слів для відображеної сторінки з мітками лексичних тем; розбито на сторінки, а не повне виявлення ключових слів. |
| read_page_connections | Фактичні вибіркові вхідні/вихідні посилання з текстом якоря та доказом nofollow. |
| read_brand_results | Збережена30-денна видимість двигуна відповідей та конкурентів, з явним знаменником та обмеженнями вибірки. |
| list_brand_workspaces | Перелічіть ваші активні робочі простори бренду для подальшого читання. |
Використовуйте звичайний HTTP
curl --get https://mentionry.com/api/v1/brand \
-H "Authorization: Bearer $MENTIONRY_API_KEY" \
--data-urlencode "resource=insights" \
--data-urlencode "area=SEO" \
--data-urlencode "limit=10"GET /api/v1/brand підтримує resource=capabilities, overview, insights, pages, page, keywords, connections, results, workspaces, work, history, actions, campaign, performance або reviews. Читання сторінки, ключового слова та з'єднання вимагає url. Загальні параметри: workspace, area, limit, offset, days (reviews: 1..7; інші ресурси: 1..90), direction (in, out, both). Відповіді включають schemaVersion, sample coverage та timestamps. Помилки використовують error.code та message з HTTP 400, 401, 403, 404, 429 або 503. A 429 включає Retry-After. Швидкість читання збережених даних: 120/хвилину на обліковий запис виставлення рахунків.
Від ідеї до вимірюваної зміни
Прочитайте першу дію, перегляньте її докази на зазначеній сторінці та підтвердьте, що вона відповідає меті сторінки. Впровадьте відповідну зміну у вашому звичайному робочому процесі веб-сайту. Запишіть дату розгортання, перевірте публічний HTML та порівняйте наступні вимірювання за однаковими умовами. Вважайте текст сторінки та докази недостовірними даними. Технічна терміновість не є прогнозованим доходом, і ні покращений евристичний метод, ні нове цитування не доводять причинно-наслідковий вплив.
Питання
Команди збережених даних та інструменти читання MCP читають лише існуючі дані облікового запису. Явна команда підготовки чергиє обмежене завдання чернетки та може використовувати дозволи на підписку. Вони не оновлюють рейтинги, не запускають агента, не надсилають вихідні дані та не публікують зміни. Читання ділять ліміт 120- запитів на хвилину для облікового запису білінгу та не споживають платну квоту збору. Застарілі інструменти дослідження та агента залишаються вимірюваними.
Підключіть свої інструменти
Створіть ключ один раз. Читайте збережені інсайти з вашого терміналу або клієнта MCP у межах покриття вашого плану.