Neuroslop API

API와 MCP로 탐지, 상세 분석, 휴머나이징을 앱이나 AI 어시스턴트에 연결하세요.

누구를 위한 것인가요

이 API를 선택해야 하는 이유

MCP 서버

MCP를 통해 Neuroslop을 AI 에이전트에 연결하세요 - 에이전트가 텍스트를 검사하고, 휴먼화하고, 숨겨진 문자를 자동으로 제거합니다. Claude Code, Cursor, Codex, OpenClaw에서 작동합니다.

연결 방법

1. 호스팅된 HTTPS API를 통해 무료로 key 없이 작동하며, 남용 방지 요청 제한이 적용됩니다. 숨겨진 문자 제거: 제로폭 공백, 동형 문자. 로컬 실행, 키 불필요. API key가 필요한 도구는 neuroslop_humanize뿐입니다.
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은 key 없이 작동합니다.

에이전트(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: 팩을 고르고 카드, SBP 또는 USDT로 결제하면 키가 즉시 발급됩니다.
• Telegram 봇에서 — @AITextChecker_bot → «🔌 API»: Telegram Stars로 결제하면 키가 채팅으로 옵니다.

가격: 유닛

POST/v1/check

본문: { "text": "...", "lang": "ko" } (lang 선택). 최대 20,000자.

두 메서드의 기본 한도는 공백을 포함한 UTF-16 코드 단위 20,000개입니다. 서버가 더 낮은 한도를 설정할 수 있습니다. 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은 0점이 아닌 사용 불가를 뜻합니다. lang은 인터페이스가 아닌 텍스트 언어입니다.

POST/v1/rewrite

본문: { "text": "...", "tier": "flash", "lang": "en" }. tier는 flash(Standard, 기본값) 또는 pro(Premium)입니다. 입력 한도는 /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는 청구 상태의 증거가 아닙니다. 저장된 결과를 복구하세요. 인증, 할당량 또는 요청 키 충돌 오류를 무조건 반복하지 마세요.