Neuroslop API

اربط الكشف والتحليل المفصل وإعادة الصياغة بتطبيقك أو مساعدك عبر API وMCP.

لمن هو

لماذا هذا الـ API

خادم MCP

اربط neuroslop بوكيلك الذكي عبر MCP، حيث يتحقق النص من السخف، ويزيد إنسانيته، ويحذف الأحرف المخفية تلقائيًا. يعمل في Claude Code, Cursor, Codex, OpenClaw.

كيفية الاتصال

1. مجاني وبلا مفتاح عبر واجهة HTTPS المستضافة؛ تُطبّق حدود لمعدل الطلبات لمنع إساءة الاستخدام. يزيل الأحرف المخفية: مسافات بدون عرض، محارف متشابهة. محلي، لا يحتاج مفتاح. وحدها 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: اختر باقة وادفع بالبطاقة أو SBP أو USDT — يصدر المفتاح فورًا.
• في بوت تيليجرام — @AITextChecker_bot → «🔌 API»: ادفع بنجوم تيليجرام، ويصل المفتاح إلى الدردشة.

التسعير: الوحدات

POST/v1/check

المتن: { "text": "...", "lang": "ar" } (lang اختياري). حتى 20000 حرف.

الحد الافتراضي لكلا الأسلوبين هو 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 ‏(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 لا يثبت حالة الخصم: حاول استرجاع النتيجة المحفوظة. لا تكرر أخطاء المصادقة أو الحصة أو تعارض المفتاح دون تحقق.