browser-act skills

Name: browser-act skills (Claude Skill)
Author: browser-act

لماذا تستخدمه

الميزات الأساسية

استخراج موجّه بالمخطط — مرّر JSON Schema واحصل على البيانات المطابقة
أسرع وأرخص من حلقات التقاط الشاشة + LLM
تدفقات متعددة الخطوات (تعبئة نموذج ← نقر ← استخراج النتيجة)
إعدادات افتراضية معقولة: تحديد معدل، إعادة المحاولة، وكيل مستخدم مؤدّب
موثوقية عالية على تطبيقات SPA الواقعية

عرض مباشر

كيف يبدو في الممارسة

جاهز

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "browser-act-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/browser-act/skills",
        "~/.claude/skills/browser-act"
      ],
      "_inferred": true
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "browser-act-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/browser-act/skills",
        "~/.claude/skills/browser-act"
      ],
      "_inferred": true
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "browser-act-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/browser-act/skills",
        "~/.claude/skills/browser-act"
      ],
      "_inferred": true
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "browser-act-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/browser-act/skills",
        "~/.claude/skills/browser-act"
      ],
      "_inferred": true
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "browser-act-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/browser-act/skills",
        "~/.claude/skills/browser-act"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json

{
  "context_servers": {
    "browser-act-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/browser-act/skills",
          "~/.claude/skills/browser-act"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add browser-act-skill -- git clone https://github.com/browser-act/skills ~/.claude/skills/browser-act

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

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

استخدامات عملية: browser-act skills

استخراج قائمة مُكتَّبة من تطبيق SPA ثقيل بـ JS

👤 المطورون الذين يحتاجون بيانات لمرة واحدة من مواقع بدون APIs ⏱ ~25 min intermediate

متى تستخدمه: الموقع يُصيّر البيانات المطلوبة فقط بعد تنفيذ JS؛ الجلب العادي لا يُعيد شيئاً.

المتطلبات الأساسية

المهارة مثبّتة — git clone https://github.com/browser-act/skills ~/.claude/skills/browser-act

الخطوات

تعريف المخطط

Use browser-act. Schema: items[]{title:str, price:number, available:bool}.✓ تم النسخ

→ تم قبول المخطط
الزيارة والاستخراج

Open <url>; wait for the product grid; extract matching the schema.✓ تم النسخ

→ قائمة JSON مُكتَّبة
التحقق من الحالات الشاذة

Spot-check 3 random rows by re-fetching their detail page; check parsing is correct.✓ تم النسخ

→ اجتياز الفحوصات أو اكتشاف خطأ في المحلل

النتيجة: بيانات مُكتَّبة موثوقة دون نقر يدوي.

المزالق

الموقع يحجب الوصول بعد 50 طلباً بسبب كشف الروبوتات — تقليل التزامن، تدوير UA، احترام robots.txt أو تخطي المهمة

اجمعها مع: filesystem

التنقل في نموذج متعدد الخطوات للوصول إلى البيانات خلفه

👤 المطورون الذين يستخرجون بيانات خلف تسجيل الدخول أو المعالجات ⏱ ~40 min intermediate

متى تستخدمه: مجموعة بيانات عامة مخفية خلف تدفق «اختر الدولة ← اختر السنة ← انقر عرض».

الخطوات

تخطيط التدفق

Use browser-act. Steps: pick country=US, year=2025, click 'View'. Then extract the table.✓ تم النسخ

→ تم قبول خطة التدفق
التنفيذ

Run the flow for 50 country/year combinations.✓ تم النسخ

→ صفوف مُكتَّبة لجميع الـ 50
الحفظ

Write each combo to /data/<country>-<year>.json.✓ تم النسخ

→ ملفات في /data/

النتيجة: بيانات ضخمة خلف واجهات النقر دون جهد يدوي.

المزالق

التدفق ينكسر عندما يضيف الموقع خطوة أو يعيد تسمية زر — المهارة تلاحظ وتتوقف مؤقتاً؛ أعد تسجيل التدفق مرة واحدة فقط لا 50 مرة

اجمعها مع: filesystem

مراقبة صفحة للتغييرات والتنبيه

👤 أي شخص يراقب صفحة حالة أو متتبع التوفر ⏱ ~15 min beginner

متى تستخدمه: تريد معرفة متى يُفتح موعد، أو تنخفض سعر، أو يُحدَّث مستند.

الخطوات

تعريف المراقبة

Use browser-act. Watch <url> selector '.availability-banner' every 10 minutes. Alert if text changes.✓ تم النسخ

→ المراقبة نشطة
تعريف مسار التنبيه

Alert via: write to ~/inbox/alerts.txt + notify webhook https://<my-webhook>.✓ تم النسخ

→ عند التغيير يتم إطلاق كليهما

النتيجة: مراقبة إشارة محددة بدون تدخل يدوي.

المزالق

المراقبة المفرطة تؤدي إلى الحجب — الالتزام بفترات ≥5 دقائق على معظم المواقع؛ احترام استجابات 429

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

browser-act-skill + filesystem

حفظ البيانات المستخرجة في مسارات منظمة

Save extraction outputs to /data/<source>/<date>.json with provenance metadata.✓ تم النسخ

browser-act-skill + duckduckgo-mcp

إيجاد الصفحات أولاً عبر البحث ثم استخراج البيانات المنظمة

Search via duckduckgo-mcp for the data source; pass the URL into browser-act for typed extraction.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداة	المدخلات	متى تستدعيها	التكلفة
extract_typed	url, schema, wait_for?	سحب بيانات منظمة من صفحة	Browser run + LLM tokens
run_flow	steps[], schema?	التنقل متعدد الخطوات	Multi-step browser cost
watch	url, selector, interval, action	كشف التغييرات طويلة الأمد	Per-poll cost
screenshot	url, full_page?	تصحيح الأخطاء البصرية	Browser run

التكلفة والحدود

تكلفة التشغيل

حصة API: يعتمد على المزود؛ بعض التدفقات مجانية مع المتصفح المدمج
الرموز لكل استدعاء: الاستخراج الموجّه بالمخطط أرخص من التقاط الشاشة والتفكير الخام
التكلفة المالية: المهارة مجانية؛ رموز LLM للاستخراج
نصيحة: مرّر دائماً مخططاً — الاستخراج غير الموجّه يهدر الرموز على الضوضاء

الأمان

الصلاحيات والأسرار ونطاق الأثر

الحد الأدنى من الصلاحيات: Outbound HTTPS

تخزين بيانات الاعتماد: عند تسجيل الدخول لموقع، الأسرار عبر متغيرات البيئة؛ قم بتدويرها بعد عمليات الاستخراج لمرة واحدة

نقل البيانات الخارجي: المواقع المستهدفة + مزود LLM

لا تمنح أبدًا: Persistent login tokens stored in the skill's workspace

احترم robots.txt وشروط الاستخدام للمواقع المستهدفة؛ المهارة أداة وليست ترخيصاً لتجاهل السياسة

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

الاستخراج يُعيد نتيجة فارغة

أطل وقت انتظار المحدد؛ قد يُحمّل الموقع البيانات بعد تأخير أو عبر XHR بعد النقر

تحقق: Use screenshot tool to verify page state

الموقع يكشف الروبوت

تقليل التزامن، تدوير UA، النظر في ما إذا كان الموقع يسمح بالاستخراج

عدم تطابق المخطط

إرخاء الأنواع (string مقابل number)؛ قد يكسر تنسيق الموقع الأنواع الصارمة

Watch يطلق باستمرار على التغييرات الشكلية

تضييق المحدد؛ أو التبديل من HTML diff إلى diff نصي

البدائل