Для агентов и разработчиков
Ваш бренд из вашего терминала
Получите доказательства, следующее изменение и способ его проверки. Тот же сохраненный анализ 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 в рамках существующего покрытия. Бесплатные образцы не инициируют работу поставщика. Ознакомьтесь с возможностями для текущих лимитов; сбор запланирован и использует бюджет панели управления. Результаты разделяют вопросы, называющие ваш бренд, и вопросы об общем исследовании. Работа возвращает сохраненные предложенные тексты и исходные фрагменты; история возвращает датированные образцы ранжирования базы данных с сохранением рынков. Черновики требуют редакционного рассмотрения и никогда не помечаются как развернутые автоматически.
Подготовить работу через агента
Прочитайте действия, чтобы получить допустимый идентификатор сохраненного действия, затем отправьте prepare с идемпотентным ключом. Опросите возвращенный идентификатор задания. Повторная отправка того же ключа возвращает то же задание; не создавайте новый ключ только потому, что ответ истек по времени. Подготовка использует ваши черновики и лимиты поставщика, с одной попыткой поставщика и $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 для prepare/cancel, GET /api/v1/jobs?jobId=ID для статуса. MCP: prepare_page_changes, read_preparation_job, cancel_preparation_job. Создание имеет ограничения по очереди/день и проверки текущих прав. Записи идемпотентности хранятся в течение 90 дней. Чтения статуса никогда не выполняют задание.
Проверить примененные изменения страницы
После применения проверенного черновика запишите его идентификатор документа, фактическое время применения и стабильный идемпотентный ключ. Mentionry автоматически проверяет исходную общедоступную страницу. Это записывает ваше объявление и наблюдаемый HTML отдельно; это не публикует и не доказывает повышение ранжирования. GET status никогда не запускает проверку.
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 в пределах вашего плана.