دليل
كيف تحول أي موقع ويب إلى واجهة برمجة تطبيقات (API) للتغييرات
معظم الصفحات التي تهمك لن تطلق واجهة برمجة تطبيقات (API) رسمية أبداً. أسعار المنافسين، ملفات PDF لشروط خدمة الموردين، مؤشرات الجهات التنظيمية، سجلات تغييرات الشركاء: البيانات موجودة في كود HTML مباشرة، لكن لا يوجد نقطة نهاية (Endpoint) يمكنك استدعاؤها. لديك ثلاثة خيارات واقعية: بناء أداة كشط (Scraper) بنفسك وتحمل الأعطال المتكررة؛ أو الدفع لواجهة كشط برمجي لاستخراج الصفحة بأكملها عند الطلب؛ أو تحويل الصفحة إلى موجز تغييرات: مراقب يتابع الصفحة بدلاً منك ويرسل بيانات JSON فقط عندما يحدث تغيير حقيقي يستحق الاهتمام. هذا المقال يشرح المسار الثالث بالكامل، من البداية إلى النهاية، باستخدام Page Deltas.
خطة مجانية · 10 عناوين URL أو خرائط مواقع تحت المراقبة · عمليات فحص غير محدودة (بأفضل جهد) · تصفية وملخصات بالذكاء الاصطناعي · واجهة برمجة تطبيقات REST وMCP وخطافات ويب موقعة في جميع الخطط · لا يتطلب بطاقة ائتمان
{
"event": "sitemap.new_urls",
"monitor": "https://www.hubspot.com/sitemap.xml",
"detected_at": "2026-06-15T19:30:00Z",
"new_urls": [
"https://www.hubspot.com/case-studies/workleap",
"https://www.hubspot.com/products/artificial-intelligence/use-cases/sales-meeting-prep-and-follow-up",
"https://www.hubspot.com/email-signature-generator/create-rules-gmail"
]
}كاشط مخصص vs واجهة برمجة تطبيقات للكشط vs موجز التغييرات
قاعدة عملية صريحة: إذا كنت بحاجة إلى آلاف الصفحات كمجموعة بيانات ضخمة، فاستخدم واجهة برمجة تطبيقات للكشط. أما إذا كنت تريد معرفة متى تتغير صفحة عامة واحدة وفقاً لمعايير محددة، فإن موجز التغييرات يتطلب كوداً برمجياً أقل بكثير وجهداً أدنى في الصيانة.
كاشط ذاتي الصنع (DIY Scraper)
ما تحصل عليه: كود HTML خام تقوم بتحليله بنفسك. الأفضل للتحكم الكامل في المواقع المعقدة. الجهد المبذول مرتفع للغاية (محددات العناصر، خوادم الوكيل، معالجة العرض، إعادة المحاولة). عندما يعاد تصميم الموقع، يتعطل المحلل البرمجي في صمت. تعتمد حداثة البيانات على وقت تشغيل مهام cron المجدولة. التكلفة المعتادة: البنية التحتية بالإضافة إلى وقتك الثمين.
واجهة برمجة تطبيقات للكشط (Scraping API)
ما تحصل عليه: استخراج بيانات منظمة لكل طلب. الأفضل لاستخراج كميات هائلة من الصفحات دفعة واحدة. الجهد منخفض إلى متوسط. يمتص المزود معظم تغييرات تخطيط الصفحات. البيانات محدثة فقط في لحظة استدعائك للواجهة. التكلفة المعتادة: أرصدة تُخصم لكل طلب استدعاء.
موجز التغييرات (هذا الدليل)
ما تحصل عليه: حدث بتنسيق JSON مصحوباً بملخص من الذكاء الاصطناعي عند حدوث تغيير ذي مغزى. الأفضل لسيناريو "أخبر نظامي عندما تتغير هذه الصفحة". الجهد ضئيل للغاية: إنشاء مراقب واحد، ثم استخدام خطاف ويب أو الاستعلام الدوري. استخراج المحتوى وتوجيهات نموذج اللغة يحددان معاً ما هو مهم. فحوصات متكيفة وإرسال فوري إلى نقطة النهاية الخاصة بك عند التطابق. التسعير بحسب عدد عناوين URL المراقبة في خطتك (لا يتم حساب الفحوصات في Page Deltas).
ما ستقوم ببنائه
عنوان URL الأساسي: https://api.pagedeltas.com. تقع جميع نقاط النهاية تحت /api. وتكون الردود الناجحة بتنسيق JSON.
الحساب ومفتاح API
أنشئ منظمة مجانية في Page Deltas وأنشئ مفتاح API.
مراقب مع موجز تعليمات
أنشئ مراقباً على عنوان URL عام مع موجز باللغة الطبيعية (الفلتر).
استعلام دوري أو خطاف ويب (Webhook)
استعلم دورياً عن GET /api/monitors/{id}/changes، أو اربط قناة خطاف ويب عامة لتقوم كل مطابقة بإرسال JSON موقّع عبر طلب POST إلى تطبيقك.
تكامل اختياري مع بروتوكول MCP
اربط نفس المفتاح مع Claude أو Cursor أو VS Code عبر بروتوكول MCP.
الإعداد: تحويل صفحة إلى موجز تغييرات
خمس خطوات من إنشاء مفتاح API إلى استلام خطاف ويب موقّع. يفضل استخدام خطاف الويب عندما تريد دفع البيانات تلقائياً (Push) بدلاً من الاستعلام الدوري (Pull).
إنشاء حساب ومفتاح API
سجل عبر pagedeltas.com/register. لا يلزم وجود بطاقة ائتمان. الخطة المجانية: 10 عناوين URL أو خرائط مواقع تحت المراقبة، وفحوصات غير محدودة (بأفضل وتيرة ممكنة)، وتصفية وملخصات بالذكاء الاصطناعي، وعدد غير محدود من أعضاء الفريق، وقنوات Slack / Discord / Teams / البريد الإلكتروني / خطافات ويب موقعة، وسجل محفوظ لمدة 14 يوماً، ودعم واجهة برمجة تطبيقات REST وبروتوكول MCP. داخل التطبيق: Settings ← API keys (بصلاحية editor أو admin). أنشئ مفتاحاً وانسخه على الفور؛ فلن يظهر إلا مرة واحدة. export PAGEDELTAS_TOKEN="pdt_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx". نطاق المفاتيح يتبع المنظمة وتعمل بصلاحيات المشرف داخلها. وهي غير مرتبطة بعضو محدد، لذا فإن إزالة عضو من الفريق لا تلغي المفتاح. احذف المفتاح لقطع الوصول. تعامل معه ككلمة مرور: ضعه في متغيرات البيئة أو في خزينة آمنة للبيانات السرية، ولا تقم أبداً بإيداعه في ملفات التكوين الخاصة بمستودع الكود.
إنشاء مراقب (cURL)
أرسل طلب POST إلى https://api.pagedeltas.com/api/monitors مع ترويسة Authorization: Bearer $PAGEDELTAS_TOKEN وجسم JSON يحتوي على: url، وnl_description (موجز التعليمات)، وfilter_prompt اختياري، وchannel_ids: []. مثال لموجز التعليمات: "صفحة تسعير المنافس. أرسل تنبيهاً عندما يتغير سعر أي خطة، أو تتم إضافة خطة أو إزالتها، أو تتغير الحصص والحدود. تجاهل لافتات ملفات تعريف الارتباط، وتخطيطات اختبارات A/B، وآراء العملاء الدوارة." لا يوجد حقل لتحديد تكرار الفحص؛ فالوتيرة متكيفة وتلقائية (تُفحص الصفحات النشطة بوتيرة أعلى، والصفحات الهادئة بوتيرة أقل؛ وتحصل الخطط المدفوعة على أولوية في الفحص). استخدم POST /api/monitors/{id}/check-now لإجراء فحص فوري عند الطلب (محدد بمعدل طلب واحد لكل دقيقة لكل مراقب). يُعد nl_description هو الموجز الذي يعتمد عليه نموذج الذكاء الاصطناعي لتحديد ما إذا كان التغيير مهماً أم لا. التوجيهات الغامضة ستحول خطاف الويب الخاص بك إلى سيل مستمر من الفروق البصرية غير المفيدة. معلمات اختيارية: filter_prompt وcss_selector وxpath_selector وis_pdf وchannel_ids (تجاوز القنوات لكل مراقب؛ اتركه فارغاً لاستخدام إعدادات المنظمة الافتراضية). مخصص للويب العام فقط؛ الصفحات المحمية بتسجيل دخول غير مدعومة حالياً. تعد مراقبة خرائط المواقع مورداً منفصلاً (/api/sitemap-monitors) عندما تكون المهمة هي معرفة "هل ظهر عنوان URL جديد كلياً؟" بدلاً من "هل تمت إعادة كتابة هذه الصفحة؟"
الاستعلام الدوري عن موجز التغييرات
أرسل طلب GET إلى https://api.pagedeltas.com/api/monitors/{id}/changes?limit=50 مع رمز Bearer. تُعرض أحدث التغييرات أولاً (الافتراضي 50، والحد الأقصى 100). لا يوجد مؤشر تنقل (Cursor)؛ تتبع أحدث طابع زمني لـ detected_at قمت بمعالجته بالفعل. يتضمن كل تغيير كلاً من id وdetected_at وsummary: وهو وصف واضح مصاغ بالذكاء الاصطناعي لما طابق موجز التعليمات، وليس مجرد فرق HTML خام. يمكنك تمرير summary مباشرة إلى Slack أو تذكرة دعم أو وكيل برمجيات آخر.
نفس عملية الإنشاء والاستعلام في Python
استخدم مكتبة requests مع ترويسات Authorization Bearer وContent-Type application/json. أرسل طلب POST إلى /api/monitors يتضمن url وnl_description وchannel_ids: []. اقرأ monitor["id"] من الاستجابة. ثم أرسل طلب GET إلى /api/monitors/{monitor_id}/changes مع limit=50 واطبع detected_at وsummary لكل تغيير. نفذ ذلك وفق جدول زمني محدد إذا كان يتعين عليك استخدام الاستعلام الدوري. يفضل استخدام خطاف الويب عندما تريد دفع البيانات تلقائياً.
تجاوز الاستعلام الدوري، واستقبل JSON فورياً (خطافات ويب موقعة بـ HMAC)
داخل التطبيق: Channels ← Add a channel ← Generic webhook. الصق عنوان URL لجهاز الاستقبال بتقنية HTTPS. انسخ سر القناة (Channel Secret) فور ظهوره (يُعرض لمرة واحدة فقط). انقر على Send test. أو أنشئ القناة عبر واجهة برمجة التطبيقات (POST /api/alert-channels)، ثم اربطها بـ PUT /api/monitors/{id}/alert-channels، أو اترك channel_ids فارغاً ليستخدم المراقب الإعدادات الافتراضية للمنظمة. يقوم كل تغيير مطابق بإرسال طلب POST ببيانات JSON مسطحة إلى عنوان URL الخاص بك مع ترويسة Content-Type application/json وترويسة X-Signature: sha256=<hex>. تتضمن الحقول: event (change.detected) وmonitor_id وmonitor_url وmonitor_name وchange_id وdetected_at وsummary وbefore_screenshot_url وafter_screenshot_url وdashboard_url. تحقق من X-Signature عبر حساب HMAC-SHA256 لنص الطلب الخام باستخدام سر قناتك (صيغة الترويسة sha256=<hex>). احسب الهاش على البايتات الدقيقة قبل تحليل JSON، وإلا ستفشل عملية التحقق. قد تتم إضافة حقول جديدة مستقبلاً: تجاهل المفاتيح غير المعروفة. ملاحظات التسليم: تقتصر المحاولة الحالية على محاولة تسليم واحدة لكل قناة لكل تنبيه (دون إعادة محاولة تلقائية)، لذا استجب بسرعة وتعامل مع التكرارات بطريقة متطابقة الفعالية (Idempotent). الأخطاء غير التابعة لـ 2xx أو أخطاء الشبكة تسجل فشل التسليم؛ ولا يتم إيقاف المراقب نفسه بسبب فشل التسليم. تتم مراجعة وتوثيق كل محاولة على الخادم. لتنبيه أعضاء الفريق بدلاً من الأنظمة، استخدم قنوات Slack أو Discord أو Teams أو البريد الإلكتروني بنفس الطريقة. دليل إعداد Slack متاح في "كيفية تلقي تنبيهات تغييرات مواقع الويب في Slack".
اختياري: إدارة المراقبين عبر Claude أو Cursor أو VS Code (MCP)
باستخدام مفتاح API نفسه. نقطة نهاية MCP عبر HTTP تدعم التدفق المباشر: https://api.pagedeltas.com/mcp. تحصل وكلاء الذكاء الاصطناعي على أدوات مثل create_monitor وlist_monitor_changes وcreate_alert_channel ومساعدات خرائط المواقع. جلسات ملفات تعريف الارتباط غير مقبولة على MCP. يُفضل استخدام قناة خطاف ويب للأنظمة المعتمدة على الأحداث والتي لا ينبغي لها الاستعلام دورياً.
ملف Cursor mcp.json
في ~/.cursor/mcp.json، اضبط mcpServers.pagedeltas.url على https://api.pagedeltas.com/mcp وheaders.Authorization على Bearer pdt_xxxxxxxx. أعد تشغيل Cursor حتى تظهر الأدوات.
نماذج برمجية كاملة للعملاء
تتوفر إرشادات الربط لـ Claude Code وVS Code وClaude Desktop عبر mcp-remote في وثائق MCP.
وثائق MCP →موجز التعليمات الخاص بك هو لغة الاستعلام
في واجهة برمجة تطبيقات REST المعتادة، تقوم بالتصفية عبر معلمات الاستعلام. في موجز التغييرات، تكون التصفية عبر موجز التعليمات باللغة الطبيعية والمحدد على المراقب. يستخرج Page Deltas الصفحة، ويقارنها بآخر فحص، ويسأل نموذج اللغة عما إذا كان الفرق يطابق تعليماتك. تصل التنبيهات المطابقة مع ملخص مكتوب ولقطات شاشة قبل وبعد التغيير. اكتب الموجز تماماً كما لو كنت تقدم إرشادات لزميل في الفريق.
الأسعار
تغير سعر إحدى الخطط أو ظهرت فئة اشتراك جديدة.
المناقصات / طلبات العروض (RFP)
طرحت مناقصة جديدة تقع ضمن نطاق عملنا.
وثائق واجهة برمجة التطبيقات (API)
أضافت وثائق API نقطة نهاية جديدة، أو حذفت نقطة، أو أعلنت إيقاف دعم نقطة ما.
التوظيف
تم نشر وظيفة مهندس برمجيات أول؛ مع تجاهل الوظائف غير الهندسية.
دليل المراقبة الشامل
نفس المنهج المتبع في دليلنا العام للمراقبة ودليل المرشحات والأوصاف.
كيفية مراقبة تغييرات مواقع الويب →الحصص المهمة حقاً (وتلك التي لا تهم)
في Page Deltas، الحد الذي تبني عليه خطتك هو عدد عناوين URL (أو خرائط المواقع) التي تراقبها، وليس حصة فحص شهرية. لا توجد رسوم إضافية على نقاط نهاية القراءة والكتابة لواجهة برمجة التطبيقات طالما كان الاستخدام في الحدود المعقولة. الاستثناء الوحيد هو check-now: طلب واحد في الدقيقة لكل مراقب (يرجع الخطأ 429 مع ترويسة Retry-After عند تجاوزه). يؤدي الوصول إلى الحد الأقصى لعناوين URL في خطتك إلى إرجاع الرمز 422 موضحاً العدد الحالي والحد الأقصى. الأدوات التقليدية التي تحاسبك على عدد الفحوصات تجبرك على إجراء حسابات معقدة ("فحص صفحة واحدة كل ساعة ≈ 720 فحصاً شهرياً"). هنا، تختار الصفحات وتكتب الموجز، والوتيرة تتكيف تلقائياً.
Free
10 عناوين URL مراقبة · سجل محفوظ لـ 14 يوماً · فحوصات غير محدودة (بأفضل وتيرة)، ذكاء اصطناعي، API، بروتوكول MCP، وجميع قنوات التنبيه الخمس · $0
Starter
150 عنوان URL مراقب · سجل محفوظ لـ 30 يوماً · 29 دولاراً شهرياً · أولوية في الفحص
Pro
1,000 عنوان URL مراقب · سجل محفوظ لـ 90 يوماً · 79 دولاراً شهرياً
Business
5,000 عنوان URL مراقب · سجل محفوظ لـ 365 يوماً · 199 دولاراً شهرياً
Scale
20,000 عنوان URL مراقب · سجل محفوظ لـ 730 يوماً · 499 دولاراً شهرياً
Enterprise
عدد مخصص من عناوين URL وفترة حفظ السجل · تسجيل دخول موحد (SSO) / SCIM
كيف يختلف هذا عن واجهة برمجة تطبيقات من نوع Visualping
تعتمد مقالات Visualping الموجهة للمطورين على فترات زمنية ثابتة، وتحديد النطاق الاختياري عبر CSS/XPath، وحصة فحص شهرية محددة، وحمولة خطاف ويب كبيرة تدور حول الفروق البصرية وأعلام الأهمية. يناسب ذلك عندما تكون المهمة هي: "أرسل إشعاراً بمجرد تحرك البكسلات، ودع كودي يحدد الباقي". أما Page Deltas فقد صُممت لـ: "أيقظ نظامي فقط عندما يطابق التغيير هذا الموجز". هذا المقال هو دليل الربط التقني؛ والمقارنة التفصيلية خطة بخطة متوفرة في Page Deltas مقابل Visualping.
الأولوية لموجز التعليمات باللغة الطبيعية
الفلتر الأساسي هو موجز التعليمات. المحددات البرمجية اختيارية وليست إلزامية.
وتيرة فحص متكيفة
لا داعي لتحديد فترات زمنية يدوياً. تُفحص الصفحات النشطة بوتيرة أسرع، والصفحات الهادئة بوتيرة أقل.
حمولة خطاف ويب مسطحة وموجزة
تتمحور حول ملخص التغيير (summary)، وعناوين لقطات الشاشة، وترويسة HMAC X-Signature.
فحوصات غير محدودة؛ والدفع مقابل عدد الروابط
تتضمن كل خطة فحوصات غير محدودة. أنت تدفع فقط مقابل عدد عناوين URL التي تراقبها.
بروتوكول MCP بنفس المفاتيح
يستخدم بروتوكول MCP نفس مفاتيح API الخاصة بواجهة REST تماماً.
حدود الخدمة بكل شفافية
تعرف بوضوح على ما يقدمه موجز التغييرات وما لا يقدمه قبل دمجه في أنظمة الإنتاج لديك.
الصفحات العامة فقط
المواقع التسويقية، ملفات PDF العامة، بوابات التوظيف المفتوحة، وخرائط المواقع العامة. البوابات التي تتطلب تسجيل الدخول مدرجة في خطة التطوير المستقبلية لكنها غير متوفرة اليوم.
ليست أداة لاختبار الانحدار البصري أو كشف التشويه
إذا كانت المهمة هي "هل تحرك هذا البكسل 20px"، فإن أدوات الفروق البصرية المتخصصة تظل هي الأنسب.
لا تراقب أنشطة LinkedIn أو X
تراقب Page Deltas الويب المفتوح. تتبع نشاط الحسابات الفردية على LinkedIn وX مكانه MultiFollow. ومراقبة الإشارات للكلمات الرئيسية عبر منصات التواصل مكانه KWatch.
تسليم خطاف الويب يتم بمحاولة واحدة حالياً
احرص على بناء نقاط نهاية مستقبلة تتسم بتطابق الفعالية (Idempotent).
لا تخمن أسماء حقول الاستجابة
انسخ بنية البيانات من مرجع API المباشر وتجاهل أي مفاتيح JSON غير معروفة.
مرجع API →أدلة ووثائق ذات صلة
إعدادات تفصيلية لفرق العمل على Slack، والبدء السريع بدون كود، والمخططات الحية للواجهة البرمجية.
تنبيهات تغييرات Slack
اربط نفس المراقب بخطاف ويب وارد في Slack لإرسال الإشعارات إلى فريق العمل بدلاً من الأنظمة البرمجية.
كيفية تلقي تنبيهات تغييرات مواقع الويب في Slack →البدء السريع
المسار بدون كود: الصق عنوان URL، واكتب موجز التعليمات، واختر القناة، وانقر على Send test.
البدء السريع →مرجع API
هياكل الطلبات والاستجابات المباشرة. انسخ الحقول من هنا وتجاهل مفاتيح JSON غير المعروفة.
مرجع API →الأسئلة الشائعة
- كيف يمكنني الحصول على بيانات من موقع ويب ليس لديه واجهة برمجة تطبيقات (API)؟
- لديك ثلاثة خيارات: بناء أداة كشط بنفسك، أو استخدام واجهة برمجة تطبيقات للكشط للاستخراج الجماعي، أو توجيه واجهة برمجة تطبيقات لمراقبة التغييرات نحو الصفحة والاستفادة من موجز التغييرات بتنسيق JSON. لتلبية حاجة "إشعار نظامي عند تغير هذه الصفحة"، فإن موجز التغييرات يتطلب عادة أقل قدر من الأكواد: أنشئ مراقباً، ثم اربط خطاف ويب أو استعلم دورياً.
- هل يمكنني إعداد هذا دون كتابة كود برمجي؟
- نعم. أنشئ المراقب في لوحة التحكم، وأضف خطاف ويب عاماً (أو Slack / Teams / Discord / البريد الإلكتروني) من قسم القنوات (Channels)، واكتب موجز التعليمات، ثم انقر على Send test. يوضح دليل البدء السريع الخطوات الخالية من الأكواد.
- ما الفرق بين واجهة برمجة تطبيقات للكشط وواجهة مراقبة التغييرات؟
- تستخرج واجهة الكشط البرمجي محتوى الصفحة بالكامل في كل مرة تستدعيها فيها. بينما تراقب واجهة مراقبة التغييرات الصفحة باستمرار وترسل التغييرات الحادثة فقط، مع ملخص محسوب مسبقاً بالذكاء الاصطناعي. مهام استخراج البيانات العامة تحتاج إلى أدوات كشط، بينما الإجابة عن "هل تغير أي شيء يطابق تعليماتي؟" تتطلب موجز تغييرات.
- هل يكلف الوصول إلى واجهة برمجة التطبيقات أو خطافات الويب رسوماً إضافية؟
- لا. واجهة برمجة تطبيقات REST وبروتوكول MCP وخطافات الويب الموقعة مشمولة في كل خطة، بما في ذلك الخطة المجانية. الاستخدام محكوم فقط بحد أقصى لعدد الروابط المراقبة في خطتك، دون وجود عداد منفصل لرصيد API.
- هل يمكن لوكلاء الذكاء الاصطناعي إنشاء مراقبين نيابة عني؟
- نعم. ما عليك سوى توجيه عميل MCP إلى https://api.pagedeltas.com/mcp باستخدام مفتاح Bearer API. راجع وثائق MCP لمزيد من التفاصيل.
الكاتب
جوليان، مدير المنتجات في Page Deltas. اختر عنوان URL عاماً واحداً تقوم بتحديثه يدوياً بالفعل. أنشئ حساباً مجانياً، وأصدر مفتاح API، وأنشئ المراقب بموجز تعليمات من جملة واحدة، واربط خطاف ويب عاماً، وتحقق من توقيع HMAC مرة واحدة، ثم انتظر أول مطابقة حقيقية. قم بضبط قائمة الاستثناءات بعد أول تنبيه يضم تفاصيل غير ضرورية. هذا هو عادة كل ما يتطلبه إعداد واجهة برمجة تطبيقات التغييرات.
ابدأ بصفحة واحدة كموجز تغييرات
خطة مجانية، دون بطاقة ائتمان. أنشئ حساباً، واستخرج مفتاح API، والصق عنوان URL الذي تتابعه يدوياً، وأضف موجز تعليمات استناداً إلى دليل المرشحات، ثم اختر بين الاستعلام الدوري عن /changes أو استلام بيانات JSON الموقعة عبر طلبات POST إلى نقطة النهاية الخاصة بك.