# كيف أجعل Cursor يفرّغ الصوت والفيديو؟

> أضف خادم MCP من KolWrite إلى ~/.cursor/mcp.json (أو افتح رابط التثبيت أدناه). بعدها يستطيع وكيل Cursor تفريغ التسجيلات الموجودة في مشروعك إلى نص أو ترجمات نصية أو ترجمة إلى لغة أخرى، وتُحتسب التكلفة بالثانية من رصيدك في KolWrite.

آخر تحديث: 2026-11-21 · HTML: https://console.kolwrite.com/ar/agents/cursor

## ما تفعله مرة واحدة

أنشئ الحساب والمفتاح بنفسك من [console.kolwrite.com](https://console.kolwrite.com/auth?lang=ar): سجّل، وأضف رصيدًا، ثم افتح «API Keys» وأنشئ مفتاحًا. لا يستطيع الوكيل القيام بذلك نيابةً عنك.

احفظ المفتاح في ملف إعدادات الـ shell (`~/.zshrc` أو `~/.bashrc`) لتتمكن كل جلسة وكيل تبدأها من قراءته، ثم افتح نافذة طرفية جديدة:

```bash
export KOLWRITE_API_KEY=...   # paste the key from API Keys
```

تقرأ الأدوات المفتاح من هذا المتغير فقط. لا تلصقه في محادثة ولا تضعه في مستودع.

## إضافة خادم MCP

في `~/.cursor/mcp.json` (لكل المشاريع) أو `.cursor/mcp.json` (لمشروع واحد). تقرأ الصيغة `${env:KOLWRITE_API_KEY}` المفتاح من البيئة التي شُغّل فيها Cursor:

```json
{
  "mcpServers": {
    "kolwrite": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://console.kolwrite.com/mcp/kolwrite-mcp-0.1.0.tgz"
      ],
      "env": {
        "KOLWRITE_API_KEY": "${env:KOLWRITE_API_KEY}"
      }
    }
  }
}
```

أو افتح هذا الرابط في متصفح على الجهاز الذي ثُبّت عليه Cursor. يسألك Cursor قبل أن يضيف الخادم: [Add KolWrite to Cursor](cursor://anysphere.cursor-deeplink/mcp/install?name=kolwrite&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImh0dHBzOi8vY29uc29sZS5rb2x3cml0ZS5jb20vbWNwL2tvbHdyaXRlLW1jcC0wLjEuMC50Z3oiXSwiZW52Ijp7IktPTFdSSVRFX0FQSV9LRVkiOiIke2VudjpLT0xXUklURV9BUElfS0VZfSJ9fQ==)

يمنح الخادم الوكيل ستّ أدوات: `transcribe_file`، `transcribe_url`، `upload_file`، `get_job`، `list_models`، `list_languages`. يعمل على جهازك بإصدار Node.js 18 أو أحدث، وتُنزَّل حزمته من https://console.kolwrite.com/mcp/kolwrite-mcp-0.1.0.tgz (SHA-256 `0dcd6ff169b860b9363044837b8545279efa585c4987b20d81035f920f6ac7ca`).

إذا لم تظهر الأدوات، شغّل Cursor من طرفية يكون فيها `KOLWRITE_API_KEY` مضبوطًا، أو افتح Cursor Settings ثم MCP وتحقق من حالة الخادم.

## إضافة قاعدة للمشروع

لكي يعرف الوكيل الـ API عندما يكتب كودًا أيضًا، أضف قاعدة في `.cursor/rules/kolwrite.mdc`:

```markdown
---
description: Speech-to-text with the KolWrite API
alwaysApply: false
---
For speech-to-text use the KolWrite API; read https://console.kolwrite.com/agent-instructions.md first. The key is in KOLWRITE_API_KEY; never print it.
```

## ماذا تطلب

ثلاثة طلبات يمكنك تجربتها مع Cursor:

```text
فرّغ الملف ~/Downloads/interview.m4a بواسطة KolWrite واحفظ النص في interview.txt بجانبه.

أنشئ ترجمات SRT بالإنجليزية للملف talk.mp4 بواسطة KolWrite، بحيث تكون كل جملة في مقطع ترجمة مستقل.

من قال ماذا في team-call.mp3؟ فرّغه مع تمييز المتحدثين بالنموذج oracle، ثم اذكر المهام المطلوبة من كل متحدث.
```

## التكلفة

| المهمة | النموذج | التكلفة |
| --- | --- | --- |
| مقابلة مدتها 30 دقيقة، نص عادي | `base` | 0.24 دولار |
| اجتماع مدته ساعة مع تمييز المتحدثين | `oracle` | 1.56 دولار |
| محاضرة بالعبرية مدتها ساعة مع ترجمات نصية بالإنجليزية | `oracle` | 1.44 دولار |
| ساعة من صوت مشوَّش وكلام متداخل | `oracle_max` | 3.60 دولار |

تُحتسب التكلفة بالثانية من مدة الصوت وتُخصم من رصيدك، دون حدّ أدنى. يضيف تمييز المتحدثين 0.10 رصيد لكل ساعة صوت. يستخدم خادم MCP وملف kolwrite.py النموذج `base` ما لم تحدد أنت أو الوكيل نموذجًا آخر، والنموذج `oracle_mini` عند الترجمة. الأسعار كاملةً: [/ar/models](https://console.kolwrite.com/ar/models).

## ما يجب ألا يفعله الوكيل

- أن يطلب منك المفتاح في المحادثة، أو يطبعه، أو يكتبه في ملف أو أمر أو commit.
- أن يعيد بدء التفريغ نفسه بعد انتهاء المهلة أو حدوث خطأ في الشبكة. كل بدء يُنشئ مهمة جديدة تُحتسب تكلفتها، لذا عليه أن يتحقق من حالة المهمة القائمة أو يسألك.
- أن يكتب الطوابع الزمنية بنفسه. لقصّ مقطع أو اقتباسه بحسب الوقت، يأخذ أرقام المقاطع من التفريغ ويحسب الأوقات في الكود من أوقات الكلمات.
- أن يرسل رابط YouTube أو أي صفحة ويب أخرى على أنه الملف. المطلوب هو ملف الوسائط نفسه.
- أن يفرّغ تسجيلات طويلة (أكثر من ساعة) دون أن يخبرك بالتكلفة المتوقعة أولًا.

## أسئلة وأجوبة

### هل يعمل في وضع Ask؟

تعمل أدوات MCP داخل الوكيل. استخدم الوكيل للتفريغ، ويمكنك بعد ذلك قراءة التفريغ في وضع Ask.

## صفحات ذات صلة

- [Claude Code](https://console.kolwrite.com/ar/agents/claude-code)
- [أي وكيل: kolwrite.py والمهارة](https://console.kolwrite.com/ar/agents/any-agent)
- [تحرير الفيديو مع وكلاء الذكاء الاصطناعي](https://console.kolwrite.com/ar/guides/video-editing-with-ai)
- [واجهة ترجمات SRT](https://console.kolwrite.com/ar/guides/srt-subtitles-api)
- [توثيق الـ API](https://console.kolwrite.com/ar/public_api_docs)

---
احصل على مفتاح API: https://console.kolwrite.com/auth?lang=ar · توثيق الـ API: https://console.kolwrite.com/ar/public_api_docs · llms.txt: https://console.kolwrite.com/llms.txt
