API Textabra

Забирайте отчёты по страницам, запускайте проверки и получайте задания для ИИ-редактора из своих скриптов. Доступно на тарифах «Профи» и «Корпоративный». Ключ создаётся в настройках.

Авторизация

Передавайте ключ в заголовке Authorization: Bearer tx_…. Базовый адрес: https://www.textabra.ru/api/v1. Ответы в JSON. Не больше 60 запросов в минуту на ключ.

curl https://www.textabra.ru/api/v1/me \
  -H "Authorization: Bearer tx_ВАШ_КЛЮЧ"

Методы

GET /me

Тариф, лимиты и сколько уже использовано: проекты, страницы, проверки за 30 дней.

GET /projects

Список проектов.

POST /projects

Создать проект. Тело: {"name": "Мой сайт"}.

GET /projects/{id}/pages

Страницы проекта с общим баллом, баллом качества, SEO и семантикой.

POST /projects/{id}/pages

Добавить URL и запустить полную проверку. Тело: {"urls": ["https://example.com/a"]}, до 100 адресов за запрос. Каждая страница списывает одну проверку из квоты.

GET /pages/{id}

Полный отчёт: 8 оценок качества с комментариями, SEO-чеклист, семантика. Параметр include=seo_data,semantic_report добавляет полные данные снимка и семантического отчёта.

POST /pages/{id}/recheck

Перепроверка. Тело: {"what": "quality"}, значения seo (бесплатно), quality, semantic, all. Результат появится в отчёте страницы, когда проверка завершится.

GET /pages/{id}/brief?mode=edit

Задание для ИИ-редактора по странице: что поправить и чем дополнить по нашему анализу. Нужен готовый семантический анализ. mode=write для текста с нуля.

Квота и ошибки

Проверки считаются так же, как в кабинете: качество, семантика и полный прогон новой страницы списывают по одной операции. Квота на тарифе «Профи»: 1100 за 30 дней. Перепроверка SEO-снимка не списывает ничего.

Ошибки приходят в виде {"error": "…", "detail": "…"} с кодами: 401 (нет или неверный ключ), 402 (квота исчерпана), 403 (тариф или лимиты), 404, 429 (слишком много запросов).

MCP-сервер для ИИ-агентов

Пакет textabra-mcp подключает Claude, Cursor и другие MCP-клиенты к вашим проектам: агент смотрит отчёты, запускает проверки и получает задание для ИИ-редактора. Работает поверх этого API с вашим ключом, квота общая.

Claude Desktop, файл claude_desktop_config.json

{
  "mcpServers": {
    "textabra": {
      "command": "uvx",
      "args": ["textabra-mcp"],
      "env": { "TEXTABRA_API_KEY": "tx_ВАШ_КЛЮЧ" }
    }
  }
}

Claude Code

claude mcp add textabra --env TEXTABRA_API_KEY=tx_ВАШ_КЛЮЧ -- uvx textabra-mcp

Нужен uv (команда uvx); без него: pip install textabra-mcp и запуск textabra-mcp. Инструменты: account_status, list_projects, create_project, list_pages, add_urls, get_page_report, recheck_page, get_brief.