Source-grounded research for Egyptian public affairs
ERX موجه للباحث والصحفي الذي يبدأ بسؤال عن الشأن المصري: قرار حكومي، مؤشر اقتصادي، تشريع، قضية حقوقية، خدمة عامة، أو طريقة تناول المصادر لخبر واحد. يجمع المواد الإخبارية والوثائق الرسمية والقانونية والأكاديمية والبيانات العامة، ثم يربط كل نتيجة بالرابط الأصلي وتاريخ النشر وسياق الظهور وسبب الترتيب.
ERX ليس وسيلة إعلام ولا يقرر صحة الادعاء نيابة عن الباحث. هو مساحة بحث قابلة للمراجعة تساعدك على الانتقال من السؤال → المصادر → الأدلة → الاستشهاد.
| الملف | أمثلة عملية |
|---|---|
| السياسة والاقتصاد | تتبع قرار حكومي، مقارنة التغطية، وربطه بالموازنة أو المؤشرات العامة |
| القانون والحقوق | الوصول إلى التشريع أو الحكم أو البيان الأصلي ومتابعة تطور القضية |
| المجتمع والخدمات العامة | بحث الصحة والتعليم والعمل والسكان عبر الأخبار والبيانات |
| الإعلام والخطاب العام | مقارنة العناوين والمواقف وتنوع الناشرين عبر فترة زمنية |
ابدأ من واجهة البحث دون حساب. ويمكن للمطورين
ووكلاء الذكاء الاصطناعي استخدام طبقة MCP وREST نفسها بعد ذلك — مع
مكتبتَي عميل Python وTypeScript، ودليل الاستخدام،
ومعرّفات استشهاد ثابتة وأمر dataset-dump لتصدير نسخة أرشيف قابلة للاستشهاد.
| ما الذي يقدمه ERX؟ | كيف يبقى قابلًا للمراجعة؟ |
|---|---|
| بحث عربي نصي ودلالي | سبب ترتيب واضح لكل نتيجة |
| مقارنة التغطيات والادعاءات | رابط الوثيقة والناشر والتاريخ |
| خط زمني وكيانات وأحداث | فصل تاريخ الحدث عن النشر والأرشفة |
| بيانات عامة حية | الترخيص ووقت الجلب والرابط الأصلي |
| تصدير RIS وBibTeX وCSV وJSONL | نقل المراجع دون فقدان المصدر |
نقطة MCP العامة:
https://erx-mcp.zad.tools/mcp
مثال لعميل يدعم Streamable HTTP:
{
"mcpServers": {
"egypt-research": {
"url": "https://erx-mcp.zad.tools/mcp"
}
}
}
أو شغّله محليًا عبر stdio:
npx -y egypt-research-mcp serve --transport stdio
| السطح | المسار | الاستخدام |
|---|---|---|
| الصفحة الرئيسية | / | تعريف المنتج وحالة الأرشيف |
| واجهة الباحث | /explore | بحث عربي دون حساب، مع أمثلة استعلامات موجّهة |
| خريطة المعرفة | /knowledge | كيانات وأحداث وادعاءات |
| من نحن | /about | المهمة والمنهجية والجهة المشغّلة |
| الخصوصية | /privacy | ما لا نسجّله ولا نتتبعه |
| السلامة للباحثين | /safety | إرشادات البحث في الموضوعات الحساسة |
| توثيق API | /docs | المسارات وأمثلة الاستخدام مع سنيبتات التثبيت |
| MCP | /mcp | Streamable HTTP للوكلاء |
| REST API | /api/v1 | تكاملات مستقرة، ترقيم، OpenAPI 3.1، رؤوس معدّل |
| خلاصة RSS | /feed.xml | أحدث الوثائق للمتابعة |
| الحالة | /status.html | لوحة حالة بشرية للأرشيف |
| الجاهزية | /readyz | فحص سلامة قاعدة البيانات |
| المقاييس | /metrics | مقاييس Prometheus |
| الأداة | الوظيفة |
|---|---|
egypt_search | بحث حسب النص ونوع المصدر والفترة |
egypt_hybrid_search | بحث نصي ودلالي مع تفسير الترتيب |
egypt_get_document | وثيقة كاملة مع بيانات الاستشهاد |
egypt_research_dossier | نتائج وخط زمني وكيانات وادعاءات في طلب واحد |
egypt_trace_claim | تتبع الادعاء إلى الأدلة التي أوردته |
egypt_compare_claims | تجميع الادعاءات المتشابهة ومقارنة المواقف |
| الأداة | الوظيفة |
|---|---|
egypt_compare_sources | مقارنة التغطية حسب نوع المصدر |
egypt_build_timeline | بناء خط زمني موثق |
egypt_list_stories | قصص متقاربة مع تنوع الناشرين |
egypt_find_entities | الكيانات ومواضع ظهورها |
egypt_list_events | الأحداث المؤرخة ووثائقها |
egypt_get_daily_brief | مواد يوم محدد وتنوع مصادرها |
egypt_list_sources | عرض كتالوج المصادر التشغيلية |
egypt_get_source_profile | بيانات المصدر وصحة الجمع |
| الأداة | الوظيفة |
|---|---|
egypt_list_live_datasets | كتالوج مجموعات البيانات العامة |
egypt_get_live_data | جلب مؤشر أو سجل حي مع بيانات المصدر |
egypt_compare_live_data | مقارنة سلاسل مع تنبيه اختلاف المنهجيات |
egypt_live_source_health | فحص صحة موفري البيانات الحية |
egypt_export_references | تصدير RIS وBibTeX وCSV وJSONL |
egypt_get_coverage | تغطية الأرشيف وصحة المصادر |
egypt_save_research_query | حفظ استعلام متابعة محليًا؛ معطلة على نقطة MCP العامة |
توجد أيضًا موارد egypt://sources وegypt://taxonomy وegypt://methodology،
وprompts للبحث المنظم والتحقق من الادعاءات. راجع src/mcp.ts
للتعريف التنفيذي الكامل.
robots.txt، ويطبّق تأخيرًا مستقلًا لكل مصدر وحدودًا للحجم والصفحات.GEMINI_API_KEY.التفاصيل: المعمارية · التشغيل · نموذج التهديد.
يتطلب Node.js 24 أو أحدث وnpm.
git clone https://github.com/ahmedvnabil/erx.git
cd erx
npm ci
npm run build
node dist/cli.js init
node dist/cli.js seed
node dist/cli.js serve --transport http --host 127.0.0.1 --port 8000
جمع البيانات وبناء الفهرس:
node dist/cli.js ingest
node dist/cli.js audit-sources --concurrency 10
node dist/cli.js index --provider local
node dist/cli.js rebuild-stories
node dist/cli.js rebuild-events
node dist/cli.js restore-excluded
node dist/cli.js health
node dist/cli.js status
أو عبر Docker:
docker compose build
docker compose run --rm egypt-research node dist/cli.js seed
docker compose up -d
npm run check
npm test
npm run test:coverage
npm run build
npm run release:check
عند إنشاء tag، ينشر المشروع حزمة npm وبيانات MCP Registry وصورة متعددة المعماريات على GitHub Container Registry. راجع قائمة الإطلاق وتقرير QA.
يشرح دليل الهوية العلامة، الألوان، نبرة الصوت، والاستخدام الصحيح للشعار. للمساهمة راجع CONTRIBUTING.md و CODE_OF_CONDUCT.md. للإبلاغ الأمني استخدم SECURITY.md.
Source-derived launch command. Check the maintainer’s required arguments and credentials before running:
npx -y egypt-research-mcpMerge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.
{
"mcpServers": {
"io-github-ahmedvnabil-egypt-research": {
"command": "npx",
"args": [
"-y",
"egypt-research-mcp"
]
}
}
}Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.
Claude Desktop setup referenceegypt-research-mcpnpmEgypt Research Commons works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.
~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.~/.cursor/mcp.jsonRestart Cursor for changes to take effect..vscode/mcp.jsonReload VS Code window for changes to take effect.~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect..mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.