ملاحظة المؤلف: بدءًا من توجيه جملة واحدة إلى الـ Agent، ثبّت Agent-Reach خطوة بخطوة، ودع Claude Code وCodex وغيرها من الـ Agents تقرأ منشورات شياوهونغشو (小红书) وتغريدات X وترجمات بيليبيلي (B站)، مع جدول القنوات، ومقارنة الأوامر، واستكشاف الأخطاء، وتقدير التكاليف.
اطلب من الـ Agent إجراء بحث عن المنافسين، وسيصطدم بالحائط سريعًا. تقول له «انظر كيف يقيّم الناس هذه السماعة على شياوهونغشو»، فلا يعيد البحث المدمج عبر الويب إلا بضعة مقالات منسوخة، أما منشورات شياوهونغشو نفسها فلا يستطيع الوصول إليها إطلاقًا. وتقول له «لخّص ما نشره حساب معيّن على X هذا الأسبوع»، فلا يستطيع فتح الجدول الزمني المخبأ خلف جدار تسجيل الدخول.
والأسوأ من ذلك هو المحتوى المرئي. في مقطع تقني مدته 40 دقيقة على بيليبيلي تكون المعلومات القيّمة كلها في الكلام المنطوق. البحث العام لا يصل إلى ترجمات بيليبيلي، فيبقى الـ Agent يتخمّن انطلاقًا من العنوان والوصف. ومنصات صينية مثل Xueqiu وV2EX تغطيتها في البحث العام ضعيفة أيضًا، والصفحات التي تعود محمّلة بقدر كبير من عناصر التنقل والإعلانات.
وهذه بالضبط هي المشكلة التي يعالجها المشروع مفتوح المصدر Agent-Reach. تجاوز عدد نجومه على GitHub 100 ألف نجمة، وهدفه المعلن هو «أن يمنح الـ AI Agent وصولًا إلى إنترنت لا يقدر على الوصول إليه بنفسه». وهذه ليست أداة أخرى تضطرك إلى حفظ الأوامر: الخط الرئيسي في هذا الدرس هو إتمام التثبيت بتوجيه جملة واحدة إلى الـ Agent، ثم تأتي إضافة القنوات وتبديل الحسابات والترقية، وكلها بالكلام العادي.
القيمة الأساسية: بعد قراءة هذا المقال ستجعل الـ Agent الخاص بك يقرأ محتوى X وReddit وبيليبيلي وشياوهونغشو وغيرها من المنصات، وستعرف بوضوح كيف تتحقق من كل خطوة، وكيف تتتبّع الأخطاء، وكم تكلّف دراسة واحدة تقريبًا.
النقاط الأساسية في دليل Agent-Reach
قبل أن نبدأ، لنضع الحقائق الأساسية عن Agent-Reach في جدول واحد. المعلومات التالية مبنية على مراجعة مستودع المشروع بتاريخ 2026-10-26.
| النقطة | الوصف | قيمتها بالنسبة لك |
|---|---|---|
| شعبية المشروع | تجاوز عدد النجوم 100 ألف، واحتلّ المرتبة الأولى في Trendshift GitHub Trending ليوم واحد | مجتمع نشط، وهناك من يتابع المشكلات ويحلها |
| الترخيص والبيئة | مفتوح المصدر برخصة MIT، مكتوب بلغة Python 3.10+ | يمكنك استخدامه مجانًا ومراجعة الشيفرة بنفسك |
| تكلفة المنصة | مجاني في ذاته، ولا يحتاج إلى أي رسوم API من المنصة | التكلفة الحقيقية هي فقط رموز (tokens) نموذج الوكيل |
| طريقة العمل | للقراءة فقط: يبحث ويقرأ، ولا ينشر ولا يعلّق ولا يُعجب ولا يرسل رسائل خاصة | لن “يتكلم” نيابةً عنك على المنصات |
| صيغة الإخراج | منذ الإصدار 1.6 وما بعده، يُخرج كل أمر كائن JSON واحدًا | يكفي أن يقرأ الوكيل ok / result / error.hint ليحكم على النجاح أو الفشل |
الفئات الأربع التي “لا يصل إليها” Agent-Reach
وكلاء CLI مثل Claude Code وCodex وHermes Agent وOpenClaw يأتون مزوّدين بالبحث وقراءة صفحات الويب، لكن هناك أربع فئات من المحتوى لا يستطيعون الوصول إليها بطبيعتهم. الفئة الأولى هي الوظائف التي تتطلب تسجيل الدخول، مثل البحث عن المنشورات في Xiaohongshu، أو الاطلاع على تحديثات حساب على X، أو قراءة تفاصيل وظيفة ما. الفئة الثانية هي المحتوى الموجود داخل الفيديوهات، بما في ذلك ترجمات Bilibili وYouTube، وتحويل الصوت إلى نص لفيديوهات YouTube وبودكاست Xiaoyuzhou.
الفئة الثالثة هي المنصات الصينية: Bilibili وXiaohongshu وV2EX وXueqiu تغطيتها في محركات البحث العامة ضعيفة جدًا. الفئة الرابعة هي البيانات المنظمة النظيفة، مثل أسعار Xueqiu، ومنشورات V2EX وردودها، ومستودعات GitHub وقضاياها (issues). ما يعيده Agent-Reach هو محتوى منظّم جاهز، وليس صفحة HTML كاملة، وهذا يقلل مباشرة من الرموز التي يستهلكها الوكيل.
فلسفة تصميم Agent-Reach: الخيار الأول ثم البديل
يصمم Agent-Reach كل إجراء على كل منصة على شكل “قائمة أدوات تُجرَّب بالترتيب”. فمثلاً، لقراءة فيديو على Bilibili يستخدم bili-cli أولاً، وإذا فشل يتحول تلقائيًا إلى واجهة Bilibili العامة؛ ولقراءة صفحة ويب يستخدم Jina Reader أولاً ثم Exa. تغيّر تصميم المنصات وتعطّل الأدوات أمر معتاد، وعلى المشرفين فقط تعديل هذه القائمة، بينما تبقى طريقة استخدامك أنت والوكيل كما هي تمامًا.
قنوات الدعم في Agent-Reach
في الإصدار الحالي، تُقسم القنوات إلى ثلاث فئات: القنوات الافتراضية تعمل بمجرد التثبيت؛ القنوات الاختيارية يمكن تفعيلها بمجرد أن تقول للوكيل “أضف لي XX”، وسيتم تثبيت البرامج المطلوبة تلقائيًا؛ القنوات التجريبية قابلة للاستخدام، لكن المنصات تفرض قيودًا أكثر صرامة على مكافحة الزحف، وقد تتوقف عن العمل في أي وقت. يُنصح بحفظ هذا الجدول، فهو يجيب عن السؤالين الأكثر شيوعًا: “ماذا يمكن فعله” و”ماذا نحتاج”.
| القناة | الفئة | ما يمكن فعله | ما هو مطلوب |
|---|---|---|---|
| bilibili | افتراضية | البحث، معلومات الفيديو، الأكثر رواجًا، الترجمة النصية | الترجمة النصية تتطلب تسجيل الدخول بمسح رمز QR |
| v2ex | افتراضية | الأكثر رواجًا، العقد، المنشورات والردود، المستخدمون | لا حاجة لتسجيل الدخول |
| github | افتراضية | البحث عن المستودعات، قراءة المستودعات و README، قراءة issue و PR (مع التعليقات) | لا حاجة لتسجيل الدخول |
| youtube | افتراضية | معلومات الفيديو، البحث، الترجمة النصية، تحويل الصوت إلى نص | تحويل النص يتطلب مفتاح Groq أو OpenAI |
| web | افتراضية | البحث في الويب، قراءة صفحات الويب (قناة احتياطية) | لا حاجة لتسجيل الدخول |
| xiaohongshu | اختيارية | البحث عن الملاحظات، قراءة النص، الاطلاع على التعليقات | تتطلب تسجيل الدخول |
| xueqiu | اختيارية | الأسعار الفورية، البحث عن الأسهم، المنشورات الرائجة، الأسهم الرائجة | الأسعار لا تتطلب تسجيل الدخول، المنشورات والأسهم الرائجة تتطلب تسجيل الدخول |
| boss | اختيارية | البحث عن الوظائف و JD | تتطلب تسجيل الدخول |
| xiaoyuzhou | اختيارية | تحويل البودكاست إلى نص | تتطلب مفتاح Groq |
| اختيارية | البحث عن الوظائف، قراءة تفاصيل الوظائف | الوظائف العامة لا تتطلب تسجيل الدخول، البحث داخل الموقع يتطلب تسجيل الدخول | |
| اختيارية | البحث عن المنشورات، قراءة النص، الاطلاع على التعليقات، الاطلاع على الأقسام | تتطلب تسجيل الدخول | |
| twitter (X) | تجريبية | البحث عن التغريدات، ملفات المستخدمين، تغريدات المستخدمين، قراءة سلاسل التغريدات | تتطلب تسجيل الدخول |
| تجريبية | البحث، معلومات الصفحة الرئيسية | تتطلب تسجيل الدخول | |
| تجريبية | البحث عن المستخدمين، معلومات الصفحة الرئيسية، منشورات المستخدمين | تتطلب تسجيل الدخول |
من الجدير بالملاحظة: القنوات الافتراضية يمكنك إزالتها إذا لم ترغب فيها، وبعد الإزالة لن تُضاف تلقائيًا مرة أخرى في التحديثات المستقبلية. X المذكور في العنوان ينتمي حاليًا إلى القنوات التجريبية، وهو مناسب للاستعلام العرضي وليس كمصدر بيانات مستقر تعتمد عليه يوميًا.
Agent-Reach: بدء سريع — تحدث إلى الوكيل بجملة واحدة
لا تتطلب عملية التثبيت بأكملها فتح الطرفية. كل خطوة أدناه مرفقة بـ«معيار قبول»، تأكد من اجتيازه قبل الانتقال إلى الخطوة التالية، وإذا واجهت مشكلة يمكنك الرجوع مباشرة إلى جدول استكشاف الأخطاء لاحقًا.
الخطوة 1: تفعيل «السماح بتنفيذ الأوامر» في إعدادات الوكيل
يحتاج Agent-Reach إلى أن يكون الوكيل قادرًا على تنفيذ أوامر الطرفية. ابحث في واجهة الإعدادات الرسومية للوكيل الذي تستخدمه عن مفتاح مثل «السماح بتنفيذ الأوامر» وقم بتشغيله؛ قد تختلف التسمية قليلًا من وكيل إلى آخر. لا تقلق إذا لم يكن uv مثبتًا على جهاز الكمبيوتر، فسيقوم الوكيل بتثبيت uv تلقائيًا أولًا، كل ما يلزم هو أمر واحد، دون الحاجة إلى كلمة مرور المسؤول.
- معيار القبول: قل للوكيل «أخبرني بالدليل الحالي»، فيجب أن ينفّذ الأمر فعليًا ويعيد مسارًا، بدلًا من الرد بـ«لا أستطيع تنفيذ الأوامر».
الخطوة الثانية: أرسل أمر التثبيت إلى الوكيل
هذه هي الطريقة الرسمية الأسهل على الإطلاق. ما عليك سوى نسخ الجملة التالية وإرسالها إلى الوكيل:
帮我安装 Agent Reach：https://raw.githubusercontent.com/Panniantong/Agent-Reach/main/docs/install.md
بعد أن يقرأ الوكيل تعليمات التثبيت، سيقوم من تلقاء نفسه بأمرين: أولًا ينفّذ uv tool install https://github.com/Panniantong/Agent-Reach/releases/latest/download/agent-reach.zip، ثم ينفّذ agent-reach setup. تُجمَع كل الملفات في مجلد واحد هو ~/.agent-reach/، ما يجعل الترقية والإدارة والحذف لاحقًا أمرًا سهلًا للغاية.
- معيار القبول: يُبلغ الوكيل عن اكتمال التثبيت، وعند تنفيذ
agent-reach channelsتكون قيمةokفي الـ JSON المُعاد هي true، وتظهر قائمة القنوات ضمنresult.
الخطوة الثالثة: اطلب من الوكيل فحص حالة القنوات
قل للوكيل: “ألقِ نظرة على حالة Agent Reach”. سيخبرك بما إذا كانت كل قناة تعمل الآن، وأي القنوات كانت تعمل في المرة السابقة وتوقفت الآن. هذه الخطوة بمثابة فحص شامل، ويُستحسن القيام بها أولًا أيضًا عند مواجهة أي مشكلة غريبة لاحقًا.
- معيار القبول: تظهر القنوات الخمس الافتراضية، وهي bilibili وv2ex وgithub وyoutube وweb، كقنوات متاحة؛ أما الميزات التي تحتاج إلى شروط إضافية مثل ترجمة مقاطع Bilibili أو تحويل فيديوهات YouTube إلى نص، فظهور رسالة “يتطلب تسجيل الدخول” أو “يتطلب مفتاحًا” فيها يُعد أمرًا طبيعيًا.
الخطوة 4: أضف القنوات الاختيارية وأكمل تسجيل الدخول
لنأخذ Xiaohongshu كمثال، قل للوكيل “أضف لي Xiaohongshu”، وسيقوم تلقائيًا بتثبيت البرامج اللازمة. المنصات التي تتطلب تسجيل الدخول يتولاها المتصفح المخصص المدمج في Agent-Reach، يعمل في الخلفية دون نوافذ منبثقة، والمتصفح المخصص متاح فقط لهذا الجهاز. إنه لا يسجّل الدخول نيابة عنك أبدًا، ولن يطلب منك كلمة المرور.
بعض المنصات تعيد استخدام حالة تسجيل الدخول الموجودة على جهازك، وتنسخ فقط تسجيل الدخول لهذا الموقع، دون تغيير المتصفح الأصلي، ودون قراءة قاعدة كلمات المرور. هنا يُرجى الاطلاع على تحذير المخاطر في القسم التالي بكل تأكيد، وإذا تبيّن أن ما تمت إعادة استخدامه هو الحساب الرئيسي، فقل للوكيل “بدّل الحساب” لاستخدام حساب ثانوي بدلًا منه.
- معيار القبول: قل مرة أخرى “اعرض حالة Agent Reach”، وسيظهر xiaohongshu كمتاح؛ ثم اطلب من الوكيل البحث عن كلمة مفتاحية، وستحتوي النتائج على عنوان المذكرة ومقتطف من النص.
الخطوة 5: شغّل أول مهمة بحث متعددة المنصات
صف الهدف باللغة الطبيعية، على سبيل المثال: “استخدم Agent Reach للتحقق من آراء الناس حول لوحة مفاتيح ميكانيكية معينة، اطّلع على مذكرات Xiaohongshu، ونصوص تقييمات الفيديو على Bilibili، ونقاشات Reddit، ثم لخّص كل منصة على حدة.” سيقوم الوكيل بتفكيكها بنفسه إلى عدة أوامر agent-reach <القناة> <الإجراء> [المعاملات] وتنفيذها.
- معيار القبول: يظهر ملخص الوكيل مقسّمًا حسب المنصة، وكل رأي يمكن ربطه بمذكرة أو فيديو أو منشور محدّد؛ وإذا فشلت إحدى القنوات، فيجب أن ينقل لك التلميح الوارد في
error.hintبدلًا من تخطيها بصمت.
🚀 نصيحة للبدء السريع: Agent-Reach مسؤول فقط عن إحضار المحتوى، أما الفهم والتلخيص فيعتمدان على نموذج اللغة الكبير الذي يشغّل الوكيل. إذا كان وكيلك يدعم واجهات نماذج مخصصة، يمكنك عبر APIYI apiyi.com استخدام مفتاح API واحد للاتصال بنماذج مثل Claude وGPT وGemini، والمستخدمون الجدد يحصلون على حصة تجريبية مجانية، وهي مناسبة لتشغيل أول مهمة بحث بأقل تكلفة ممكنة.
كيفية إعداد واجهة نماذج APIYI للوكيل الذكي
إذا كان الوكيل الذكي الخاص بك يدعم واجهات متوافقة مع OpenAI، ففكرة الإعداد تكون كالتالي، مع ملاحظة أن أسماء الحقول الفعلية تعتمد على شاشة الإعدادات في الوكيل الذي تستخدمه:
- عنوان الواجهة (base_url):
https://api.apiyi.com/v1 - مفتاح API: المفتاح الذي تنشئه في لوحة تحكم APIYI
-
اسم النموذج: للاستقصاء اليومي يُنصح باستخدام
claude-sonnet-5-5، أما المهام الخفيفة بالجملة فيمكن اختيارclaude-haiku-5-5 -
معيار القبول: أرسل جملة إلى الوكيل الذكي مثل “مرحبًا، أخبرني أي نموذج أنت”، فإن عاد المحتوى بشكل طبيعي وظهر سجل الاستدعاء المقابل في لوحة تحكم APIYI، فالإعداد صحيح.
جدول مقارنة أوامر Agent-Reach الشائعة
في الاستخدام اليومي يكفي أن تخاطب الوكيل الذكي بعبارات العمود الأيسر مباشرة. أما الأوامر في العمود الأيمن فهي لتفهم ما يفعله الوكيل خلف الكواليس، أو لاستخدامها عند تشخيص المشكلات في طرفيتك الخاصة.
| ما تقوله للوكيل الذكي | الأمر الذي ينفذه الوكيل خلف الكواليس | الغرض |
|---|---|---|
| “ما هي القنوات، وما الذي تقدمه كل واحدة” | agent-reach channels |
عرض القنوات وقدراتها |
| “ابحث في Bilibili عن النماذج الكبيرة” | agent-reach bilibili search "大模型" |
صيغة موحدة: القناة + الإجراء + المعاملات |
| “اقرأ هذا الرابط” | agent-reach read <الرابط> |
اختيار القناة تلقائيًا حسب الرابط |
| “حدّث Agent Reach” | agent-reach update |
تحديث البرنامج وأدوات كل القنوات والـ skill دفعة واحدة |
| “بعد التثبيت يقول إن الأمر غير موجود” | uv tool update-shell ثم افتح shell جديدًا |
إصلاح مسار الأوامر |
| (تنفذه بنفسك في الطرفية) | agent-reach configure groq-key |
إدخال المفتاح المطلوب لتحويل الصوت إلى نص |
| “أزل تثبيت Agent Reach” | اعرض أولاً ما سيُحذف، ثم احذف بعد التأكيد | إزالة آمنة |
إضافةً إلى ذلك، يمكنك أن تقول للوكيل الذكي مباشرة عبارات مثل “أزل Xiaohongshu” أو “انتهت صلاحية تسجيل الدخول إلى Xiaohongshu” أو “سجّل الخروج” أو “اجعل وكيلًا ذكيًا آخر يستخدمه أيضًا”، دون الحاجة إلى حفظ أي أوامر.
تنبيه مخاطر Agent-Reach (اقرأه قبل الاستخدام)
⚠️ يرجى قراءة هذا القسم بعناية قبل استخدام Agent-Reach
- هذه أداة مفتوحة المصدر من المجتمع، وليست API معتمدة رسميًا من أي منصة. نحن نوصي بهذا المشروع فقط، ولا نقدم أي ضمانات بشأن استقراره أو أمانه أو امتثاله للأنظمة.
- قد يتعرض الحساب لتقييد أو حظر. قد تعتبر منصات مثل X وشياوهونغشو وReddit أن الوصول الآلي سلوك غير طبيعي. كما يوصي ملف README الرسمي صراحةً باستخدام حساب ثانوي، لذا لا تستخدم حسابك المهم لتشغيل الـ Agent.
- قد يؤدي إعادة استخدام تسجيل الدخول المحلي إلى استخدام الحساب الرئيسي. بعض القنوات تعيد استخدام حالة تسجيل الدخول الموجودة على جهاز الكمبيوتر، والحساب الذي تسجل الدخول به عادةً هو حسابك الرئيسي. بعد تفعيل القناة، تحقق أولاً من الحساب المستخدم حاليًا، وإذا لزم الأمر قل للـ Agent «غيّر الحساب» للتبديل إلى الحساب الثانوي.
- المسؤولية على عاتقك. أي عواقب مثل حظر الحساب أو تقييده أو مشكلات الامتثال المتعلقة بجمع البيانات واستخدامها، يقدّرها القارئ ويتحملها بنفسه، ولا علاقة لمنصة APIYI ولا لمؤلف هذا المقال بها.
- تحقق من مصدر التثبيت. الحزمة المسماة agent-reach على PyPI ليست هذا المشروع، والتثبيت ممكن فقط من عنوان GitHub؛ لا يملك المشروع أي عملات رسمية أو رموز أو منتجات استثمارية أو اتصالات بمحافظ رقمية، وأي مشاريع عملات مشفرة تستعير هذا الاسم لا علاقة لها بهذا المستودع.
جدول استكشاف أخطاء Agent-Reach
المشكلات الخمس التالية هي الأكثر شيوعًا في مرحلة البدء، ويمكنك تنفيذ الخطوات المذكورة في كل صف منها مباشرة. وقبل أن تبدأ بالاستكشاف، يُستحسن أن تطلب من الوكيل تنفيذ «اعرض حالة Agent Reach» أولاً، وأن يخبرك بالنص الأصلي للحقل error.hint.
| العَرَض | السبب | الحل |
|---|---|---|
بعد التثبيت تظهر رسالة بأن الأمر agent-reach غير موجود |
مجلد أدوات uv لم يُضَف بعد إلى مسار الأوامر | اطلب من الوكيل تنفيذ uv tool update-shell، ثم افتح shell جديدًا (أو أعد تشغيل الوكيل) وحاول مرة أخرى |
| يرد الوكيل بعبارة «لا أستطيع تنفيذ الأوامر» | صلاحية تنفيذ الأوامر غير مفعّلة | عُد إلى الخطوة 1 وفعّل خيار «السماح بتنفيذ الأوامر» في إعدادات الوكيل |
| ظهور أخطاء متعددة بعد الترقية من الإصدار 1.5 | الإصدار 1.5 والإصدارات الأقدم كانت مثبّتة عبر pipx/pip | اطلب من الوكيل تنفيذ uv tool install --force مع رابط التثبيت من GitHub، ثم شغّل agent-reach setup، وستبقى مفاتيح API والإعدادات محفوظة |
| تعذّر البحث في شياوهونغشو فجأة وتظهر رسالة تطالب بتسجيل الدخول | انتهت صلاحية جلسة تسجيل الدخول | قل للوكيل «انتهت صلاحية تسجيل الدخول إلى شياوهونغشو» واتبع التعليمات لإعادة تسجيل الدخول (يُفضّل استخدام حساب ثانوي) |
| قناة X تعمل أحيانًا وتتعطّل أحيانًا | twitter قناة تجريبية، والمنصة تفرض قيودًا أشد على الكشط الآلي | تحقق أولاً من الحالة لتأكيد ما إذا كانت معطّلة، وإذا كانت كذلك فانتظر تحديث المشروع ثم نفّذ agent-reach update، ويمكنك أيضًا الإبلاغ عبر GitHub Issues |
تكلفة Agent-Reach واختيار النموذج
Agent-Reach نفسه مجاني، ولا توجد رسوم API للمنصة، وما يُكلّف المال فعليًا هو الـ tokens التي يستهلكها الوكيل (Agent) عند استدعائه لنموذج لغة كبير لتنفيذ المهمة. في ما يلي أسعار ثلاثة نماذج كما وردت في مركز توثيق APIYI على apiyi.com بتاريخ 2026-10-26، والوحدة دولار لكل مليون token، والنماذج والأسعار تخضع لقائمة النماذج المعتمدة على المنصة.
| النموذج | الإدخال | الإخراج | قراءة الذاكرة المؤقتة | مهام Agent-Reach المناسبة | المنصة المتاحة |
|---|---|---|---|---|---|
| claude-opus-5-5 | $4 | $20 | $0.2 | تقارير بحثية مطوّلة، والتحقق المتقاطع من معلومات عدة مصادر | APIYI apiyi.com |
| claude-sonnet-5-5 | $2 | $10 | $0.1 | الخيار الأساسي للبحوث اليومية عبر المنصات | APIYI |
| claude-haiku-5-5 | $0.1 | $0.5 | $0.01 | التلخيص بالجملة، والبحث البسيط، وفحص الحالة الدورية | APIYI |
لنضع تقديرًا تقريبيًا (ليس قياسًا فعليًا): في بحث واحد يشمل 4 منصات، يقرأ الوكيل 5 منشورات طويلة إضافة إلى 20 نتيجة بحث، فيكون الإدخال نحو 30 إلى 60 ألف token، والإخراج نحو 3 إلى 6 آلاف token. وبالحساب على claude-sonnet-5-5 تبلغ التكلفة نحو 0.1 دولار للمرة الواحدة؛ وإذا استخدمت claude-haiku-5-5 فستكون أقل من سنت واحد؛ أما مع claude-opus-5-5 فستتراوح بين 0.2 و0.35 دولار.
التوصية واضحة ومباشرة: ابدأ بتشغيل سير العمل باستخدام sonnet، ثم قرّر بناءً على جودة النتائج ما إذا كنت سترتقي إلى opus، وأسند المهام المتكررة بالجملة إلى haiku. ما يعيده Agent-Reach هو محتوى منظّم ومنسّق، وهو بحد ذاته يوفّر tokens مقارنة بترك الوكيل يقرأ صفحات الويب الخام، وعلى المدى الطويل يمكنك أيضًا مراعاة ما يوفّره سعر قراءة الذاكرة المؤقتة.
الأسئلة الشائعة FAQ
س1: هل Agent-Reach مجاني تمامًا فعلًا؟
Agent-Reach نفسه مجاني ومفتوح المصدر برخصة MIT، والمنصات لا تفرض رسوم API. ما تحتاج إلى دفعه هو فقط تكلفة الرموز (tokens) عند استدعاء الـ Agent لنموذج لغوي كبير. وحسب التقدير أعلاه، فإن مهمة بحثية تشمل 4 منصات باستخدام نموذج من فئة sonnet تكلّف حوالي 0.1 دولار أمريكي. وإذا أردت التجربة أولًا، يمكنك الحصول على حصة تجريبية مجانية للمستخدمين الجدد عبر APIYI (apiyi.com) لتشغيل مهمتك الأولى.
س2: هل يمكن أن يستخدم الـ Agent حسابي للنشر أو الإعجاب أو إرسال الرسائل الخاصة؟
لا. فـ Agent-Reach أداة للقراءة فقط، يبحث ويقرأ ولا ينشر ولا يعلّق ولا يعجب ولا يرسل رسائل خاصة. لكن كونها للقراءة فقط لا يعني انعدام المخاطر تمامًا، إذ قد تعتبر المنصة القراءة عالية التكرار وصولًا غير طبيعي، لذا يُنصح دائمًا باستخدام حساب ثانوي، راجع قسم التحذيرات من المخاطر للتفاصيل.
س3: كيف أفعّل تحويل الكلام إلى نص في YouTube وشياويوتشو؟ وهل يجب إرسال المفتاح إلى الـ Agent؟
تحويل الكلام إلى نص في YouTube يحتاج إلى مفتاح Groq أو OpenAI، أما شياويوتشو فيحتاج إلى مفتاح Groq. **لا ترسل المفتاح مباشرة في المحادثة**، فالتعليمات الرسمية تطلب تنفيذ `agent-reach configure groq-key` في طرفيتك الخاصة لملء المفتاح. طريقة التحقق: اطلب من الـ Agent تحويل فيديو على YouTube إلى نص، وتحقق من أن حقل `ok` في JSON المُعاد قيمته true ويحتوي على نص.
س4: أي نموذج يعمل بشكل أفضل مع Agent-Reach؟
للبحث اليومي يُنصح بالبدء بـ claude-sonnet-5-5، فهو يوازن بين فهم المحتوى من مصادر متعددة والتحكم في التكلفة؛ وعند الحاجة إلى تحليل معمّق انتقل إلى claude-opus-5-5. وعبر APIYI (apiyi.com) يمكنك التبديل بين هذه الطُرز بمفتاح واحد، بتغيير اسم النموذج فقط دون تغيير عنوان الواجهة، ما يسهّل مقارنة النتائج على نفس المهمة البحثية مباشرة.
س5: لقد ثبّته داخل Claude Code، كيف أجعل Agent آخر يستخدمه أيضًا؟
قل مباشرة للـ Agent المثبَّت: “اجعل وكيل ذكاء اصطناعي آخر يستخدمه أيضًا”، وسيتولى إعدادات المشاركة. ولأن جميع الملفات موضوعة بشكل موحّد في مجلد `~/.agent-reach/`، يكفي أن يفتح الـ Agent الآخر صلاحية تنفيذ الأوامر بالطريقة نفسها ليتمكن من الاستدعاء. طريقة التحقق: قل في الـ Agent الجديد “اعرض حالة Agent Reach”، ويجب أن يعيد قائمة قنوات مطابقة لتلك التي يعرضها الـ Agent الأصلي.
النقاط الرئيسية لدرس Agent-Reach
- تعريف في جملة واحدة: يتيح Agent-Reach للوكيل قراءة المحتوى الكائن خلف جدران تسجيل الدخول، وداخل الفيديوهات، وعلى المنصات الصينية.
- طريقة التثبيت: أرسل رابط install.md الرسمي إلى الوكيل، وسيقوم بتثبيت uv و agent-reach بنفسه.
- ثلاث فئات من القنوات: 5 قنوات جاهزة للاستخدام افتراضيًا، و6 قنوات اختيارية تُفعَّل بأمر واحد، و3 قنوات تجريبية قد تتوقف في أي لحظة.
- تصميم للقراءة فقط: لا نشر ولا إعجاب ولا رسائل خاصة، والمخرجات موحّدة بصيغة JSON تحتوي على حقل
ok. - أمان الحساب: الأداة مجتمعية وليست API رسميًا، وقد تؤدي إلى تقييد المعدل أو حظر الحساب، لذا احرص على استخدام حساب فرعي.
- التكلفة تحت السيطرة: رسوم API المنصات تساوي صفرًا، والتكلفة الأساسية هي tokens النموذج، ويمكن الدفع حسب الاستخدام عبر APIYI apiyi.com.
الخلاصة
النقاط الأساسية في درس Agent-Reach:
- يحل مشكلة حقيقية: منشورات Xiaohongshu وتحديثات حسابات X وترجمات Bilibili التي لا يصل إليها البحث العام، أصبح الوكيل قادرًا على قراءتها مباشرة.
- بدء بلا عوائق: جملة واحدة تقولها للوكيل تكفي لإتمام التثبيت، وبعدها تضيف القنوات وتغيّر الحسابات وتُجري الترقيات بلغة بسيطة.
- اعرف المخاطر بنفسك: هذه أداة مفتوحة المصدر من المجتمع، فاستخدم حسابًا فرعيًا، وتحقق جيدًا من الحسابات التي تعيد استخدامها، وحدّد العواقب التي تتحملها.
ننصح أولاً بتشغيل تجربة بحث واحدة عبر القنوات الافتراضية على Bilibili أو GitHub، وبعد التأكد من نجاح كل خطوة، أضف عند الحاجة قنوات تتطلب تسجيل الدخول مثل Xiaohongshu وReddit.
وإذا احتجت إلى نموذج، يمكنك اللجوء إلى APIYI apiyi.com.
📚 المراجع
- مستودع Agent-Reach على GitHub: الشيفرة المصدرية للمشروع وملف README وشرح القنوات
- الرابط:
github.com/Panniantong/Agent-Reach -
ملاحظة: مصدر التثبيت الموثوق الوحيد، وقائمة القنوات وإرشادات الأمان تُعتمد بناءً عليه
-
تعليمات التثبيت الرسمية لـ Agent-Reach: وثائق التثبيت المخصصة ليقرأها الوكيل
- الرابط:
raw.githubusercontent.com/Panniantong/Agent-Reach/main/docs/install.md -
ملاحظة: هذا هو العنوان الذي ترسله إلى الوكيل في الخطوة الثانية من هذا المقال
-
Agent-Reach GitHub Issues: قناة الإبلاغ عن المشكلات
- الرابط:
github.com/Panniantong/Agent-Reach/issues - ملاحظة: عند تعطل القنوات التجريبية أو ظهور أخطاء أثناء التثبيت، يمكنك البحث هنا أو إرسال ملاحظاتك
المؤلف: فريق APIYI التقني
التواصل التقني: يسعدنا تواصلك معنا عبر الصفحة الرئيسية لموقع APIYI، ولمزيد من المواد يمكنك زيارة مركز الوثائق docs.apiyi.com
