# איך נותנים ל־Claude Code לתמלל אודיו ווידאו?

> מוסיפים את שרת ה־MCP של KolWrite בפקודה אחת, claude mcp add, או מתקינים את ה־skill בשם kolwrite-transcribe. אחרי זה Claude Code מעלה את הקובץ, פותח משימה, מחכה לה וכותב את התמליל, הכתוביות או התרגום לתוך הפרויקט. החיוב הוא לפי שנייה מתוך הקרדיטים שלכם ב־KolWrite.

עודכן לאחרונה: 2026-11-21 · HTML: https://console.kolwrite.com/he/agents/claude-code

## מה עושים פעם אחת

פותחים חשבון ויוצרים מפתח בעצמכם ב־[console.kolwrite.com](https://console.kolwrite.com/auth?lang=he): נרשמים, טוענים קרדיטים, נכנסים ל־API Keys ויוצרים מפתח. סוכן לא יכול לעשות את זה במקומכם.

שומרים את המפתח בקובץ הפרופיל של ה־shell (`~/.zshrc`,‏ `~/.bashrc`) כדי שכל סשן של סוכן יוכל לקרוא אותו, ופותחים טרמינל חדש:

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

הכלים קוראים את המפתח רק מהמשתנה הזה. אל תדביקו אותו בצ׳אט ואל תעלו אותו לריפוזיטורי.

## מוסיפים את שרת ה־MCP

מריצים בטרמינל שבו `KOLWRITE_API_KEY` מוגדר. כדי שהשרת יהיה זמין בכל פרויקט, מוסיפים `--scope user`:

```bash
claude mcp add --transport stdio --env KOLWRITE_API_KEY="$KOLWRITE_API_KEY" kolwrite -- npx -y https://console.kolwrite.com/mcp/kolwrite-mcp-0.1.0.tgz
```

השרת נותן לסוכן שישה כלים: `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`).

בודקים עם `claude mcp list`, או עם `/mcp` בתוך סשן.

## או מתקינים את ה־skill

ה־skill הוא תיקייה עם קובץ SKILL.md והלקוח בקובץ אחד. Claude Code טוען אותו מ־`~/.claude/skills` (לכל הפרויקטים) או מ־`.claude/skills` (לפרויקט אחד) ומשתמש בו כשמבקשים תמלול:

```bash
mkdir -p ~/.claude/skills && cd ~/.claude/skills
curl -fsSLO https://console.kolwrite.com/skills/kolwrite-transcribe.zip && unzip -o kolwrite-transcribe.zip && rm kolwrite-transcribe.zip
```

הטקסט של ה־skill נמצא ב־[SKILL.md](https://console.kolwrite.com/skills/kolwrite-transcribe/SKILL.md). משתמשים בשרת ה־MCP או ב־skill, אין צורך בשניהם.

## מה מבקשים

שלוש בקשות לדוגמה ל־Claude Code:

```text
תמלל את ~/Downloads/interview.m4a עם KolWrite ושמור את הטקסט בקובץ interview.txt באותה תיקייה.

הכן כתוביות SRT באנגלית ל־talk.mp4 עם KolWrite, כתובית אחת לכל משפט.

מי אמר מה ב־team-call.mp3? תמלל אותו עם זיהוי דוברים במודל oracle, ואז רשום לכל דובר את המשימות שלו.
```

Claude Code צריך את הקובץ על המחשב שלכם או קישור ישיר לקובץ מדיה. בסרטונים ששוקלים מעל כ־100 MiB הוא מחלץ קודם את האודיו עם ffmpeg.

## כמה זה עולה

| משימה | מודל | עלות |
| --- | --- | --- |
| ראיון של 30 דקות, טקסט רגיל | `base` | 0.24 דולר |
| פגישה של שעה עם זיהוי דוברים | `oracle` | 1.56 דולר |
| הרצאה של שעה בעברית עם כתוביות באנגלית | `oracle` | 1.44 דולר |
| שעה של אודיו רועש עם דיבור חופף | `oracle_max` | 3.60 דולר |

החיוב הוא לפי שנייה של אודיו מתוך הקרדיטים שלכם, בלי מינימום. זיהוי דוברים מוסיף 0.10 קרדיטים לשעת אודיו. שרת ה־MCP ו־kolwrite.py משתמשים ב־`base` אלא אם אתם או הסוכן קובעים מודל אחר, וב־`oracle_mini` בתרגום. כל התעריפים: [/he/models](https://console.kolwrite.com/he/models).

## מה אסור לסוכן לעשות

- לבקש מכם את המפתח בצ׳אט, להדפיס אותו או לכתוב אותו לקובץ, לפקודה או ל־commit.
- להפעיל שוב את אותו תמלול אחרי timeout או שגיאת רשת. כל הפעלה היא משימה חדשה שמחויבת בנפרד, ולכן במקום זה צריך לבדוק את המשימה הקיימת או לשאול אתכם.
- להקליד חותמות זמן בעצמו. כדי לחתוך או לצטט לפי זמן הוא לוקח מספרי מקטעים מהתמליל ומחשב את הזמנים בקוד, לפי זמני המילים.
- לשלוח כתובת של YouTube או של דף אינטרנט אחר בתור המדיה. צריך את קובץ המדיה עצמו.
- לתמלל הקלטות ארוכות (מעל שעה) בלי לומר לכם קודם מה העלות הצפויה.

## שאלות ותשובות

### האם Claude Code צריך את שרת ה־MCP, או שהוא יכול לקרוא ל־API בעצמו?

הוא יכול לקרוא ל־REST API בעצמו עם curl או Python, אם מוסיפים ל־`CLAUDE.md` את ההוראה מ־[agent-instructions.md](https://console.kolwrite.com/agent-instructions.md). שרת ה־MCP או ה־skill חוסכים ממנו לכתוב מחדש בכל פעם את קוד ההעלאה וה־polling.

### לאן האודיו הולך?

הקובץ מועלה ל־KolWrite ומתומלל בענן, לפי [תנאי השימוש ומדיניות הפרטיות של KolWrite](https://www.kolwrite.com/tos_pp.html). שרת ה־MCP לא שומר עותק.

## דפים קשורים

- [Codex](https://console.kolwrite.com/he/agents/codex)
- [כל סוכן: kolwrite.py וה־skill](https://console.kolwrite.com/he/agents/any-agent)
- [עריכת וידאו עם סוכני AI](https://console.kolwrite.com/he/guides/video-editing-with-ai)
- [כלי תמלול לסוכני AI](https://console.kolwrite.com/he/guides/transcription-tool-for-ai-agents)
- [תיעוד ה־API](https://console.kolwrite.com/he/public_api_docs)

---
קבלת מפתח API: https://console.kolwrite.com/auth?lang=he · תיעוד ה־API: https://console.kolwrite.com/he/public_api_docs · llms.txt: https://console.kolwrite.com/llms.txt
