README.md

---
title: THE Z AI/AGENT
emoji: 🤖
colorFrom: indigo
colorTo: purple
sdk: gradio
sdk_version: 4.44.1
app_file: app.py
pinned: false
---
# غوّاص 🤿 — محرك بحث بسيط

تطبيق ويب بسيط (صفحة واحدة) يبحث في الويب عبر SerpApi، مبني بتصميم مخصص للموبايل.

## المكونات

- `index.html` — الواجهة (المتصفح نفسه، تفتح مباشرة بأي متصفح)
- `app.py` — سيرفر وسيط (Backend) بلغة Python/FastAPI، يشتغل على Hugging Face Spaces
- `requirements.txt` — مكتبات Python المطلوبة للسيرفر
- `Dockerfile` — إعدادات تشغيل السيرفر على Hugging Face

## لماذا يوجد سيرفر وسيط؟

SerpApi لا يسمح بالاتصال المباشر من كود JavaScript في المتصفح (بسبب قيود CORS وحماية مفتاح الـ API). لذلك السيرفر الوسيط يستقبل طلب البحث من الصفحة، يتصل بـ SerpApi بأمان (المفتاح مخفي في السيرفر)، ويرجع النتائج نظيفة للصفحة.

## خطوات التشغيل

### 1. إنشاء حساب SerpApi والحصول على المفتاح
- سجّل حساب في [serpapi.com](https://serpapi.com)
- من لوحة التحكم (Dashboard) انسخ **Your Private API Key**
- الخطة المجانية توفر 100 بحث شهرياً

### 2. رفع السيرفر على Hugging Face Spaces
- أنشئ Space جديد
- اختر SDK: **Docker**
- ارفع الملفات: `app.py`, `requirements.txt`, `Dockerfile`
- من **Settings → Repository secrets** أضف secret جديد:
  - الاسم: `SERPAPI_KEY`
  - القيمة: مفتاحك من SerpApi
- بعد اكتمال البناء (Build) سيكون رابط السيرفر بهذا الشكل:
https://your-username-your-space.hf.space
### 3. ربط الصفحة بالسيرفر
- افتح ملف `index.html` بأي محرر نصوص
- ابحث عن هذا السطر داخل كود JavaScript:
```javascript
const BACKEND_URL = "https://YOUR-USERNAME-YOUR-SPACE.hf.space";