لا تضمينات، لا قاعدة بيانات متجهات، لا واجهات برمجة — فقط Whisper + SQLite FTS5 يعملان على جهازك.

> **خارطة الطريق:** استخراج المقاطع هو الخطوة الأولى نحو التحرير بالفيديو بالكامل بالذكاء الاصطناعي. الإصدارات المستقبلية ستضيف تراكب الموسيقى/الصوت، إعادة مزج الفيديو، تجميع مقاطع متعددة، إعادة تنسيق عمودي لتيك توك/ريلز/شورتس، وشرائط أبرز الأحداث الآلية — وكلها مدفوعة بفهم LLM للمحتوى.

---

### اشتراكات البث المباشر
اشترك في الأخبار، Reddit، Hacker News، قنوات يوتيوب، ملفات تويتر/X، مستودعات GitHub، أوراق arXiv، والبودكاست. يتم جلب المحتوى وتخزينه محليًا في SQLite مع بحث نصي كامل، ويكون متاحًا لـ LLM الخاص بك فورًا.

| الأداة الجديدة | ما تفعله |
|----------|-------------|
| `subscribe` | أضف أي مصدر — آر إس إس الأخبار، Reddit، HN، GitHub، arXiv، يوتيوب، بودكاست، تويتر/X |
| `unsubscribe` | إزالة اشتراك ومحتواه المخزن |
| `list_subscriptions` | عرض جميع الخلاصات النشطة مع عدد العناصر |
| `check_feeds` | استقصاء جميع الاشتراكات، جلب محتوى جديد، نسخ تلقائي لفيديوهات يوتيوب |
| `search_feeds` | بحث نصي كامل عبر كل ما جمعته خلاصاتك |
| `get_feed_items` | تصفح العناصر الحديثة، مصفاة حسب المصدر أو النوع |

**مصادر أخبار مهيأة مسبقًا** — اشترك بكلمة واحدة: `bbc`, `cnn`, `nyt`, `guardian`, `npr`, `aljazeera`, `techcrunch`, `ars`, `verge`, `wired`, `reuters`

**اختصارات arXiv** — `ai`, `ml`, `cv`, `nlp`, `robotics`, `crypto`, `systems`, `hci````
"Subscribe to BBC News, r/LocalLLaMA, and Hacker News"
"Follow @elonmusk on Twitter"
"Subscribe to the YouTube channel @3Blue1Brown"
"Watch anthropics/claude-code on GitHub for new releases"
"Subscribe to the machine learning arXiv category"
"Check my feeds"
"Search my feeds for transformer architecture"
"What's new in my Reddit feeds?"

**لا يوجد تبعيات إضافية للخلاصات.** مبني بالكامل على Python stdlib — SQLite للتخزين، FTS5 للبحث، urllib للجلب، xml.etree للتحليل. YouTube و Twitter يستخدمان متصفح Playwright الموجود. FFmpeg مطلوب لـ `convert_media` (مثبت مسبقًا بشكل شائع).

---

## جميع الأدوات الـ 38 حسب الفئة

### اشتراكات الخلاصات الحية
| الأداة | الوصف |
|------|-------------|
| `subscribe` | الاشتراك في الأخبار، Reddit، HN، GitHub، arXiv، YouTube، البودكاست، Twitter/X |
| `unsubscribe` | إزالة اشتراك ومحتواه المخزن |
| `list_subscriptions` | عرض جميع الاشتراكات النشطة مع عدد العناصر |
| `check_feeds` | جلب محتوى جديد من جميع المصادر أو مصادر محددة |
| `search_feeds` | بحث نصي كامل عبر جميع محتويات الخلاصات المخزنة |
| `get_feed_items` | الحصول على العناصر الحديثة مُرشحة حسب المصدر أو النوع |

### بحث Google والويب
| الأداة | الوصف |
|------|-------------|
| `google_search` | بحث ويب مع مرشحات الوقت، الموقع، الترقيم، اللغة/المنطقة |
| `google_news` | بحث الأخبار مع صور مصغرة للمقالات مضمنة |
| `google_scholar` | أوراق أكاديمية مع الاستشهادات |
| `google_images` | بحث الصور مع عرض النتائج مضمنة في الدردشة |
| `google_trends` | الاهتمام بالموضوع عبر الزمن، الاستعلامات ذات الصلة |
| `visit_page` | جلب أي عنوان URL واستخراج النص القابل للقراءة |

### السفر والتجارة
| الأداة | الوصف |
|------|-------------|
| `google_shopping` | بحث المنتجات مع الأسعار، المتاجر، التقييمات، الصور |
| `google_flights` | بحث الرحلات الجوية مع الأسعار وأوقات السفر |
| `google_hotels` | بحث الفنادق مع الصور، الأسعار، التقييمات، روابط الحجز |
| `google_translate` | الترجمة عبر أكثر من 100 لغة |
| `google_maps` | بحث الأماكن مع التقييمات، المراجعات، ولقطات شاشة الخريطة |
| `google_maps_directions` | اتجاهات الطريق مع خطوة بخطوة ولقطة شاشة للخريطة |

### المالية والمعلومات
| الأداة | الوصف |
|------|-------------|
| `google_finance` | أسعار الأسهم، بيانات السوق، معلومات الشركة |
| `google_weather` | الأحوال الحالية والتوقعات متعددة الأيام |
| `google_books` | بحث الكتب مع المؤلف، ISBN، مقتطفات |

### الرؤية والتعرف الضوئي
| الأداة | الوصف |
|------|-------------|
| `google_lens` | بحث عكسي عن الصور — تحديد الأشياء، المنتجات، المعالم، النص |
| `google_lens_detect` | اكتشاف جميع الأشياء في صورة (OpenCV) وتحديد كل منها عبر Lens |
| `ocr_image` | استخراج النص من الصور محليًا (RapidOCR، بدون اتصال بالإنترنت) |
| `list_images` | عرض ملفات الصور في دليل لاستخدامها مع أدوات الرؤية |

### ذكاء الفيديو والصوت — تحرير الفيديو المدعوم بالذكاء الاصطناعي
| الأداة | الوصف |
|------|-------------|
| `transcribe_video` | تحميل ونسخ أي فيديو مع الطوابع الزمنية (faster-whisper) |
| `transcribe_local` | نسخ ملفات الصوت/الفيديو المحلية (mp3, wav, m4a, mp4, mkv, إلخ.) |
| `search_transcript` | البحث في نص فيديو منسوخ عن مواضيع بواسطة كلمة مفتاحية |
| `extract_video_clip` | استخراج مقطع مدعوم بالذكاء الاصطناعي — أخبر LLM بما تريد وسيقوم بقص الفيديو باستخدام سياق النص |
| `convert_media` | التحويل بين تنسيقات الصوت/الفيديو عبر FFmpeg |

### المستندات والبيانات
| الأداة | الوصف |
|------|-------------|
| `read_document` | استخراج النص من PDF، DOCX، HTML، CSV، JSON، وأكثر من 30 تنسيقًا |

### البريد الإلكتروني
| الأداة | الوصف |
|------|-------------|
| `fetch_emails` | سحب رسائل البريد الإلكتروني عبر IMAP — Gmail، Outlook، Yahoo، iCloud، أي خادم IMAP |

### أدوات الويب
| الأداة | الوصف |
|------|-------------|
| `paste_text` | نشر نص على pastebin والحصول على رابط قابل للمشاركة |
| `shorten_url` | تقصير أي عنوان URL عبر TinyURL |
| `generate_qr` | إنشاء صور رموز QR (عناوين URL، Wi-Fi، جهات اتصال، أي بيانات) |
| `archive_webpage` | أرشفة صفحة ويب على Wayback Machine |
| `wikipedia` | البحث في مقالة ويكيبيديا بأي لغة |

### التخزين السحابي
| الأداة | الوصف |
|------|-------------|
| `upload_to_s3` | رفع الملفات إلى MinIO، AWS S3، DigitalOcean Spaces، Cloudflare R2، Backblaze B2 |

---

## تنسيقات الملفات المدعومة

### المستندات (`read_document`)
| الفئة | التنسيقات |
|----------|---------|
| مستندات | PDF (مع احتياطي OCR للصفحات الممسوحة ضوئيًا)، DOCX |
| ويب | HTML، HTM |
| بيانات | CSV، JSON، XML، YAML، YML، TOML |
| نص | TXT، MD، LOG |
| إعدادات | INI، CFG، CONF، ENV |
| كود | PY، JS، TS، GO، RS، C، CPP، H، JAVA، KT، RB، SQL، R، M، SWIFT |
| شل | SH، BASH، ZSH |

### الصوت والفيديو (`transcribe_local`, `transcribe_video`, `convert_media`)
| الفئة | التنسيقات |
|----------|---------|
| صوت | MP3، WAV، M4A، FLAC، OGG، AAC، WMA، OPUS |
| فيديو | MP4، MKV، WEBM، AVI، MOV |
| خاص | GIF (مخرجات فيديو إلى GIF) |
| إدخال | أي تنسيق يمكن لـ FFmpeg فك تشفيره (مئات التنسيقات) |

### الصور (`google_lens`, `google_lens_detect`, `ocr_image`, `list_images`)
| الفئة | التنسيقات |
|----------|---------|
| قياسي | JPG، JPEG، PNG، GIF، BMP، WEBP |
| احترافي | TIFF، TIF، SVG |
| طرق الإدخال | مسار ملف محلي، عنوان URL عام، base64 (سحب وإفلات في الدردشة) |

---

## لماذا هذا بدلاً من البدائل القائمة على API؟

| | **noapi-google-search-mcp** | خوادم MCP القائمة على API | OpenClaw المدمج |
|---|---|---|---|
| مطلوب مفتاح API | **لا** | نعم (Google CSE API) | نعم (Brave/Perplexity) |
| التكلفة | **مجاني** | مدفوع بعد 100 استعلام/يوم | رسوم API |
| وقت الإعداد | **`pip install` + انطلق** | إنشاء مشروع Cloud، تمكين API، تكوين | مفاتيح API متعددة |
| جودة النتائج | **نتائج Google حقيقية** | محرك بحث مخصص | فهرس Brave |
| صفحات JavaScript | **يعرضها (Chromium)** | لا يمكن عرض JS | لا يمكن عرض JS |
| عدد الأدوات | **38** | 1-3 | 2 (web_search, web_fetch) |
| بحث Google | مدمج (مع مرشحات) | أساسي فقط | غير متوفر |
| Google Shopping | مدمج | غير متوفر | غير متوفر |
| Google Flights | مدمج | غير متوفر | غير متوفر |
| Google Hotels | مدمج | غير متوفر | غير متوفر |
| Google Translate | مدمج | مطلوب API منفصلة | غير متوفر |
| Google Maps | مدمج (مع لقطات شاشة) | غير متوفر | غير متوفر |
| Google Maps Directions | مدمج (مع خريطة الطريق) | غير متوفر | غير متوفر |
| Google Weather | مدمج | غير متوفر | غير متوفر |
| Google Finance | مدمج | غير متوفر | غير متوفر |
| Google News | مدمج | عادة غير متوفر | غير متوفر |
| Google Scholar | مدمج | غير متوفر | غير متوفر |
| Google Books | مدمج | غير متوفر | غير متوفر |
| Google Images | مدمج (مضمن في الدردشة) | مطلوب API منفصلة | غير متوفر |
| Google Lens | مدمج (بحث عكسي عن الصور) | غير متوفر | غير متوفر |
| اكتشاف الأشياء | مدمج (OpenCV + Lens) | غير متوفر | غير متوفر |
| OCR محلي | مدمج (بدون اتصال) | غير متوفر | غير متوفر |
| نسخ الفيديو | مدمج (Whisper محلي) | غير متوفر | غير متوفر |
| استخراج مقطع فيديو | **مدمج (مدعوم بالذكاء الاصطناعي/LLM)** | غير متوفر | غير متوفر |
| خط أنابيب YouTube RAG | **مدمج (اشتراك ← نسخ ← بحث)** | غير متوفر | غير متوفر |
| Google Trends | مدمج | مطلوب API منفصلة | غير متوفر |
| اشتراكات الخلاصات | **مدمج (8 أنواع مصادر)** | غير متوفر | غير متوفر |
| بحث نصي كامل في الخلاصات | **مدمج (SQLite FTS5)** | غير متوفر | غير متوفر |
| نسخ تلقائي للخلاصات | **مدمج (YouTube → Whisper)** | غير متوفر | غير متوفر |
| نسخ ملفات محلية | **مدمج (أي صوت/فيديو)** | غير متوفر | غير متوفر |
| تحويل تنسيق الوسائط | **مدمج (FFmpeg)** | غير متوفر | غير متوفر |
| قارئ مستندات | **مدمج (PDF، DOCX، إلخ.)** | غير متوفر | غير متوفر |
| تكامل البريد الإلكتروني | **مدمج (IMAP)** | غير متوفر | غير متوفر |
| Pastebin | **مدمج** | غير متوفر | غير متوفر |
| تقصير عناوين URL | **مدمج (TinyURL)** | غير متوفر | غير متوفر |
| إنشاء رمز QR | **مدمج (OpenCV)** | غير متوفر | غير متوفر |
| أرشفة الويب | **مدمج (Wayback Machine)** | غير متوفر | غير متوفر |
| ويكيبيديا | **مدمج** | غير متوفر | غير متوفر |
| رفع إلى S3/MinIO | **مدمج** | غير متوفر | غير متوفر |
| جلب الصفحات | مدمج | عادة منفصل | أساسي |

---

## تفاصيل الأدوات والمعلمات

### أدوات اشتراك الخلاصات

#### `subscribe` — إضافة مصدر محتوى

| المعامل | الوصف | مثال |
|-----------|-------------|---------|
| `source_type` | نوع المصدر (مطلوب) | `"news"`, `"reddit"`, `"hackernews"`, `"github"`, `"arxiv"`, `"youtube"`, `"podcast"`, `"twitter"` |
| `identifier` | معرف المصدر (مطلوب) | `"bbc"`, `"LocalLLaMA"`, `"top"`, `"anthropics/claude-code"`, `"ml"`, `"@3Blue1Brown"`, `"https://..."`, `"elonmusk"` |
| `name` | اسم العرض (اختياري) | `"My Custom Feed"` |

**تنسيقات المعرف حسب النوع:**
- **news:** اسم محدد مسبقًا (`bbc`, `cnn`, `nyt`, `guardian`, `npr`, `aljazeera`, `techcrunch`, `ars`, `verge`, `wired`, `reuters`) أو أي عنوان RSS URL
- **reddit:** اسم subreddit (مثل `LocalLLaMA`, `programming`)
- **hackernews:** `top` أو `new` أو `best`
- **github:** `owner/repo` (مثل `anthropics/claude-code`)
- **arxiv:** اختصار (`ai`, `ml`, `cv`, `nlp`, `robotics`, `crypto`) أو فئة مثل `cs.AI`
- **youtube:** مقبض القناة (`@3Blue1Brown`)، عنوان URL، أو معرف القناة (`UCxxxx`)
- **podcast:** عنوان URL لخلاصة RSS
- **twitter:** اسم المستخدم مع أو بدون `@`

#### `check_feeds` — جلب محتوى جديد

| المعامل | الوصف | مثال |
|-----------|-------------|---------|
| `source_type` | قصر على نوع واحد (اختياري) | `"news"`, `"reddit"` |

#### `search_feeds` — بحث نصي كامل

| المعامل | الوصف | مثال |
|-----------|-------------|---------|
| `query` | استعلام البحث (مطلوب) — يدعم FTS5: AND, OR, NOT, "عبارات مقتبسة" | `"machine learning"`, `"GPU NOT NVIDIA"` |
| `source_type` | قصر على نوع واحد (اختياري) | `"news"` |
| `limit` | أقصى عدد للنتائج (الافتراضي 20) | `10` |

#### `get_feed_items` — تصفح العناصر الحديثة

| المعامل | الوصف | مثال |
|-----------|-------------|---------|
| `source` | التصفية حسب اسم المصدر (اختياري) | `"BBC"`, `"LocalLLaMA"` |
| `source_type` | التصفية حسب النوع (اختياري) | `"reddit"`, `"hackernews"` |
| `limit` | أقصى عدد للعناصر (الافتراضي 20) | `10` |

---

### أدوات بحث Google

#### `google_search` — بحث ويب

| المعامل | الوصف | مثال |
|-----------|-------------|---------|
| `query` | استعلام البحث (مطلوب) | `"best python frameworks 2025"` |
| `num_results` | عدد النتائج (1-10، الافتراضي 5) | `5` |
| `time_range` | التصفية حسب الحداثة | `"past_hour"`, `"past_day"`, `"past_week"`, `"past_month"`, `"past_year"` |
| `site` | قصر على نطاق | `"reddit.com"`, `"stackoverflow.com"`, `"github.com"` |
| `page` | صفحة النتائج (1-10، الافتراضي 1) | `2` |
| `language` | رمز اللغة | `"en"`, `"de"`, `"fr"`, `"ja"` |
| `region` | رمز الدولة/المنطقة | `"us"`, `"gb"`, `"de"`, `"jp"` |

#### `google_shopping` — بحث المنتجات

| المعامل | الوصف | مثال |
|-----------|-------------|---------|
| `query` | استعلام بحث المنتج (مطلوب) | `"Sony WH-1000XM5"` |
| `num_results` | عدد النتائج (1-10، الافتراضي 5) | `5` |

#### `google_flights` — بحث الرحلات الجوية

| المعامل | الوصف | مثال |
|-----------|-------------|---------|
| `origin` | مدينة أو مطار المغادرة (مطلوب) | `"New York"`, `"LAX"` |
| `destination` | مدينة أو مطار الوصول (مطلوب) | `"London"`, `"NRT"` |
| `date` | تاريخ المغادرة (اختياري) | `"March 15"` |
| `return_date` | تاريخ العودة (اختياري) | `"March 22"` |

![Google Flights](https://assets.kitploit.com/production/public/readmes/11628/67fb0af7e11f84e8b9504bbe7059412222ac9ae30c6d58d025d7231b8ba71847.png)

#### `google_hotels` — بحث الفنادق

| المعامل | الوصف | مثال |
|-----------|-------------|---------|
| `query` | بحث الفندق مع الموقع (مطلوب) | `"Paris"`, `"Tokyo near Shibuya"` |
| `num_results` | عدد النتائج (1-10، الافتراضي 5) | `5` |

![Google Hotels](https://assets.kitploit.com/production/public/readmes/11628/53a7c43d352a8f2fd9b23b088e7630504018f1b12b27347bdf1f1f6b58b81f89.png)

#### `google_translate` — الترجمة

| المعامل | الوصف | مثال |
|-----------|-------------|---------|
| `text` | النص المراد ترجمته (مطلوب) | `"Hello, how are you?"` |
| `to_language` | اللغة الهدف (مطلوب) | `"Spanish"`, `"Japanese"` |
| `from_language` | اللغة المصدر (اختياري، يتم اكتشافها تلقائيًا) | `"English"` |

#### `google_maps` — بحث الأماكن مع لقطة شاشة للخريطة

| المعامل | الوصف | مثال |
|-----------|-------------|---------|
| `query` | استعلام بحث المكان (مطلوب) | `"pizza near Central Park"` |
| `num_results` | عدد النتائج (1-10، الافتراضي 5) | `5` |

![Google Maps Places Search](https://assets.kitploit.com/production/public/readmes/11628/39e5dd84bee338e82944175aedc0097d3cc8d44d46937f90d43663013ec5c3aa.png)

#### `google_maps_directions` — اتجاهات الطريق مع خريطة

| المعامل | الوصف | مثال |
|-----------|-------------|---------|
| `origin` | موقع البداية (مطلوب) | `"Berlin"` |
| `destination` | موقع النهاية (مطلوب) | `"Munich"` |
| `mode` | وسيلة السفر (الافتراضي "driving") | `"driving"`, `"walking"`, `"transit"`, `"cycling"` |

![Google Maps Directions](https://assets.kitploit.com/production/public/readmes/11628/ef5c209452381347f03f6466093f97f7f22371bf6b8a1fd21f5c6277f94bc98d.png)

#### `google_weather` — الطقس

| المعامل | الوصف | مثال |
|-----------|-------------|---------|
| `location` | المدينة أو الموقع (مطلوب) | `"Dubai"`, `"Tokyo"` |

#### `google_finance` — بيانات الأسهم والسوق

| المعامل | الوصف | مثال |
|-----------|-------------|---------|
| `query` | رمز السهم أو اسم الشركة (مطلوب) | `"AAPL:NASDAQ"`, `"TSLA:NASDAQ"` |

![Google Finance](https://assets.kitploit.com/production/public/readmes/11628/6544467f145bd3721837fe07ebdc54fb6f18c0e16f7b92d3f2dc2a9ecd658946.png)

#### `google_news` — بحث الأخبار

| المعامل | الوصف | مثال |
|-----------|-------------|---------|
| `query` | استعلام بحث الأخبار (مطلوب) | `"AI regulation"` |
| `num_results` | عدد النتائج (1-10، الافتراضي 5) | `5` |

![Google News](https://assets.kitploit.com/production/public/readmes/11628/701222704b96a31e1bbdc17d02faea223a3c5f8c0fafe40f801d2bbf162769ae.png)

#### `google_scholar` — بحث أكاديمي

| المعامل | الوصف | مثال |
|-----------|-------------|---------|
| `query` | استعلام بحث أكاديمي (مطلوب) | `"transformer attention mechanism"` |
| `num_results` | عدد النتائج (1-10، الافتراضي 5) | `5` |

#### `google_books` — بحث الكتب

| المعامل | الوصف | مثال |
|-----------|-------------|---------|
| `query` | استعلام بحث كتاب (مطلوب) | `"machine learning"` |
| `num_results` | عدد النتائج (1-10، الافتراضي 5) | `5` |

#### `google_images` — بحث الصور (مضمن في الدردشة)

| المعامل | الوصف | مثال |
|-----------|-------------|---------|
| `query` | استعلام بحث الصور (مطلوب) | `"sunset over ocean"` |
| `num_results` | عدد النتائج (1-10، الافتراضي 5) | `5` |

![Google Image Search](https://assets.kitploit.com/production/public/readmes/11628/a47d9623012e545b5ec8abbba297822a6cc981a11e3d1a0e5c1548582080aac2.png)

![Google Image Search](https://assets.kitploit.com/production/public/readmes/11628/56ce17724c1807a61362bdbd3d87e0ad510c049f50b49d17050ea08f59d23051.png)

#### `google_trends` — الاتجاهات

| المعامل | الوصف | مثال |
|-----------|-------------|---------|
| `query` | الموضوع (مطلوب) | `"artificial intelligence"` |

---

### أدوات الرؤية والتعرف الضوئي

#### `google_lens` — بحث عكسي عن الصور

تحديد الأشياء، المنتجات، العلامات التجارية، المعالم، والنص. يدعم عناوين URL، الملفات المحلية، وسحب وإفلات base64.

| المعامل | الوصف | مثال |
|-----------|-------------|---------|
| `image_source` | عنوان URL للصورة، مسار ملف، أو base64 (مطلوب) | `"https://example.com/photo.jpg"` أو `"/home/user/image.jpg"` |

![Google Lens Reverse Image Search](https://assets.kitploit.com/production/public/readmes/11628/6b741134ecd8334640efe8b8348169be84471943f64bd367479455510bca6e97.png)

#### `google_lens_detect` — اكتشاف الأشياء + التعرف عليها

اكتشف جميع الأشياء (OpenCV)، قص كل منها، وحددها فرديًا عبر Lens.

| المعامل | الوصف | مثال |
|-----------|-------------|---------|
| `image_source` | مسار ملف محلي أو base64 (مطلوب) | `"/home/user/photo.jpg"` |

#### `ocr_image` — OCR محلي (بدون اتصال)

استخراج النص من الصور باستخدام RapidOCR. لا حاجة للإنترنت.

| المعامل | الوصف | مثال |
|-----------|-------------|---------|
| `image_source` | مسار ملف محلي أو base64 (مطلوب) | `"/home/user/screenshot.png"` |

![Local OCR](https://assets.kitploit.com/production/public/readmes/11628/f9c9a531abd64ce577d3cf9990b8187063828f83762a2e2ac2aaa5a232b21eb7.png)

#### `list_images` — اكتشاف الصور

| المعامل | الوصف | مثال |
|-----------|-------------|---------|
| `directory` | المجلد المراد مسحه (الافتراضي `~/lens/`) | `"/home/user/photos"` |

---

### أدوات ذكاء الفيديو

#### `transcribe_video` — نسخ الفيديو

تحميل ونسخ أي فيديو YouTube (أو عنوان URL فيديو) مع الطوابع الزمنية باستخدام faster-whisper.

| المعامل | الوصف | مثال |
|-----------|-------------|---------|
| `url` | عنوان URL لـ YouTube أو فيديو (مطلوب) | `"https://youtube.com/watch?v=..."` |
| `model_size` | حجم نموذج Whisper (الافتراضي: tiny) | `"tiny"`, `"base"`, `"small"`, `"medium"`, `"large"` |
| `language` | رمز اللغة (اختياري، يتم اكتشافه تلقائيًا) | `"en"` |

#### `search_transcript` — بحث في النص المنسوخ

| المعامل | الوصف | مثال |
|-----------|-------------|---------|
| `url` | نفس عنوان URL المستخدم مع transcribe_video (مطلوب) | `"https://youtube.com/watch?v=..."` |
| `query` | كلمة مفتاحية أو عبارة (مطلوب) | `"memory bandwidth"` |
| `context_segments` | المقاطع المحيطة (الافتراضي: 2) | `3` |

#### `extract_video_clip` — استخراج مقطع حسب الموضوع

اطلب "استخرج الجزء عن X" وسيجد LLM الطوابع الزمنية من النص ويقص المقطع.

| المعامل | الوصف | مثال |
|-----------|-------------|---------|
| `url` | عنوان URL لـ YouTube أو فيديو محلي (مطلوب) | `"https://youtube.com/watch?v=..."` |
| `start_seconds` | وقت البداية بالثواني (مطلوب) | `150` |
| `end_seconds` | وقت النهاية بالثواني (مطلوب) | `315` |
| `buffer_seconds` | ثوانٍ إضافية قبل/بعد (الافتراضي: 3) | `5.0` |
| `output_filename` | اسم ملف مخصص (اختياري) | `"hardware_overview"` |

---

## نماذج أوامر

### اشتراكات الخلاصات
| ما تكتبه | الأداة المستخدمة |
|--------------|-------------|
| *"اشترك في BBC News و CNN"* | `subscribe` |
| *"تابع r/LocalLLaMA على Reddit"* | `subscribe` |
| *"راقب قصص Hacker News الأعلى"* | `subscribe` |
| *"تابع anthropics/claude-code للإصدارات الجديدة"* | `subscribe` |
| *"اشترك في @3Blue1Brown على YouTube"* | `subscribe` |
| *"تابع @elonmusk على Twitter"* | `subscribe` |
| *"اشترك في فئة arXiv للتعلم الآلي"* | `subscribe` |
| *"تحقق من خلاصاتي"* | `check_feeds` |
| *"ما الجديد في اشتراكاتي؟"* | `check_feeds` |
| *"ابحث في خلاصاتي عن هندسة المحولات"* | `search_feeds` |
| *"أظهر لي أحدث منشورات Reddit"* | `get_feed_items` |
| *"ما هي اشتراكاتي؟"* | `list_subscriptions` |
| *"ألغِ الاشتراك من BBC News"* | `unsubscribe` |

### بحث الويب
| ما تكتبه | الأداة المستخدمة | المعاملات المستخدمة |
|--------------|-------------|-----------------|
| *"ابحث عن أفضل أطر عمل Python للويب"* | `google_search` | `query` |
| *"ابحث عن مناقشات Reddit حول إعدادات الخادم المنزلي"* | `google_search` | `query` + `site="reddit.com"` |
| *"ابحث في Stack Overflow عن أمثلة Python غير المتزامنة"* | `google_search` | `query` + `site="stackoverflow.com"` |
| *"ما الجديد في الذكاء الاصطناعي هذا الأسبوع؟"* | `google_search` | `query` + `time_range="past_week"` |
| *"ابحث في Hacker News عن منشورات حول Rust"* | `google_search` | `query` + `site="news.ycombinator.com"` |
| *"احصل على الصفحة 2 من نتائج دروس تعلم الآلة"* | `google_search` | `query` + `page=2` |
| *"ابحث عن مطاعم في طوكيو باللغة اليابانية"* | `google_search` | `query` + `language="ja"` + `region="jp"` |

### التسوق والسفر
| ما تكتبه | الأداة المستخدمة |
|--------------|-------------|
| *"ابحث عن أرخص MacBook Air"* | `google_shopping` |
| *"ابحث عن رحلات طيران من نيويورك إلى لندن"* | `google_flights` |
| *"ابحث عن فنادق في باريس لعطلة نهاية الأسبوع القادمة"* | `google_hotels` |
| *"ترجم 'hello world' إلى اليابانية"* | `google_translate` |

### الخرائط والاتجاهات
| ما تكتبه | الأداة المستخدمة |
|--------------|-------------|
| *"ابحث عن مطاعم إيطالية بالقرب من Times Square"* | `google_maps` |
| *"احصل على اتجاهات من برلين إلى ميونيخ"* | `google_maps_directions` |
| *"اتجاهات المشي من برج إيفل إلى متحف اللوفر"* | `google_maps_directions` |

### المالية والطقس والمعلومات
| ما تكتبه | الأداة المستخدمة |
|--------------|-------------|
| *"ما هو سعر سهم Apple؟"* | `google_finance` |
| *"ما هو الطقس في دبي؟"* | `google_weather` |
| *"ما هي أهم العناوين اليوم؟"* | `google_news` |
| *"ابحث عن أوراق حول آليات الانتباه في المحولات"* | `google_scholar` |
| *"ابحث عن كتب حول تعلم الآلة"* | `google_books` |### الصور والرؤية
| ما تكتبه | الأداة المستخدمة |
|--------------|-------------|
| *"أظهر لي صورًا للشفق القطبي"* | `google_images` |
| *"ما هذا المنتج؟ /path/to/photo.jpg"* | `google_lens` |
| *"اكتشف جميع الكائنات في هذه الصورة"* | `google_lens_detect` |
| *"اقرأ النص في لقطة الشاشة هذه"* | `ocr_image` |
| سحب الصورة إلى الدردشة + *"ما هذا؟"* | `google_lens` |
| سحب الصورة إلى الدردشة + *"اقرأ النص"* | `ocr_image` |

> **تلميح:** لتمكين سحب وإفلات الصور مع النماذج النصية فقط في LM Studio، أضف ملف `model.yaml` في مجلد النموذج مع `metadataOverrides: { vision: true }`. سيتم إرسال الصورة بصيغة base64 وتقوم أدوات MCP بمعالجتها تلقائيًا.

### ذكاء الفيديو واستخراج المقاطع بالذكاء الاصطناعي
| ما تكتبه | الأداة المستخدمة |
|--------------|-------------|
| *"انسخ هذا الفيديو: https://youtube.com/watch?v=..."* | `transcribe_video` |
| *"ما الذي يناقشونه في هذا الفيديو؟"* | `transcribe_video` |
| *"ابحث عن الجزء الذي يتحدثون فيه عن عرض النطاق الترددي للذاكرة"* | `search_transcript` |
| *"استخرج الجزء الذي يناقشون فيه الأسعار"* | `extract_video_clip` |
| *"اقطع مقطعًا من قسم مقارنة الأجهزة"* | `extract_video_clip` |
| *"انسخ ~/meeting.mp3"* | `transcribe_local` |
| *"حول video.mp4 إلى mp3"* | `convert_media` |
| *"حول هذا الفيديو إلى GIF"* | `convert_media` |

### المستندات والبريد الإلكتروني
| ما تكتبه | الأداة المستخدمة |
|--------------|-------------|
| *"اقرأ ملف PDF هذا: ~/report.pdf"* | `read_document` |
| *"استخرج النص من ~/contract.docx"* | `read_document` |
| *"اقرأ لي هذا المقال: https://..."* | `visit_page` |
| *"تحقق من بريدي الإلكتروني على [email protected] كلمة المرور: xxxx"* | `fetch_emails` |
| *"اسحب آخر 10 رسائل بريد إلكتروني من Outlook"* | `fetch_emails` |

### أدوات الويب والسحابة
| ما تكتبه | الأداة المستخدمة |
|--------------|-------------|
| *"قصّر هذا الرابط: https://very-long-url..."* | `shorten_url` |
| *"أنشئ رمز QR لـ https://mysite.com"* | `generate_qr` |
| *"اصنع رمز QR لشبكة Wi-Fi الخاصة بي"* | `generate_qr` |
| *"انشر هذا الكود في pastebin"* | `paste_text` |
| *"أرشف هذا المقال: https://news.example.com/story"* | `archive_webpage` |
| *"ويكيبيديا: الحوسبة الكمومية"* | `wikipedia` |
| *"ابحث عن مهمة أبولو 11 على ويكيبيديا باللغة الألمانية"* | `wikipedia` |
| *"ارفع report.pdf إلى حاوية MinIO الخاصة بي"* | `upload_to_s3` |
| *"خزّن backup.tar.gz في حاوية S3 my-backups"* | `upload_to_s3` |

---

## التثبيت

### التثبيت السريع (pipx - موصى به)```bash
pipx install noapi-google-search-mcp
playwright install chromium

### بايثون 3.13 / OCR

يتم تثبيت الحزمة الأساسية على كل إصدار بايثون مدعوم، بما في ذلك 3.13. التعرف البصري على الأحرف (OCR) اختياري لأن `rapidocr-onnxruntime` لم يُصدر بعد عجلة (wheel) لبايثون 3.13 من المصدر ([RapidAI/RapidOCR#579](https://github.com/RapidAI/RapidOCR/issues/579)). كل شيء باستثناء أدوات التعرف البصري (`ocr_image` والاسترجاع من PDF الممسوح ضوئيًا في `read_document`) يعمل بدونها.

لتمكين التعرف البصري، أضف الإضافي `[ocr]` على إصدار بايثون متوافق (3.10–3.12):```bash
pipx install "noapi-google-search-mcp[ocr]"

إذا تم التثبيت في بيئة افتراضية (venv)، استخدم المسار الكامل: `~/.local/share/noapi-google-search-mcp/bin/noapi-google-search-mcp`

### Claude Desktop

أضف إلى إعدادات Claude Desktop الخاصة بك (`claude_desktop_config.json`):```json
{
  "mcpServers": {
    "google-search": {
      "command": "noapi-google-search-mcp"
    }
  }
}

يمنح هذا وكيل OpenClaw الخاص بك الوصول إلى جميع الأدوات الـ 38 — بحث Google الحقيقي، التغذية المباشرة، الرؤية، OCR، وذكاء الفيديو — بدون أي مفاتيح API.

### كـ CLI```bash
noapi-google-search-mcp

## التطوير```bash
git clone https://github.com/VincentKaufmann/noapi-google-search-mcp.git
cd google-search-mcp
pip install -e .
playwright install chromium