حوّل الوثائق بـ MinerU داخل Claude Code

Install

npx skills add tanis90/pdf-converter-mineru

لمن يناسب

إن كنت تعالج أصلًا وثائق محلية في Claude Code وتريد تحويل PDF أو صور أو ملفات Office إلى نص قابل للتحرير، فهذه المهارة تناسب. الرسمي يكتبها كمهارة Claude Code على منظومة MinerU لتحويل PDF ووثائق أخرى. صفحة MinerU هي

https://mineru.net/

صيغ الإخراج مكتوبة Markdown وWord وHTML وLaTeX أو نص صرف. البيئة المسمّاة هي Claude Code: عندما تطلب تحويلًا أو استخراج وثيقة يستدعي Claude تلقائيًا mineru-open-api. الصفحة لا تعطي أوامر تثبيت لوكلاء آخرين ولا تكتب الدعم كسجل حصري.

الأنسب من لديه PDF أو ملف مكتب يمكن تحويله محليًا ويريد رؤية نتيجة flash-extract الافتراضية أولًا لا القفز إلى extract كامل. الملاحظات الرسمية:

https://github.com/tanis90/pdf-converter-mineru

أول تجربة في 3 دقائق

اتبع مسار التثبيت الرسمي هذا فقط:

npx skills add tanis90/pdf-converter-mineru

الشرط: تستطيع فتح Claude Code محليًا ولديك PDF أو وثيقة مكتب محلية. التثبيت هو ذلك الأمر؛ الصفحة لا تعطي مثبّتًا ثانيًا.

للمهمة الأولى اختر تحويلًا منخفض المخاطر. أكّد أولًا مع Claude مسار المصدر وصيغة الهدف (ابدأ بـ Markdown أو نص صرف) وأين يُكتب الناتج؛ بعد موافقتك دعه يحوّل. الوضع الافتراضي هو flash-extract ولا يلزم مصادقة أولًا. التحويل يكتب ملفًا جديدًا وهو أيضًا استدعاء صادر. أكّد المسار قبل التنفيذ.

إشارة النجاح: بعد تثبيت المهارة يستخدم Claude mineru-open-api تلقائيًا وينتج Markdown أو نصًا صرفًا يمكن فتحه، لا تنبيه «غير مثبّت». إن أراد mineru-open-api auth فتوقف أولًا وأكّد أنك تقصد فتح وضع extract. ذلك ليس لازمًا للتجربة الأولى.

حالات الاستخدام

الحالة 1: حوّل PDF إلى Markdown بـ flash-extract الافتراضي.

الرسمي يقول إن PDF يمكن أن يصير Markdown والافتراضي هو flash-extract. في المرة الأولى حوّل PDFًا معروفًا واحدًا وتحقق من بقاء العناوين والفقرات. الصفحة لا تصف الرؤوس والتذييلات أو الممسوحات أو PDF المشفّر، ولا فرق الجودة بين flash-extract وextract. ما يمكن تأكيده هو اسم الوضع الافتراضي وأن Claude يستدعي mineru-open-api تلقائيًا.

الحالة 2: صادق أولًا ثم extract على صورة أو وثيقة Office.

الرسمي يقول إن تشغيل mineru-open-api auth يفتح وضع extract، ونطاق التحويل يشمل الصور ووثائق Office، والهدف ما زال يمكن أن يكون Markdown أو Word أو HTML أو LaTeX أو نصًا صرفًا. شغّل المصادقة وحدها أولًا وبعد نجاح الفتح اختر صورة أو ملف مكتب. المصادقة تغيّر بيانات الاعتماد المحلية؛ أكّد أن نافذة الأمر من mineru-open-api auth قبل المتابعة. الصفحة لا تسرد حقول المصادقة ولا مفاتيح extract الإضافية.

الحالتان تقومان على أمر تثبيت npx نفسه. لا تجرّب طرق تثبيت أخرى بالتوازي في المرة الأولى.

حدود الاستخدام

أمر التثبيت الرسمي القابل للنسخ هو فقط npx skills add tanis90/pdf-converter-mineru. الافتراضي دائمًا flash-extract. لـ extract يجب إنجاح mineru-open-api auth أولًا. الصفحة لا تجعل المصادقة شرطًا لأول تحويل ولا تقول إنه يمكن تجاوز Claude واستخدامه كمحوّل مستقل.

التغطية هي PDF والصور وOffice إلى خمس صيغ نص أو وثيقة، بلا حجم ملف أو عدد صفحات أو نطاق لغات. التحويل يكتب ملفات جديدة؛ أكّد المسار أولًا. MinerU مكتوب كمنظومة تحتية؛ التفاصيل تتبع