NeuronWriter через API: как мы работаем с ним через ИИ-агента

Что умеет NeuronWriter

Сервис строит анализ по ключевому запросу, языку и выбранному домену Google, например google.co.uk для Великобритании. В анализе четыре части. Общие рекомендации вроде типичной длины текста, термины с частотой у конкурентов, вопросы по теме (в том числе из блока People Also Ask) и список страниц из выдачи с их заголовками.

Дальше текст пишут или вставляют в редактор, и сервис считает Content Score. Чем полнее текст покрывает термины и подтемы топа, тем выше оценка. Рядом с ней есть вторая, AI Score. По справке NeuronWriter она проверяет охват темы, ответ в начале текста и в начале каждого раздела, структуру, плотность фактов и источников, ясность изложения.

Это инструмент семантического SEO. Сам сервис называет свои рекомендации NLP-оптимизацией контента, то есть термины выделяются из текстов конкурентов автоматически. Кроме анализа в NeuronWriter есть генерация черновиков ИИ, планировщик контента, интеграция с WordPress и Google Search Console, расширение для Chrome и бесплатные инструменты Keywords mixer и Keywords grouper для работы с ключевыми словами.

Учиться работе в интерфейсе удобно по Академии NeuronWriter. Там обзор продукта, курс для начинающих, короткие видео по функциям и записи вебинаров. Отдельного раздела про API в оглавлении Академии нет, поэтому дальше о том, чего в обучении не найти.

Как пользоваться этими рекомендациями без переспама, разобрано в статьях об оптимизации текста сайта и об LSI-копирайтинге.

Зачем работать через API, если есть редактор

Для одного текста редактора хватает.

Когда статей десятки, большая часть работы повторяется. Проверить, был ли уже анализ по теме. Выгрузить термины и сравнить с текстом. После публикации пересчитать оценку, положить финальный текст в редактор, проставить теги и отметить анализ готовым. Через API это делает агент, а у человека остаются тема, факты и решения.

Подключение описано в справке NeuronWriter по API. Нужен тариф Gold или выше, ключ лежит в профиле на вкладке «Neuron API access», запросы идут методом POST с ключом в заголовке X-API-KEY. API тратит те же месячные лимиты, что и работа в окне, но платит только создание анализа.

Отсюда главное правило экономии. Анализ создаётся один раз, а читать, сравнивать и пересчитывать его можно сколько угодно.

Как с сервисом работает агент Claude Code

Claude Code от Anthropic читает файлы проекта, правит их и выполняет команды. Для NeuronWriter этого достаточно. Агент запускает небольшой клиент к API, читает ответ и сам решает, какой шаг следующий. Ключ хранится в файле окружения проекта, агент берёт его оттуда и в чат не выводит.

1. Ищет готовый анализ по всему аккаунту. Лимит у нас общий на все проекты, и тема часто уже разобрана для другой статьи. Готовый анализ читается бесплатно.
2. Для простой темы собирает бесплатный корпус. Берёт тексты страниц топа Яндекса и Google через сервис выдачи XMLRiver и считает, какие слова и пары слов есть хотя бы у половины страниц. NeuronWriter строит анализ по Google, а нам нужна ещё и выдача Яндекса.
3. Платный анализ запускает только после ответа «да». Сначала агент показывает остаток лимита и объясняет, зачем нужен анализ. Кандидат на платный анализ один: тема с заметным спросом, для которой нет готового анализа и мало страниц для бесплатного корпуса.
4. Работает с терминами как с планом подтем. Проверяется, раскрыта ли каждая подтема, а не сколько раз стоит слово. Переспам оценку только снижает.
5. До публикации сверяет текст. Показывает, каких частых терминов нет, и оценивает черновик через /evaluate-content, всегда вместе с title и description.
6. После публикации ставит итоговую оценку по живому адресу. Затем кладёт текст в редактор, проставляет теги и отмечает анализ готовым.

Решения на каждом шаге остаются за человеком. Агент экономит часы на выгрузках и сверках, но тему, факты и итоговый текст проверяет редактор. Где проходит эта граница в SEO вообще, мы разбирали в статье об ИИ-агентах в SEO.

Наши оценки: живая страница против топа

Так в октябре 2026 года мы прошли рубрику «Контент». В таблице итоговые оценки живых страниц и цифры конкурентов из того же анализа.

Например, статья о качественном контенте получила 83 при лучшем конкуренте 75. Но оценка сервиса не равна позициям. Она показывает, насколько текст покрывает термины топа, и ничего не говорит о ссылках, поведении посетителей и доверии к сайту. Позиции мы смотрим в Search Console через 2–4 недели после публикации.

Ловушки API, которые мы нашли

• Оценка исходника занижена. В исходнике таблицы стоят шорткодами, а блок вопросов ещё не собран. Статья о продающем контенте по исходнику получила 58, а по живому адресу 71. Итог берём только по живой странице.
• Оценка по адресу работает не на каждом сайте. У нас оценки по адресу и по HTML той же страницы расходились на 0–4 балла. На одном из соседних сайтов режим url давал 0–1 при 77 по HTML. На новом сайте один раз сравниваем оба режима.
• Без title и description оценка падает. В одном из проектов текст получил 30 вместо 80 только потому, что их не передали.
• Анализ готовится дольше, чем написано. В справке около 60 секунд, у нас выходило от 222 до 305. Номер анализа сохраняем и дочитываем его позже, чтение бесплатное.
• Теги стирают отметку «готово». Метод /update-query-tags заменяет весь набор тегов, включая Done. Поэтому сначала теги, потом /mark-content-as-done.
• Остатка лимита API не отдаёт. Считаем сами по спискам анализов всех проектов с даты обновления лимита. У нас это 10-е число, точное время видно в профиле в строке Monthly limits reset.
• Повтор запроса не всегда платный. Тот же запрос в течение 30 минут возвращает прежний анализ, и лимит не списывается.
• В терминах бывает мусор. Обрывки вёрстки вроде div и span или слова чужой темы. Их пропускаем.

Codex, Antigravity и другие агенты

API у NeuronWriter обычный, без привязки к Claude Code. Это обычные HTTP-запросы, ключ передаётся заголовком, поэтому смело подключайте любой агент, который умеет выполнять команды. Codex от OpenAI работает локально на компьютере. Antigravity от Google есть в виде приложения, консольной программы agy и расширений для редакторов и выполняет команды после подтверждения.

Проверить ключ можно бесплатным запросом списка проектов.

curl -X POST https://app.neuronwriter.com/neuron-api/0.5/writer/list-projects \
  -H "X-API-KEY: $NEURONWRITER_API_KEY" \
  -H "Content-Type: application/json" -d '{}'

Порядок тот же, что у нас. Ключ хранят в переменной окружения или в файле .env, который не попадает в git. Агенту дают клиент или описание методов, а создание анализа разрешают только после подтверждения.

Через MCP, без ключа

У сервиса есть и MCP-сервер по адресу https://app.neuronwriter.com/mcp/http. Его добавляют в агенте как удалённый сервер, входят в аккаунт NeuronWriter и разрешают доступ. Инструменты те же, что в API, и создание анализа так же тратит один анализ из месячного лимита.

• Claude Code. Команда claude mcp add --transport http neuronwriter https://app.neuronwriter.com/mcp/http, затем вход через /mcp.
• Codex. Удалённые серверы с входом по OAuth поддерживаются, сервер прописывают в config.toml разделом [mcp_servers.neuronwriter] с параметром url.
• Antigravity. По документации сервер добавляют в mcp_config.json, раздел mcpServers, адрес указывают в поле serverUrl.

Сами мы работаем через API, MCP-сервер в работе не проверяли. NeuronWriter пишет, что сервер рассчитан на любые приложения с поддержкой MCP, в примере подключения назван Claude.

Безопасность ключа и лимита

• Ключ только в .env, а сам файл в .gitignore. Не в чате, не в отчётах, не в коммитах.
• Платный вызов идёт одной командой с явным флагом, каждая трата пишется в журнал.
• Анализы создаются по одному. Однажды скрипт создал семь анализов разом в обход проверки, после этого пакетный запуск мы убрали.
• Подтверждение закреплено хуком, а не строкой в инструкции. Хук в Claude Code срабатывает перед каждой командой и не пропускает платный вызов без ответа человека.
• Рекомендации сервиса не считаем фактами. Цены, сроки и кейсы из текстов конкурентов в статью не переносим.

Кому это нужно

Если вы пишете пару статей в месяц, хватит редактора NeuronWriter и десяти минут на каждый текст. Связка API и агента имеет смысл для агентства или блога, где текстов много, сайтов несколько, а лимит анализов общий и его надо беречь. Тогда рутина уходит агенту, а человек тратит время на то, что сервис не оценивает, то есть на фактуру и опыт.

Если нужны тексты под поиск без собственной настройки агентов, посмотрите услугу контент-маркетинга, а продвижение сайта целиком описано на странице SEO-продвижения. Ссылка на NeuronWriter в начале статьи партнёрская.