Neuroslop API

Collega rilevamento, analisi dettagliata e umanizzazione alla tua app o assistente IA tramite API e MCP.

Per chi è

Perché questa API

Server MCP

Connetti neuroslop al tuo agente AI tramite MCP — controlla il testo per slop, lo umanizza e rimuove i caratteri nascosti da solo. Funziona in Claude Code, Cursor, Codex, OpenClaw.

Come connettersi

1. Gratuito e senza chiave tramite l’API ospitata su HTTPS; si applicano limiti antiabuso. Rimuove caratteri nascosti: spazi a larghezza zero, glifi omologhi. Locale, nessuna chiave necessaria. Solo neuroslop_humanize richiede una chiave API.
2. Download neuroslop-mcp.mjs and add the config:

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

3. Sostituisci il percorso assoluto. NEUROSLOP_API_KEY è facoltativa e viene usata solo da neuroslop_humanize; neuroslop_check e neuroslop_clean funzionano senza chiave.

Connetti al tuo agente (MCP) Ottieni una chiave nel tuo account

Autenticazione

Ogni richiesta porta la chiave in un header: Authorization: Bearer <key> o X-API-Key: <key>.

Ottieni una chiave in due modi, senza approvazione manuale:

• Sul sito — il tuo account → API: scegli un pacchetto, paga con carta, SBP o USDT — la chiave arriva all'istante.
• Nel bot Telegram — @AITextChecker_bot → «🔌 API»: paga con Telegram Stars, la chiave arriva in chat.

Prezzi: unità

Analisi e revisione via API per app, bot e MCP. Il consumo dipende dall’operazione e dalla lunghezza del testo. Ogni pacchetto indica le condizioni; le chiavi esistenti conservano quelle acquistate.

Un pacchetto da 3.000 unità equivale a 3.000 controlli, o 100 umanizzazioni Standard, o 30 Premium. I controlli hanno peso 1, Standard 30 ogni 2500 caratteri, Premium 100 ogni 7500.

POST/v1/check

Corpo: { "text": "...", "lang": "it" } (lang opzionale). Fino a 20.000 caratteri.

Limite predefinito di entrambi i metodi: 20.000 unità di codice UTF-16, spazi inclusi. Il server può impostare un limite inferiore; GET /v1/health restituisce limits.maxInputChars e l'errore too_long restituisce max.

curl -X POST https://neuroslop.net/v1/check \
  -H "Authorization: Bearer ns_YOURKEY" \
  -H "Content-Type: application/json" \
  -d '{"text": "In today'"'"'s fast-paced world, it is important to note..."}'

Risposta:

{
  "score": 34,            // 0-100, lower = more slop
  "verdict": "Сильный нейрослоп — текст читается как сгенерированный",
  "lang": "en",
  "words": 120,
  "findingsCount": 9,
  "findings": [ { "id": "cliche", "category": "Cliché", "severity": "high", "count": 4 }, ... ],
  "remaining": 2999       // units left
}

POST/v1/rewrite

Corpo: { "text": "...", "tier": "flash" | "pro", "lang": "it" } Predefinito tier=flash. Fino a 20.000 caratteri.

curl -X POST https://neuroslop.net/v1/rewrite \
  -H "Authorization: Bearer ns_YOURKEY" \
  -H "Idempotency-Key: 018f-request-unique-id" \
  -H "Content-Type: application/json" \
  -d '{"text": "...", "tier": "pro"}'

Risposta:

{
  "text": "rewritten text",
  "tier": "pro",
  "scoreBefore": 34,
  "scoreAfter": 96,
  "qualityBasis": "editorial_review",
  "remaining": 2870
}

qualityBasis è editorial_review quando è confermata una revisione editoriale con IA, altrimenti unverified; non garantisce l'esattezza. unchanged=true restituisce l'originale con spent=0. reason è quality_unverified, no_improvement o unchanged. Una riscrittura approvata non deve necessariamente aumentare il punteggio del rilevatore.

{
  "text": "original text",
  "tier": "pro",
  "scoreBefore": 90,
  "scoreAfter": 90,
  "unchanged": true,
  "reason": "quality_unverified",
  "qualityBasis": "unverified",
  "spent": 0,
  "remaining": 2870
}

GET/v1/balance

Quota residua della chiave: { plan, quota, used, remaining, resetMonth, perMinute }.

quotaMode: "one_time", resetMonth: null

Pacchetto di unità una tantum. Nessun rinnovo mensile.

quotaMode: "monthly"

Quota mensile. Si rinnova ogni mese di calendario.

GET/v1/health

Stato del servizio, senza chiave: { "ok": true, "llm": true, "limits": { "maxInputChars": 20000 } }.

Errori