FTIR.fun FTIR.fun
تكامل المطور والذكاء الاصطناعي

قم بتوصيل FTIR.fun بأي أداة أو تطبيق AI

امنح مساعد الذكاء الاصطناعي أو الكود الخاص بك وصولاً مباشراً إلى أكثر من 130,000 طيف مرجعي، واستدلال قمم المعرفة البيانية، وتفسير مدعوم بالأدبيات. اختر واحدة من ثلاث طرق للاتصال - MCP للمساعدين الذكاء الاصطناعي، أو REST API للكود، أو Skill جاهزة للمنصات بدون كود. كل مسار أدناه يحتوي على تعليمات خطوة بخطوة مكتوبة للمستخدمين لأول مرة.

1. اختر مسارك 2. إعداد MCP 3. REST API 4. المهارات والإضافات 5. ما يمكن أن يفعله AI الخاص بك 6. استكشاف الأخطاء وإصلاحها
تمت المراجعة والإدراج في

قبل أن تبدأ — احصل على مفتاح API الخاص بك

يستخدم كل من MCP و REST API مفتاح API واحد لـ FTIR.fun. يستخدم Coze/Doubao مفتاح خدمة تم تكوينه بواسطة ناشر المكون الإضافي، لذلك لا يقوم المستخدمون النهائيون بلصق مفتاح شخصي. الحصول على مفتاح شخصي يستغرق حوالي دقيقة:

  1. تسجيل الدخول إلى FTIR.fun أنشئ حسابًا مجانيًا إذا لم يكن لديك واحد. تتضمن الحسابات الجديدة أرصدة تجربة مجانية.
  2. افتح لوحة مفاتيح API اذهب إلى الحساب → مفاتيح API وانقر على إنشاء.
  3. انسخ المفتاح واحفظه فورًا يظهر المفتاح الكامل (يبدأ بـ ftir_) مرة واحدة فقط. قم بتخزينه في مكان آمن. إذا فقدته، ما عليك سوى إنشاء مفتاح جديد.
🔑 هل أنت مستعد؟ افتح لوحة مفاتيح API في علامة تبويب جديدة، ثم عد واتبع المسار الذي اخترته أعلاه.
⚠️ يقبل خادم MCP المستضاف فقط مفتاح API للحساب الذي تم إنشاؤه في لوحة مفاتيح API الخاصة بـ FTIR.fun (يبدأ بـ ftir_). المفاتيح الرئيسية من جانب الخادم مخصصة لمشغلي REST ولا يمكنها تسجيل الدخول إلى MCP المستضاف.

الخطوة 1 - أي اتصال مناسب لك؟

جميع الثلاثة يتصلون بنفس المحرك: أكثر من 130,000 طيف، استدلال رسومات المعرفة، واستشهادات الأدبيات. تحتاج فقط إلى واحد. اختر حسب طريقة عملك — لست متأكدًا؟ MCP هو الخيار الأكثر شيوعًا لأي شخص يستخدم مساعد AI.

ما يمكن أن يفعله ذكاؤك الاصطناعي فعليًا

التوزيعات الحالية لـ MCP وREST وn8n وLangChain تعرض سبع عمليات. المكون الإضافي المنشور Coze يعرض ثلاث أدوات (تحليل، بحث، شرح)، وقد تعرض القوالب الأخرى مجموعة معلنة أصغر؛ تحقق من بطاقة كل منصة قبل الاستخدام. العمليات أدناه تشترك في نفس خدمات FTIR.fun.

مهمة أداة MCP نقطة نهاية REST قل هذا لذكائك الاصطناعي
قراءة ملف جهاز parse_ftir_spectrum POST /parse-spectrum قم بتحليل sample.spc وسرد القمم المكتشفة.
تحديد طيف غير معروف analyze_ftir_spectrum POST /ftir/analyze_spectrum تحديد أي بوليمر هذا الطيف.
تقديم تقرير ثلاثي المحاور كامل submit_ftir_report POST /ftir/reports أرسل sample.spa للحصول على تقرير كامل في وضع ATR.
اسأل واسترجع ذلك التقرير get_ftir_report_status GET /ftir/reports/{task_id} تحقق من مهمة التقرير وأعطني الرابط عند الانتهاء.
شرح القمم explain_peaks POST /ftir/explain_peak_assignments ماذا تشير القمم عند 1715 و1450 سم-1؟
ابحث عن طيف مرجعي معروف find_spectra POST /ftir/find_spectra ابحث عن أطياف مرجعية للبوليستيرين.
أعد فتح نتيجة سابقة fetch_result GET /ftir/result/{result_num} احصل على النتيجة 20260528100755416137536.

الملفات المدعومة: SPA، SPC، OPUS، JCAMP-DX، CSV، TSV، Excel، JSON. قيم sampling_mode الصالحة هي KBr Pellet، Vapor، Solvent، Thin Film، Paraffin Mull، ATR، Diffuse Reflectance، Micro IR، وOthers. Transmission ليست قيمة صالحة. احتفظ بامتداد الملف الأصلي حتى يختار FTIR.fun المحلل الصحيح.

مثال على استجابة find_spectra

استجابة find_spectra 
{
  "success": true,
  "query": "polystyrene",
  "match_mode": "synonym",
  "match_count": 3,
  "summary": "Found 3 reference spectrum candidates for 'polystyrene'.",
  "results": [
    {"num": 555, "spectrum_number": 555, "name": "PS/PPO",
     "cas": "-", "source_type": "direct_read:spa",
     "peaks": [697, 756, 1028, ...], "x": [...], "y": [...]}
  ]
}

مثال على استجابة explain_peaks

استجابة explain_peaks 
{
  "success": true,
  "search_mode": "peak_explanation",
  "peak_explanations": [
    {"peaks_cm1": [1715, 1450],
     "assignment": "1715 cm-1 suggests C=O stretching (ester or carboxylic acid)...",
     "evidence_type": "llm_general_knowledge"}
  ],
  "summary": "Peak explanation based on general FTIR knowledge..."
}

الحصول على التقرير الكامل (غير متزامن)

الفحص السريع (analyze_spectrum) يعود فورًا. يعمل تقرير المحاور الثلاثة الكامل في الخلفية ويستغرق عادةً 30–90 ثانية. لا تعيد الإرسال أثناء تشغيل التقرير — احتفظ بـ task_id واستقصه.

  1. إرسال استدع submit_ftir_report (MCP) أو POST /ftir/reports (REST). ستحصل على task_id و result_num محجوز. حقل file_base64 مطلوب؛ الحقول الأخرى (sampling_mode, prior_context, language_code, sample_name, sample_order_no) اختيارية.
    مثال على الإرسال (REST) 
    curl -X POST https://ftir.fun/ftir/reports \
  -H "X-API-Key: ftir_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"file_base64": "V2F2ZW51bWJlci...", "filename": "sample.spa", "sampling_mode": "ATR", "language_code": "en"}'
    إرسال الرد 
    {"success": true, "task_id": "rpt_abc123...", "result_num": "20260713...", "status": "queued"}
  2. استطلاع رأي استدع get_ftir_report_status (MCP) أو GET /ftir/reports/{task_id} كل 5–10 ثوان حتى يصبح completed هو true. تتضمن الرد المكتمل report_url و report_view (محتوى التقرير المنظم) و result_num.
    مثال على الاستقصاء 
    curl https://ftir.fun/ftir/reports/rpt_abc123 \
  -H "X-API-Key: ftir_your_key_here"
    رد الاستقصاء (قيد التقدم) 
    {"success": true, "task_id": "rpt_abc123", "status": "running", "progress": 45, "completed": false}
    استجابة الاستقصاء (مكتمل) 
    {"success": true, "task_id": "rpt_abc123", "status": "completed", "completed": true,
 "result_num": "20260713...", "report_url": "https://ftir.fun/outputdata/?num=20260713..."}
  3. افتح التقرير النهائي افتح عنوان URL الكامل https://ftir.fun/outputdata/?num={result_num} في متصفح لعرض صفحة النتائج ثلاثية المحاور الكاملة التي يعرضها FTIR.fun.
⚠️ لا ترسل نفس التقرير مرة أخرى أثناء وجوده في قائمة الانتظار أو أثناء تشغيله. احتفظ بـ task_id واستمر في الاستقصاء حتى يكتمل أو يفشل. الإرسالات المكررة تهدر النقاط.

استكشاف الأخطاء وإصلاحها

ما تراه ماذا يعني ماذا تفعل
يفتح العميل صفحة تفويض المتصفح، أو يقول أن صفحة التفويض غير موجودة. عميلك يستخدم إدخال خادم قديم بنمط OAuth. FTIR.fun لا تستخدم OAuth — فقط مفتاح API. احذف إدخال خادم ftirfun القديم، والصق التكوين الدقيق من هذه الصفحة، وأعد تحميل العميل، وابدأ ftirfun مرة أخرى.
401 (MCP) / 401 invalid_api_key (REST) مفتاح API مفقود أو منتهي الصلاحية أو تم إلغاؤه أو لصقه بشكل غير صحيح. أعد تشغيل الخادم والصق المفتاح الخام فقط (يبدأ بـ ftir_). إنشاء مفتاح جديد من لوحة تحكم مفاتيح API إذا لزم الأمر.
يبدأ الخادم ولكن لا تظهر أدوات. العميل لم يقم بتحديث الكتالوج الخاص به، أو التكوين يستخدم اسم مفتاح خاطئ. بالنسبة لـ VS Code، تأكد من أن mcp.json يستخدم servers (وليس mcpServers). ثم أوقف وأعد تشغيل ftirfun، أو أعد تحميل النافذة.
403 insufficient_balance الحساب لا يحتوي على نقاط كافية لهذا التحليل. تحقق من رصيدك أو اشتراكك في FTIR.fun، ثم حاول مرة أخرى.
429 rate_limit_exceeded تحليل REST وتحليله يسمح بـ 60 طلبًا في الدقيقة لكل مفتاح API؛ قراءات نتيجة REST وحالة التقرير تستخدم حاوية منفصلة تبلغ 120 طلبًا في الدقيقة؛ MCP يسمح بـ 60 استدعاء في الدقيقة لكل مفتاح API وأداة. انتظر فترة إعادة المحاولة التي أبلغتها الأداة قبل الاتصال مرة أخرى.
يبقى التقرير في قائمة الانتظار أو قيد التشغيل. تعمل التقارير الكاملة بشكل غير متزامن وتستغرق وقتًا أطول من الفحص السريع. احتفظ بنفس task_id واستمر في الاستعلام. لا تنشئ مهام تقارير مكررة.
422 أو missing_input نص الطلب يفتقر إلى الحقول المطلوبة أو يحتوي على تنسيق غير صحيح. بالنسبة إلى analyze_spectrum، يجب عليك تقديم واحد على الأقل من: peaks أو query أو file_base64. تحقق من أن JSON الخاص بك صالح، وأن Content-Type هو application/json، وأن الحقول المطلوبة موجودة. راجع أمثلة الطلبات أعلاه.
413 file_too_large يتجاوز ملف الطيف المرفوع حد الحجم. قم بتصدير ملف أصغر أو استخدم فقط مواقع القمم عبر حقل spectrum.peaks.

هل أنت مستعد للبناء؟

مرجع REST الكامل يحتوي على كل نقطة نهاية، تنسيقات الطلب والاستجابة، التحقق من الهوية، حدود المعدل، رموز الأخطاء، تعريفات أداة MCP، وأمثلة الكود في Python و curl.

إرسال الطلب نموذج