كيفية ربط Cursor بمتصفح حقيقي عبر CDP — صورة غلاف مقال Clawbrowser

كيفية ربط Cursor بمتصفح حقيقي عبر CDP

Clawbrowser TeamAI-agentscdpcursorدليل

أداة المتصفح المدمجة في Cursor مفيدة عندما تختبر تطبيقك المحلي. تستطيع فتح الصفحات والنقر والكتابة والتقاط screenshots. لكنها في النهاية webview معزول: لا يوفر cookies دائمة بشكل موثوق، ولا يدير fingerprint، ولا يعطي browser identity متسقة عندما يفحص الموقع إشارات anti-bot.

الخلاصة: اربط Cursor مع Clawbrowser عبر CDP (Chrome DevTools Protocol). سيستخدم agent متصفح Chromium حقيقيًا مع persistent profiles وmanaged fingerprints وproxy routing. ثبّت runtime، شغّل profile، ثم أعط Cursor endpoint المحلي.

لماذا لا يكفي المتصفح المدمج في Cursor

يوفر Cursor أداة browser مبنية على sandboxed webview تعمل كامتداد MCP server. هذا جيد مع localhost: navigate وclick وtype وscroll وscreenshot وconsole output وnetwork traffic.

لكن عند التعامل مع الويب الحقيقي تظهر القيود:

القيد ما الذي يحدث
Sandboxed webview ليس Chromium instance حقيقيًا. ترى المواقع APIs مفقودة وwindow properties غير قياسية.
لا توجد session persistence Cookies وlocalStorage مرتبطان بالـworkspace ولا يبقيان بثبات بين التشغيلات.
لا يوجد fingerprint management يظهر canvas hash وWebGL renderer وnavigator properties نفسها تقريبًا في كل مرة.
لا يوجد proxy support كل traffic يخرج من IP الجهاز الافتراضي. Datacenter IPs تُعلّم بسرعة.
مشكلات موثوقية إصدارات Cursor 2.3.18+ شهدت regressions في click وscroll والعثور على العناصر.

إذا كان agent يحتاج تسجيل دخول، أو جمع بيانات خلف Cloudflare، أو تنفيذ workflow متعدد الخطوات على production site، فـwebview المدمج ليس طبقة المتصفح المناسبة.

ما الذي يقدمه CDP

CDP (Chrome DevTools Protocol) هو الواجهة القياسية للتحكم في متصفحات Chromium برمجيًا. يستخدم Playwright connectOverCDP، ويستخدم Puppeteer puppeteer.connect، ويفتح CDP client خام WebSocket إلى debugging port.

عند ربط Cursor بمتصفح خارجي عبر CDP تحصل على:

  • متصفح حقيقي بمحرك rendering كامل وextensions وAPIs قياسية
  • Persistent sessions مع cookies وحالة login تبقى بين تشغيلات agent
  • تحكم كامل بالصفحة عبر البروتوكول نفسه الذي يستخدمه Playwright وPuppeteer
  • Anti-detection عندما يدير المتصفح fingerprint وproxy identity بشكل متسق

الاتصال هو WebSocket URL قياسي. أي tool يتحدث CDP يستطيع الاتصال بأي browser يعرّض CDP endpoint. يعرّض Clawbrowser endpoint لكل profile.

ربط Cursor مع Clawbrowser خطوة بخطوة

المتطلبات

  • macOS (Apple Silicon) أو Linux (x64 أو arm64) أو Windows
  • Cursor مثبت
  • Clawbrowser API key من app.clawbrowser.ai

الخطوة 1: تثبيت Clawbrowser

نزّل bootstrapper باسم clawctl واستخرجه:

# macOS (Apple Silicon)
archive="clawctl-macos-arm64.tar.gz"
curl -fL --retry 3 -o "$archive" \
  "https://github.com/clawbrowser/clawctl/releases/latest/download/${archive}"
tar -xzf "$archive"

على Linux استخدم clawctl-linux-amd64.tar.gz أو clawctl-linux-arm64.tar.gz. لا تحتاج Docker أو sudo.

اضبط API key:

./clawctl config set api-key

الخطوة 2: تشغيل browser profile

شغّل Clawbrowser باسم profile محدد. لكل profile fingerprint خاص وcookie storage وproxy اختياري:

# Start a profile and open the verification page
clawctl start --profile cursor-dev --url clawbrowser://verify/ --json

# Get the CDP endpoint for this profile
clawctl endpoint --profile cursor-dev --json

يعيد أمر endpoint رابطًا مثل http://127.0.0.1:9222. هذا هو CDP endpoint الذي سيتصل به Cursor agent.

الخطوة 3: الاتصال من Cursor عبر MCP

أبسط تكامل هو MCP server المدمج في Clawbrowser. يعرّض navigation وscreenshots وclicks وtab management وprofile startup كـMCP tools يستطيع Cursor استدعاءها مباشرة. يدير server اتصال CDP داخليًا.

شغّل installer لكتابة إعداد MCP المحلي:

clawctl install --agent all --json

سيقرأ Cursor هذا MCP server من الإعداد.

بديل: Microsoft Playwright MCP

إذا فضّلت Microsoft Playwright MCP server الرسمي، وجّهه إلى Clawbrowser CDP endpoint من Cursor Settings > MCP > Add Server:

{
  "mcpServers": {
    "playwright": {
      "command": "npx",
      "args": [

كلا المسارين يعطي Cursor أدوات browser عالية المستوى. يضيف Clawbrowser MCP server إدارة profiles وfingerprints فوق الإجراءات القياسية.

الخطوة 4: التحقق من الاتصال

اطلب من Cursor agent فتح صفحة اختبار:

Navigate to https://browserleaks.com/canvas and take a screenshot. Tell me what canvas fingerprint hash you see.

إذا نجح الاتصال، سترى canvas fingerprint حقيقيًا من Clawbrowser profile بدل hash عام من sandboxed webview.

اتصال CDP مباشر من الكود

إذا كان Cursor agent يكتب ويشغّل scripts بدل استخدام MCP tools، فاتصل مباشرة عبر Playwright أو Puppeteer:

Playwright (Python)

from playwright.async_api import async_playwright

async def browse_with_clawbrowser():
    async with async_playwright() as p:
        # Connect to Clawbrowser's CDP endpoint

Playwright (Node.js)

const { chromium } = require('playwright');

const browser = await chromium.connectOverCDP('http://127.0.0.1:9222');
const page = browser.contexts()[0].pages()[0];

Puppeteer

const puppeteer = require('puppeteer');

const browser = await puppeteer.connect({
  browserURL: 'http://127.0.0.1:9222'
});

تتصل الأطر الثلاثة بالـCDP endpoint نفسه. يدير Clawbrowser طبقة identity: Canvas وWebGL وAudioContext وfonts وscreen resolution وtimezone وnavigator properties وproxy routing تبقى متسقة داخل profile.

لماذا تهم anti-detection لوكلاء Cursor

عندما يتصفح Cursor agent الويب عبر browser عادي، تفحص أنظمة anti-bot هوية المتصفح عبر عدة surfaces:

الإشارة ما يتم فحصه Standard Chrome Clawbrowser
Canvas hash GPU rendering fingerprint Static, matches known automation profiles Unique per profile, consistent with reported GPU
WebGL renderer Graphics card identifier Exposes real hardware Matches the profile's simulated hardware
Navigator properties Browser version, platform, language Generic Chromium values Consistent with profile's OS and locale
Timezone System timezone vs IP geo Mismatches with proxy location Auto-aligned with proxy geography
CDP detection Runtime.enable traces Detectable via leaked CDP artifacts Engine-level patches suppress CDP signals

يترك Chromium العادي المتصل عبر CDP آثارًا تستطيع anti-bot scripts قراءتها بسرعة. يعالج Clawbrowser ذلك على مستوى engine، لا عبر JavaScript overrides يسهل كشفها من descriptors أو prototype chains.

هذا هو الفرق بين ربط Cursor بـchrome --remote-debugging-port=9222 الذي يتعرض للحظر، وربطه بـClawbrowser الذي يحافظ على browser identity متسقة.

إدارة عدة profiles

كل Clawbrowser profile معزول. يمكنك تشغيل عدة profiles في الوقت نفسه لحسابات أو مشاريع مختلفة:

# Create three profiles with different locations
clawctl create --profile account-a --location sweden --json
clawctl create --profile account-b --location germany --json
clawctl create --profile account-c --location japan --json

يحصل كل profile على fingerprint فريد وproxy IP خاص وstorage معزول. ترى المنصات مستخدمين مستقلين من أجهزة ودول مختلفة.

يمكن لـCursor agent التبديل بين profiles عبر CDP endpoints مختلفة، أو إدارة عدة profiles بالتوازي من script واحد.

المتصفح المدمج في Cursor مقابل CDP مقابل Clawbrowser

Cursor built-in Chrome via CDP Clawbrowser via CDP
Browser engine Sandboxed webview Real Chromium Real Chromium (patched)
Session persistence Workspace-scoped Manual profile dirs Named profiles with auto-persistence
Fingerprint management None None 20+ surfaces managed per profile
Proxy support None Manual flag Profile-bound, geo-aligned
Anti-bot survival Blocked instantly Blocked within minutes Passes Cloudflare, DataDome, PerimeterX
Multi-account Not possible Separate --user-data-dir Built-in profile isolation
Setup complexity Zero (built in) Moderate Three commands

استخدم المتصفح المدمج لفحص تطبيقك على localhost. استخدم Clawbrowser via CDP لأي workflow يلامس الويب الحقيقي.

FAQ

هل يعمل هذا مع agent mode في Cursor؟

نعم. يستطيع agent mode في Cursor استخدام أي MCP server، بما في ذلك server يتصل بمتصفح خارجي عبر CDP. تُنفذ الإجراءات في Clawbrowser بدل sandboxed webview.

هل أحتاج إلى Playwright أو Puppeteer؟

فقط إذا كان agent يكتب ويشغّل automation scripts. في workflow القائم على MCP، يدير server اتصال CDP داخليًا.

هل يمكن إعادة استخدام login sessions بين مشاريع Cursor؟

نعم. تحفظ Clawbrowser profiles cookies وlocalStorage وIndexedDB. سجّل الدخول مرة واحدة ثم أعد استخدام profile في workspace آخر.

ماذا لو اختلط browser tool في Cursor مع المتصفح الخارجي؟

يمكنك تعطيل المتصفح المدمج من Settings > Features > Browser. ويمكنهما أيضًا العمل معًا لأنهما مستقلان.

هل Clawbrowser مجاني؟

نعم. Clawbrowser مجاني وopen source وMIT-licensed. لا توجد seat fees أو usage limits أو browser runtime subscription. تحتاج API key من app.clawbrowser.ai للتحقق من التثبيت.

ابدأ

ثلاثة أوامر تربط Cursor agent بمتصفح حقيقي:

# Install Clawbrowser
clawctl install --json

# Set your API key
clawctl config set api-key

وجّه MCP server أو Playwright script إلى endpoint الناتج. سيتصفح Cursor agent الويب عبر browser مع managed fingerprints وpersistent sessions وproxy routing.

للمزيد عن CDP اقرأ متصفح CDP لوكلاء الذكاء الاصطناعي. ولشرح fingerprinting اقرأ بصمة المتصفح: أكثر من 20 إشارة.

تابع القراءة

مقالات ذات صلة

عرض كل المقالات →
CDP مقابل MCP: متى تستخدم كلًا منهما للتحكم بالمتصفح بالذكاء الاصطناعي — صورة غلاف مقال Clawbrowser

CDP مقابل MCP: متى تستخدم كلًا منهما للتحكم بالمتصفح بالذكاء الاصطناعي

CDP يتحكم بالمتصفح. MCP يربط الذكاء الاصطناعي. تعرّف متى تستخدم Chrome DevTools Protocol مقابل Model Context Protocol لأتمتة المتصفح بوكلاء الذكاء الاصطناعي.

قراءة المقال →
متصفح Anti-Detect مجاني لوكلاء AI: مقارنة شاملة — غلاف توضيحي لمقال Clawbrowser

متصفح Anti-Detect مجاني لوكلاء AI: مقارنة شاملة للخيارات المتاحة

معظم متصفحات anti-detect تفرض رسومًا على كل profile أو جلسة. هذا الدليل يقارن الخيارات المجانية فعليًا لأتمتة وكلاء AI ويوضح الفروقات الجوهرية بينها.

قراءة المقال →
← العودة إلى كل المقالات