Browser Use MCP: أتمتة المتصفح ببيانات الإتاحة

لمن يناسب

إذا كنت تريد أن يشغّل نموذج كبير متصفحًا، وأن يكون المسار الافتراضي بيانات الإتاحة المنظّمة من Puppeteer لا نموذج رؤية من البداية، فهذا الخادم يناسب. تصفه الوثائق الرسمية بأنه خدمة MCP خفيفة تمنح النماذج قدرة أتمتة المتصفح، مع وضع رؤية اختياري للتخطيطات المعقّدة والعناصر البصرية.

يناسب من ثبّت بالفعل Node.js 18 أو أحدث ويستخدم VS Code، Cursor، Windsurf أو Claude Desktop. إن لم يكن لديك Node.js 18+، أو تعذّر على العميل إضافة MCP من نوع command، فلا تصله بعد.

ليست هذه خلاصة صفحة للقراءة فقط: أتمتة المتصفح تشغّل متصفحًا أو تتصل به، وتقرأ شجرة الإتاحة، وقد تعالج معلومات بصرية أثقل في وضع الرؤية. تقول الوثائق الرسمية إن الافتراضي لا يحتاج نموذج رؤية ويستهلك أساسًا بيانات منظّمة، لكن الخروج إلى الشبكة وعملية المتصفح المحلية موجودان.

إكمال المحاولة الأولى في 3 دقائق

المسار الرسمي الموصى به هو تشغيل @agent-infra/mcp-server-browser عبر npx. الشرط المسبق: Node.js 18 أو أحدث مثبت مسبقًا على هذا الجهاز.

في VS Code، الأمر الرسمي هو:

code --add-mcp '{"name":"browser","command":"npx","args":["@agent-infra/mcp-server-browser@latest"]}'

يسجّل ذلك MCP باسم browser، والأمر npx، والوسيط @agent-infra/mcp-server-browser@latest. بعد التنفيذ أعد تحميل العميل وتأكد أن خدمة browser متصلة.

ثم نفّذ استدعاءً منخفض المخاطر: استخدم قدرة أتمتة المتصفح التي تقدّمها خدمة browser هذه، واتبع مسار بيانات الإتاحة المنظّمة الافتراضي، ولا تفتح وضع الرؤية. الصفحات الرسمية لا تكتب أسماء أدوات محدّدة ولا معاملات ولا عناوين مثال، لذا استدعِ فقط الأدوات التي يعرضها العميل لهذه الخدمة browser. لا تخترع أسماء أدوات لم تظهر، ولا تخترع عنوانًا لفتحه. إشارة النجاح: يعرض العميل browser على أنه متصل، ويعيد نتيجة منظّمة مبنية على شجرة الإتاحة لا لقطة بصرية.

لدى الوثائق الرسمية أيضًا صيغة command تحت Cursor Settings -> MCP -> Add new MCP Server، وتشغيلًا بعيدًا بـ --port 8089؛ في المحاولة الأولى اتبع أمر VS Code أعلاه فقط. لا تفتح مسارًا ثانيًا بالتوازي.

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

الحالة الأولى: أتمتة المتصفح ببيانات الإتاحة المنظّمة الافتراضية. تقول الوثائق الرسمية إنها تمنح النموذج قدرة متصفح عبر بيانات الإتاحة المنظّمة من Puppeteer، بلا نموذج رؤية، وتستهلك أساسًا بيانات منظّمة لتقليل السياق. استخدم هذا عندما تريد أن يفهم النموذج عناصر التحكم وبنية النص في صفحة. الوثائق الرسمية لا تسمّي أداة محدّدة ولا تعطي موقع مثال؛ عند الاستدعاء استخدم فقط الأدوات التي يعرضها العميل وتنتمي إلى خدمة browser، واجعل معيار النجاح الحصول على بيانات إتاحة منظّمة.

الحالة الثانية: عندما لا تكفي البيانات المنظّمة، فكّر بعدها في وضع الرؤية الاختياري. تقول الوثائق الرسمية إن وضع الرؤية للتخطيطات المعقّدة والعناصر البصرية، وأنه اختياري. لا تكتب كيف يُفعَّل، ولا أي نموذج يلزم، ولا إن كان يُكتب إلى القرص؛ لذا يمكنك فقط تأكيد وجود قدرة رؤية اختيارية. لا تجعله خطوة إلزامية في المحاولة الأولى، ولا تفترض أنه صفر مخاطر. إن لم يكن لدى العميل شرح منفصل لمفتاح الرؤية، فهذا يعني أن الصفحة الرسمية لم تكتب خطوات التفعيل كاملة؛ ابقَ على مسار البيانات المنظّمة.

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

الشرط المسبق هو Node.js 18+. العملاء الذين تسمّيهم الوثائق الرسمية هم VS Code، Cursor، Windsurf، Claude Desktop. يمكن للتشغيل البعيد استخدام npx @agent-infra/mcp-server-browser --port 8089، ويمكن أيضًا تمرير DISPLAY=:0 لـ VNC أو عرض افتراضي؛ وليست هذه المسار الرئيسي للمحاولة الأولى.

تخرج أتمتة المتصفح إلى الشبكة، وتتحكّم في المتصفح، وقد تفتح صفحة تحدّدها، وتترك أثر تصفّح على هذا الجهاز. يُستخدم وضع الرؤية الاختياري فقط عندما لا تكفي البيانات المنظّمة؛ الوثائق الرسمية لا تصفه بأنه بلا شبكة أو بلا قراءة محلية.

لا تكتب الوثائق الرسمية حدًا للمعدل ولا تراجعًا ولا تراجعًا عن التنفيذ. إغلاق نافذة المتصفح أو إيقاف عملية npx هو الإيقاف الذي تستطيع فعله؛ أما التنقّل أو الإدخال الذي حدث فعلًا في الصفحة، فلا تعطي الوثائق الرسمية تراجعًا بنقرة واحدة.