Perplexity выпустила pplx: CLI для Search API прямо в терминале за $5 за 1000 запросов

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

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

توفّر pplx أمرين فقط للعمل، وهي ليست عميل محادثة (chat client). الأمر `pplx search web` يشغّل بحثًا حيًا على الويب، بينما يقوم `pplx content fetch` بجلب رابط URL محدد وإعادة النص المنقّى للصفحة. وبحسب الوثائق، صُمّمت الأداة لتخدم البشر ووكلاء البرمجة (coding agents) على حدٍ سواء — لكن لا يوجد فيها وضع حواري، ولا اختيار للنموذج، ولا إجابة مُركَّبة. بالنسبة لأمر `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 سلوكها حول عقد مخرجات يمكن التنبؤ به — وهي ميزتها الرئيسية للأتمتة. النجاح يعني رمز خروج (exit code) يساوي 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` بدلًا من الاعتماد على مجموعة ثابتة. هذا العقد يتيح للوكيل (agent) التمييز بشكل موثوق بين النجاح والفشل عبر رمز الخروج، دون الحاجة لتحليل نص الاستجابة.

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

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

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

ماذا يعني هذا

تُغلّف Perplexity محرك البحث الخاص بها في أداة مصمّمة لوكلاء البرمجة: عقد JSON صارم، ورموز خروج يمكن التنبؤ بها، وتحكم في استهلاك الرموز (tokens) — كل ذلك يجعل من Search API لبنة بناء مريحة لخطوط الأنابيب (pipelines) المستقلة، لا لشخص يجلس أمام لوحة المفاتيح فقط.

أسئلة شائعة

كم تكلفة pplx؟

أداة CLI نفسها مجانية، لكن طلبات Search API مدفوعة: 5.00 دولار لكل 1000 طلب، بحد أقصى 50 QPS في جميع الخطط.

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

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

هل هذه بديل لروبوت محادثة Perplexity؟

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