Perplexity تطلق pplx: واجهة سطر أوامر لـ Search API مباشرة في الطرفية بسعر 5 دولارات لكل 1000 طلب

أطلقت Perplexity في 27 يوليو 2026 أداة pplx، وهي عميل CLI رسمي لـ Search API الخاص بها. تعيد الأداة نتائج البحث على الويب والنص المنقّى للصفحات بصيغة JSON مباشرة في الطرفية، بسعر 5 دولارات لكل 1000 طلب.

ما الذي تستطيع pplx فعله

توفّر pplx أمرين عمليين فقط، وهي ليست عميل دردشة. يشغّل الأمر pplx search web بحثًا حيًا على الويب، بينما يجلب الأمر pplx content fetch عنوان URL المحدّد ويعيد النص المنقّى للصفحة. وبحسب الوثائق، صُمِّمت الأداة بالقدر نفسه للبشر ولوكلاء البرمجة، لكن لا يوجد فيها وضع محادثة ولا اختيار للنموذج ولا إجابة مُركَّبة. وفيما يخص content fetch، تنصح الوثائق بالتحقق من الحقلين error وis_paywall في المخرجات قبل استخدام النص، كما يضيف الخيار --html شيفرة HTML الخام الحية عبر الزاحف (crawler).

• أمران: pplx search web (البحث) وpplx content fetch (استخراج الصفحة)
• المخرجات دائمًا بصيغة JSON، دون أي دردشة
• سعر Search API هو 5,00 دولار لكل 1000 طلب
• الحد الأقصى 50 QPS في جميع الباقات
• المنصات: macOS على Apple Silicon وLinux x86_64 وLinux arm64

كيف صُمِّم عقد المخرجات

تبني pplx سلوكها حول عقد مخرجات قابل للتنبؤ، وهذه ميزتها الرئيسية في الأتمتة. النجاح يعني رمز إرجاع 0 وكائن JSON واحدًا بالضبط في stdout؛ ويعيد البحث بنية تضم مصفوفة hits وحقل total وحقل saved_to الاختياري. أما أي فشل فينتهي برمز 1 مع stdout فارغ، ويُرسَل كائن JSON وحيد يصف الخطأ إلى stderr، بحقول code وmessage وcommand وحقل hint الاختياري.

«النجاح هو رمز إرجاع 0 وكائن JSON واحد بالضبط في stdout»، كما ورد في

Agent Skill الرسمي pplx-cli.

رموز الأخطاء الموثَّقة هي AUTHENTICATION وUNKNOWN_ARGUMENT وARGUMENT_ERROR وBAD_REQUEST. القائمة غير حصرية، لذا ينبغي للشيفرة المستدعية أن تتفرّع بحسب الحقل error.code، لا أن تعتمد على مجموعة ثابتة. ويتيح هذا العقد للوكيل التمييز بين النجاح والفشل بموثوقية من رمز الخروج، دون تحليل نص الاستجابة.

التثبيت وتوفير السياق

يتم تثبيت pplx بأمر shell واحد ينزّل سكربتًا ويمرّره إلى sh؛ ويوضع الملف التنفيذي في المجلد ~/.local/bin/pplx دون الحاجة إلى sudo. يجلب السكربت الملف manifest.json من أحدث إصدار، ويثبّت رقم الإصدار في جميع عمليات التنزيل (لتفادي الوقوع على نشر متزامن)، ويتحقق من المجموع الاختباري SHA256، ثم يثبّت الملف بعد ذلك فقط. لا يوجد دعم لـ Windows ولا لنسخة Intel من macOS، فالمنصات المتاحة ثلاث فقط.

وأولت Perplexity اهتمامًا خاصًا بتوفير نافذة السياق، وهو أمر حاسم للوكلاء. يكتب الخيار --output-dir النتيجة الكاملة في ملف JSON، بينما يقتطع --stdout-preview الحقول النصية الطويلة في stdout ويضيف علامات truncated. وثمة فخّ مهم: لا يعمل --stdout-preview بدون مجلد للحفظ، إذ لا يُفعَّل الاقتطاع إلا مع --output-dir أو مع المتغير PPLX_OUTPUT_DIR. وبالنسبة إلى CI والوكلاء، فإن المصادقة عبر pplx auth login غير متاحة، لأنها تعمل في TTY فقط، ولذلك يُمرَّر المفتاح عبر المتغير PERPLEXITY_API_KEY.

ما معنى ذلك

تعبّئ Perplexity محرك البحث الخاص بها في أداة مصمَّمة لوكلاء البرمجة: عقد JSON صارم، ورموز خروج قابلة للتنبؤ، وتحكّم في استهلاك التوكنات، وكلها تجعل Search API لبنة بناء مناسبة لخطوط المعالجة المستقلة، وليس للإنسان الجالس أمام لوحة المفاتيح فحسب.

الأسئلة الشائعة

كم تكلفة pplx؟

الأداة نفسها مجانية، لكن الطلبات الموجّهة إلى Search API تُحتسب بالرسوم: 5,00 دولار لكل 1000 طلب، مع حدّ أقصى 50 QPS في جميع الباقات.

هل تعمل pplx على Windows؟

لا. المدعوم فقط macOS على Apple Silicon وLinux x86_64 وLinux arm64. ولا توجد في هذا الإصدار نسخ لـ Windows ولا لنسخة Intel من macOS.

هل هي بديل لروبوت الدردشة Perplexity؟

لا. pplx ليست عميل دردشة: لا يوجد فيها وضع محادثة ولا اختيار للنموذج ولا إجابة مُركَّبة، بل بحث على الويب واستخراج نصوص الصفحات بصيغة JSON فقط.