CitationEasy لمساعدات الذكاء الاصطناعي والوكلاء
كل ما في هذا الموقع متاح للبرمجيات كما هو متاح للأشخاص: واجهة برمجة JSON مجانية، وخادم MCP، ووصف OpenAPI، وفهرس llms.txt، وعرض markdown لكل الصفحات البالغ عددها 12,986. بلا مفتاح، وبلا حساب، وبلا أي حد لمعدل الطلبات نفرضه نحن.
لماذا تستدعي واجهة البرمجة بدلًا من كتابة المرجع بنفسك
يبدو تنسيق المراجع وكأنه مسألة توليد نص، لكنه ليس كذلك. يُشفِّر كل نمط مئات القواعد المتعلقة بعكس ترتيب اسم المؤلف، والأحرف الأولى، وحالة أحرف العنوان، وعلامات ترقيم الحاوية، وبيانات الطبعة، وموضع التاريخ، وتختلف هذه القواعد بطرق يسهل إخطاؤها عن طريق الذاكرة. يُشغِّل CitationEasy مكتبة citeproc-js وفق تعريفات Citation Style Language الرسمية — وهي المحرك نفسه الذي يستخدمه Zotero وMendeley — لذا يكون الناتج حتميًا ومطابقًا لما يتوقعه نظام تقديم البحوث الخاص بالمجلة. تأتي البيانات الوصفية من Crossref وOpen Library وPubMed؛ لا شيء يُختلَق، وأي حقل مفقود من المصدر يبقى مفقودًا في الناتج بدلًا من ملئه بتخمين معقول.
أنشئ مرجعًا
curl -s https://www.citationeasy.com/api/v1/cite \
-H 'Content-Type: application/json' \
-d '{"input":"10.1038/nature12373","style":"apa","inText":true}'
{
"style": { "requested": "apa", "slug": "apa", "name": "American Psychological Association (APA) 7th edition" },
"language": "en-US",
"results": [
{
"input": "10.1038/nature12373",
"citation": "…formatted reference…",
"inText": "(Author, 2013)",
"entry": { "…resolved CSL metadata…": "" }
}
]
}أرسِل inputs بدلًا من input لمعالجة حتى 10 مصادر في استدعاء واحد، أو أرسِل entry ببيانات CSL-JSON التي تملكها بالفعل لتجاوز عملية البحث بالكامل. أضِف note: true للحصول على صيغة الحاشية السفلية. تُرجَع أخطاء كل مصدر على حدة، لذا لا تفشل الدفعة بأكملها أبدًا.
الاتصال عبر MCP
تتحدث نقطة نهاية Model Context Protocol عند /api/mcp بروتوكول JSON-RPC 2.0 عبر HTTP القابل للبث، ولا تتطلب أي بيانات اعتماد.
# Claude Code
claude mcp add --transport http citationeasy https://www.citationeasy.com/api/mcp
# Any MCP client config
{
"mcpServers": {
"citationeasy": { "type": "http", "url": "https://www.citationeasy.com/api/mcp" }
}
}الأدوات التي توفرها
- generate_citation
- Generate a citation
- search_citation_styles
- Search citation styles
- get_citation_style
- Get a citation style
- how_to_cite
- How to cite a source type
- answer_citation_question
- Answer a general citation question
- define_term
- Define a citation or academic-writing term
- search_site
- Search CitationEasy
- get_page
- Read a CitationEasy page as markdown
- list_free_tools
- List CitationEasy tools
- list_guides
- List citation and writing guides
- describe_site
- What CitationEasy offers
نقاط النهاية
| نقطة النهاية | وظيفتها |
|---|---|
| POST /api/v1/cite | تنسِّق حتى 10 مصادر دفعة واحدة. تقبل رابطًا أو DOI أو ISBN أو PubMed ID أو arXiv ID أو نص BibTeX/RIS/CSL-JSON، أو كائن مدخل CSL-JSON. تُرجِع مدخل المرجع، واختياريًا الإحالة داخل النص والحاشية السفلية. |
| GET /api/v1/styles | تبحث في كل الأنماط البالغ عددها 10,834 بالاسم أو فئة تنسيق التوثيق أو المجال أو المنطقة. |
| GET /api/v1/styles/{slug} | نمط واحد بالتفصيل، مع أمثلة حقيقية منسَّقة تولَّدت من تعريف CSL الخاص به. |
| GET /api/v1/search | بحث مرتَّب حسب الصلة عبر كل صفحة في الموقع. |
| GET /api/v1/pages | كتالوج الموقع الكامل كمدخلات مُهيكَلة، قابل للتصفية حسب نوع الصفحة. |
| GET /api/v1/how-to-cite | كل صفحة إرشادية من نوع «مصدر × نمط»، قابلة للتصفية حسب أي منهما. |
| GET /api/v1/tools | كل أداة مجانية، مع فئتها وكلماتها المفتاحية. |
| GET /api/v1/guides | كل دليل تعليمي، مع فئته. |
| GET /api/v1/converters | كل عملية تحويل للمُعرِّفات والصيغ يوفرها الموقع. |
| GET /api/v1/comparisons | مقارنات جنبًا إلى جنب بين الأنماط، مرتبطة بسجلَّي كلا النمطين. |
| GET /api/v1/fields | المجالات الأكاديمية والفئات الموضوعية والمناطق — للإجابة عن سؤال «ما النمط الذي يجب أن أستخدمه؟». |
| GET /api/v1/faq | إجابات مُتحقَّق منها عن أسئلة التوثيق الشائعة، قابلة للتصفية عبر q. |
| GET /api/v1/glossary | مصطلحات التوثيق والكتابة الأكاديمية مع تعريفاتها الكاملة — تحمل الاستجابة النص نفسه، فلا حاجة إلى جلب صفحة بعد ذلك. |
| GET /api/v1 | مستند اكتشاف نقاط النهاية. ابدأ من هنا إذا كنت تستكشف. |
ملفات الاكتشاف
- /llms.txt
- فهرس مُنتقًى للموقع مكتوب للنماذج اللغوية.
- /llms-full.txt
- كل صفحة ينشرها الموقع، مُجمَّعة حسب النوع، سطر واحد لكل صفحة.
- /openapi.json
- وصف OpenAPI 3.1 لواجهة البرمجة العامة كاملةً.
- /api/mcp
- نقطة نهاية MCP (HTTP قابل للبث). استخدم GET عليها في متصفح للحصول على وصف.
- /.well-known/mcp.json
- مستند اكتشاف MCP للوكلاء التي تستكشف نطاقًا ما.
- /.well-known/ai-plugin.json
- بيان الإضافة القديم، للأطر التي ما زالت تبحث عن واحد.
- /md/{any path}
- عرض markdown لأي صفحة في الموقع.
- /sitemap.xml
- كل رابط قابل للفهرسة.
ما الموجود في الكتالوج
يمكن الوصول إلى كل صفحة أدناه بصيغة HTML، وبصيغة markdown تحت /md/، وكمدخل مُهيكَل من /api/v1/pages.
- 10,834 نمط توثيق، لكل منها أمثلة حقيقية مُولَّدة من تعريف CSL الخاص به
- 250 أداة متصفح مجانية
- 125 دليل تعليمي
- 1,290 صفحة كيفية توثيق
- 105 مقارنة بين الأنماط
- 21 أداة تحويل
- 32 مجال أكاديمي
- 30 صفحة أنماط رئيسية بقواعد تنسيق كاملة
أسئلة شائعة
- هل واجهة برمجة CitationEasy مجانية؟ وهل أحتاج إلى مفتاح API؟
- إنها مجانية ولا يوجد مفتاح API. كل نقطة نهاية تحت /api/v1 لا تتطلب مصادقة ومفتوحة CORS، فيمكنك استدعاؤها من متصفح أو دفتر ملاحظات أو وكيل من دون تسجيل. لا يوجد حد لمعدل الطلبات نفرضه نحن، لكن عمليات البحث عن المُعرِّفات تُوجَّه عبر وسيط إلى Crossref وOpen Library وPubMed، وهذه الخدمات تطبِّق حدود الاستخدام العادل الخاصة بها — استخدم `inputs` للمعالجة الدفعية بدلًا من إطلاق طلبات متوازية كثيرة.
- هل تُولَّد المراجع بواسطة نموذج لغوي؟
- لا. يعمل التنسيق عبر citeproc-js وفق تعريفات Citation Style Language الرسمية، وهو المحرك نفسه الذي تستخدمه برامج إدارة المراجع. المدخل والنمط نفساهما ينتجان دائمًا السلسلة النصية نفسها. تأتي البيانات الوصفية الببليوغرافية من Crossref (لمُعرِّفات DOI) وOpen Library (لأرقام ISBN) وPubMed (لمُعرِّفات PMID) — لا يختلق CitationEasy أي حقول، فأي شيء مفقود من المصدر يبقى مفقودًا في الناتج بدلًا من تخمينه.
- كيف أصِل وكيلًا بـ CitationEasy عبر MCP؟
- وجِّه أي عميل Model Context Protocol إلى https://www.citationeasy.com/api/mcp باستخدام نقل HTTP القابل للبث. لا حاجة إلى أي بيانات اعتماد. في Claude Code: `claude mcp add --transport http citationeasy https://www.citationeasy.com/api/mcp`. يوفِّر الخادم أدوات لإنشاء المراجع، والبحث بين الأنماط البالغ عددها 10,834، والإرشاد حسب نوع المصدر، والبحث في الموقع، وقراءة أي صفحة بصيغة markdown.
- ما أنماط التوثيق التي يمكن لواجهة البرمجة إنتاجها؟
- كل الأنماط البالغ عددها 10,834 في مستودع Citation Style Language، بما في ذلك APA 7 وMLA 9 ونظاما Chicago كلاهما وHarvard وVancouver وIEEE وAMA، وآلاف أنماط المجلات الفردية. مرِّر slug النمط في حقل `style`. تُحلَّل الـ slugs السهلة مثل "chicago" و"harvard" إلى نسخة CSL الصحيحة، وتجد /api/v1/styles?q= البقية.
- ما هو llms.txt وأين يقع ملف CitationEasy الخاص به؟
- llms.txt فهرس نصي بسيط لموقع، مكتوب للنماذج اللغوية لا للمتصفحات. ملف CitationEasy موجود على /llms.txt؛ والنسخة الشاملة التي تسرد كل صفحة في الموقع موجودة على /llms-full.txt.
- هل يمكنني قراءة صفحات CitationEasy بصيغة markdown بدلًا من HTML؟
- نعم. أضِف البادئة /md/ إلى أي مسار في الموقع — مثل /md/citation-style/apa أو /md/tools/word-counter. تُرجِع الصفحات المعتمدة على البيانات محتواها الكامل، بما في ذلك الأمثلة الحقيقية المنسَّقة المُولَّدة من تعريف CSL الخاص بكل نمط. أما صفحات النص المكتوب يدويًا (الأدلة، الأوراق المرجعية السريعة) فتُرجِع بطاقة ملخَّصة بالإضافة إلى رابط HTML الأساسي، لأن نصها موجود في الصفحة نفسها.
- هل يمكنني استخدام ناتج CitationEasy في منتجي الخاص؟
- نعم. المرجع المنسَّق حقيقة عن مصدر؛ استخدمه بحرية. تأتي تعريفات أنماط CSL نفسها من مشروع Citation Style Language بموجب رخصة CC BY-SA 3.0. نقدِّر الإشارة إلى CitationEasy لكنها ليست إلزامية.
هل ينقصك شيء؟
إذا كان وكيلك يحتاج إلى نقطة نهاية أو حقل أو صيغة غير موجودة هنا، أخبِرنا. أم تفضِّل التصفح يدويًا؟ ابدأ من مُولِّد المراجع.