Neuroslop API

Подключите детекцию, подробный разбор и гуманизацию к своему приложению или AI-ассистенту через API и MCP.

Где пригодится

Почему этот API

MCP-сервер

Подключи neuroslop к ИИ-агенту через MCP — он сам будет проверять текст на слоп, очеловечивать и снимать скрытые символы. Работает в Claude Code, Cursor, Codex, OpenClaw.

Как подключить

1. Бесплатно и без ключа через облачный API по HTTPS; действует антифлуд-лимит. Снимает скрытые символы: zero-width пробелы, гомоглифы. Локально, без ключа. Только neuroslop_humanize требует API-ключ.
2. Download neuroslop-mcp.mjs and add the config:

{
  "mcpServers": {
    "neuroslop": {
      "command": "node",
      "args": ["neuroslop-mcp.mjs"]
    }
  }
}

3. Замени абсолютный путь. NEUROSLOP_API_KEY необязателен и нужен только для neuroslop_humanize; neuroslop_check и neuroslop_clean работают без ключа.

Подключить к агенту (MCP) Получить ключ в кабинете

Аутентификация

MCP-проверка использует бесплатный POST /api/check с ограничением частоты. POST /v1/check требует ключ и расходует его юниты. GET /v1/health доступен без ключа.

Для /v1/check, /v1/rewrite и /v1/balance передайте ключ в заголовке: Authorization: Bearer <key> / X-API-Key: <key>.

Ключ получить двумя путями, без ручного одобрения:

• На сайте — кабинет → API: выбери пакет, оплати картой, СБП или USDT — ключ выдаётся мгновенно.
• В Telegram-боте — @AITextChecker_bot → «🔌 API»: оплата звёздами, ключ приходит в чат.

Тарификация: юниты

POST/v1/check

Тело: { "text": "...", "lang": "ru" } (lang опционален). Текст до 20 000 символов.

Лимит обоих методов по умолчанию — 20 000 кодовых единиц UTF-16, включая пробелы. Сервер может задать меньший предел: GET /v1/health возвращает limits.maxInputChars, ошибка too_long — max.

Ниже показаны отдельные поля ответа, а не измеренные результаты клиентов. Баллы и остаток будут отличаться.

curl -X POST https://neuroslop.net/v1/check \
  -H "Authorization: Bearer ns_YOURKEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"The team utilizes this checklist to review each draft before publication.","lang":"en"}'

Ответ:

{
  "score": 100,
  "lang": "en",
  "ruleCoverage": "full",
  "scoreInterpretation": "style_rules_not_authorship",
  "applicability": { "status": "applicable", "eligible": true },
  "decision": {
    "outcome": "human_like",
    "action": "show_style_signal",
    "abstained": false,
    "confidence": null,
    "confidenceKind": "not_calibrated"
  },
  "assessment": {
    "outcome": "human_like",
    "authorshipProbability": null,
    "automaticRewrite": false
  },
  "remaining": 2999
}

Перед использованием балла проверьте applicability, decision и assessment. Балл 0–100 не является вероятностью авторства; null означает отсутствие оценки, а не ноль. lang описывает язык текста, не интерфейса.

POST/v1/rewrite

Тело: { "text": "...", "tier": "flash", "lang": "en" }. tier: flash (Стандарт, по умолчанию) или pro (Премиум). Предел ввода сообщает /v1/health.

curl -X POST https://neuroslop.net/v1/rewrite \
  -H "Authorization: Bearer ns_YOURKEY" \
  -H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{"text":"The team utilizes this checklist to review each draft before publication.","tier":"pro","lang":"en"}'

Ответ:

{
  "text": "Your revised paragraph appears here.",
  "tier": "pro",
  "scoreBefore": 100,
  "scoreAfter": 100,
  "qualityBasis": "editorial_review",
  "spent": 100,
  "remaining": 2900
}

qualityBasis описывает проверку, а не списание. Среди значений — editorial_review, deterministic, bounded-source-witness, unchanged и unverified; список не закрытый. Одобренная переработка не обязана повышать балл детектора.

{
  "text": "The team uses this checklist to review each draft before publication.",
  "tier": "pro",
  "scoreBefore": 100,
  "scoreAfter": 100,
  "unchanged": false,
  "reason": "local_edited",
  "qualityBasis": "deterministic",
  "engine": "local-rules",
  "editorialApproved": false,
  "billable": false,
  "spent": 0,
  "remaining": 3000
}

{
  "text": "Original text is returned here.",
  "tier": "pro",
  "scoreBefore": null,
  "scoreAfter": null,
  "unchanged": true,
  "reason": "local_unchanged",
  "qualityBasis": "unchanged",
  "spent": 0,
  "remaining": 3000
}

replayOnly: true

Чтобы получить сохранённый результат без запуска работы, повторите исходные Idempotency-Key, text, tier, lang и mode, добавив replayOnly:true. Если записи нет или она истекла, ответ — 409 idempotency_replay_unavailable, а не новая редактура. Это не доказывает, было ли списание в исходном запросе. Не повторяйте запрос автоматически с новым ключом.

curl -X POST https://neuroslop.net/v1/rewrite \
  -H "Authorization: Bearer ns_YOURKEY" \
  -H "Idempotency-Key: YOUR_UNIQUE_REQUEST_ID" \
  -H "Content-Type: application/json" \
  -d '{"text":"The team utilizes this checklist to review each draft before publication.","tier":"pro","lang":"en","replayOnly":true}'

GET/v1/balance

Остаток квоты ключа: { plan, quota, used, remaining, resetMonth, perMinute }.

quotaMode: "one_time", resetMonth: null

Разовый пакет юнитов. Без ежемесячного пополнения.

quotaMode: "monthly"

Месячная квота. Обновляется каждый календарный месяц.

GET/v1/health

Живость сервиса, без ключа: { "ok": true, "llm": true, "limits": { "maxInputChars": 20000 } }.

Ошибки

Сначала обработайте ошибку, затем используйте текст. Таймаут или 502 не доказывает статус списания: попробуйте восстановить сохранённый результат. Не повторяйте вслепую ошибки ключа, квоты или конфликта запросов.