دليل التثبيت والإعداد الشامل

تتكامل منصة SmallPict بسلاسة مع كافة البنى التحتية الحديثة للويب: من مواقع WordPress التقليدية إلى تطبيقات JAMstack وأنظمة وكلاء الذكاء الاصطناعي المستقلة.

خيارات التثبيت

1. إضافة WordPress

1. حمّل أحدث إصدار ZIP من لوحة التحكم أو ابحث عن SmallPict في دليل إضافات WordPress (wp-admin > إضافات > أضف جديد).
2. انقر على التنصيب الآن ثم تفعيل.
3. انتقل إلى قائمة SmallPict في الشريط الجانبي.
4. الصق مفتاح واجهة برمجة التطبيقات sp_wp_....
5. اختر صيغة الإخراج واحفظ الإعدادات: WebP في خطة Free، وWebP أو AVIF (صيغة واحدة) في Starter، وAVIF مع بديل WebP في Pro وBusiness. سيتم تحسين الصور المرفوعة لاحقًا تلقائيًا.

2. منظومة حزم SDK السبع

ثبّت الحزمة البرمجية الأصلية عبر مدير الحزم المفضل لديك:

# Node.js & TypeScriptnpm install @smallpict/sdk
# Golanggo get github.com/tuxnoob/smallpict-go
# Pythonpip install smallpict
# PHP (Composer)composer require smallpict/smallpict-php
# Rust (Cargo)cargo add smallpict
# Ruby (Bundler)gem install smallpict

3. التكامل المباشر عبر REST API

في حال استخدام لغات ليس لها حزمة رسمية مخصصة (مثل C#, Swift, Elixir)، يمكنك استدعاء نقاط النهاية مباشرة:

curl -X POST https://api.smallpict.app/v1/optimize \  -H "X-API-Key: sp_sdk_9a8b7c6d5e4f..." \  -H "X-Timestamp: 1716301234" \  -H "X-Signature: 3a9f8b2c4d6e8a..." \  -H "Content-Type: application/json" \  -d {  "filename": "hero.jpg",  "mime_type": "image/jpeg",  "filesize": 2508800,  "options": {    "format": "avif",    "quality": 80,    "max_width": 1920  }}'

4. إعداد بروتوكول MCP لوكلاء الذكاء الاصطناعي

في بيئات Claude Desktop أو Cursor أو أي بيئة تدعم بروتوكول MCP:

{  "mcpServers": {    "smallpict": {      "command": "npx",      "args": [        "-y",        "@smallpict/mcp"      ],      "env": {        "SMALLPICT_API_KEY": "sp_sdk_your_api_key_here"      }    }  }}