الاستيراد الجماعي

طريقتان لتغطية العديد من الصفحات دفعة واحدة: استيراد ملف CSV يحتوي على روابط كمراقبين، أو إضافة خريطة موقع (sitemap) ودع Page Deltas يراقبها بحثاً عن الروابط المنشورة حديثاً.

استيراد CSV (في التطبيق)

من لوحة التحكم، انقر على استيراد CSV، اختر ملفك، ثم استيراد المراقبين. يتم التحقق من كل صف؛ يتم إنشاء المجموعة الصالحة معاً، وأي صفوف متخطاة تدرج مرة أخرى مع السبب لتتمكن من إصلاحها وإعادة تحميلها. تحتاج إلى وصول محرر أو مسؤول.

استيراد CSV (عبر API)

نفس التدفق متاح برمجياً. أرسل نموذجاً متعدد الأجزاء (multipart form) بحقل file واحد يحتوي على ملف CSV الخاص بك إلى /api/monitors/import، مصادقاً باستخدام رمز Bearer.

curl -X POST https://api.pagedeltas.com/api/monitors/import \
  -H "Authorization: Bearer $PAGEDELTAS_TOKEN" \
  -F "[email protected]"

تُبلغ استجابة JSON بما حدث:

{
  "created": 2,
  "skipped": 1,
  "errors": [
    { "row": 4, "url": "notaurl", "reason": "invalid URL" }
  ]
}

صيغة CSV

مطلوب صف رأس (أسماء الأعمدة غير حساسة لحالة الأحرف؛ يُسمح بـ UTF-8 BOM). الأعمدة المعترف بها:

العمود	مطلوب	ملاحظات
`url`	نعم	الرابط الكامل متضمناً البروتوكول (scheme). يتم تحديد الروابط المكررة.
`description`	لا	ملاحظة بلغة طبيعية تصف الصفحة وما يهمك فيها.
`filter_prompt`	لا	تعليمات صريحة اختيارية لفلتر LLM. انظر الفلاتر.

لا يوجد عمود frequency — تتم جدولة الفحوصات بشكل تكيفي (انظر كيف تعمل المراقبة). يتم تجاهل أي أعمدة غير معترف بها.

مثال:

url,description,filter_prompt
https://competitor.com/pricing,"Competitor pricing page","Alert on plan or price changes; ignore copy tweaks"
https://competitor.com/changelog,"Product changelog","Alert on new release entries only"
https://example.com/careers,"Engineering careers page","Alert on new senior+ roles"

مراقبة خريطة الموقع

تنشر العديد من المواقع ملف sitemap.xml يسرد الروابط العامة الخاصة بها. أضف واحداً من قسم مراقبة خريطة الموقع (أو POST /api/sitemap-monitors) وسيقوم Page Deltas بتتبع مجموعة الروابط التي يحتوي عليها. عندما تكتسب خريطة الموقع روابط جديدة، تتلقى تنبيهاً يسردها — حتى تعرف عن الصفحات المنشورة حديثاً دون مراقبة الموقع يدوياً.

لإضافة خرائط مواقع متعددة دفعة واحدة، استخدم استيراد CSV في صفحة مراقبة خريطة الموقع (أو POST /api/sitemap-monitors/import بحقل file متعدد الأجزاء). يحتاج ملف CSV إلى عمود sitemap_url واحد (يُقبل أيضاً عمود url عادي)؛ يتم التحقق من كل صف وتحصل على نفس النتيجة لكل صف كما في مستورد المراقبين أعلاه.