# מתכון תוכן

> רכיב מתכון תוכן מגלה למה פוסט ברשתות החברתיות עבד: הפתיח, הפורמט, הביטים, הקריאה לפעולה, הסאונד והקצב, כמתכון לשימוש חוזר.

Source: https://nodaro.ai/he/docs/nodes/video/content-recipe

רכיב **מתכון תוכן** מסביר למה פוסט ברשתות החברתיות עבד, כמתכון שאפשר להשתמש בו שוב. הרכיב קורא את החומר של הפוסט בעזרת מודל שפה, ומחזיר את הפתיח, הפורמט, הביטים, הסיבות לכך שהפוסט עובד, הקריאה לפעולה, הסאונד והקצב. המתכון מגיע אליכם כנתונים מובנים וכטקסט קריא, מוכן לרכיב [רעיונות לתוכן](https://nodaro.ai/docs/nodes/video/content-ideas).

- Found in: Video › Analyze
- API type: `content-recipe`

רכיב מתכון תוכן רץ ב-Nodaro Cloud בלבד. הוא לא זמין בהתקנות באירוח עצמי.

## מתי להשתמש
- אתם רוצים להבין למה סרטון של מתחרה, פוסט ויראלי או מודעה שומרים על תשומת הלב של הצופים.
- אתם רוצים להשתמש במבנה של פוסט שעבד גם בשביל המותג שלכם, עם רכיב [רעיונות לתוכן](https://nodaro.ai/docs/nodes/video/content-ideas).
- אתם רוצים תוויות קבועות לכל פוסט, כגון הפורמט וסוג הפתיח, כדי למיין פוסטים או לנתב אותם בתהליך.
- אתם רוצים להשוות כמה פוסטים. צרו מתכון אחד לכל פוסט, וחברו את כולם לרכיב רעיונות לתוכן.

## התחלה מהירה
### הוספת הרכיב
הקישו Tab על הקנבס ובחרו **וידאו › ניתוח › מתכון תוכן**.

### הזנת הפוסט לרכיב
נתחו את הפוסט ברכיב [ניתוח וידאו](https://nodaro.ai/docs/nodes/video/video-analysis), וחברו את הפלט **JSON של הסצנות** שלו לקלט **חומר מקור**. גם פוסט שנאסף בגריפה, כיתוב או תמלול ברכיב [טקסט](https://nodaro.ai/docs/nodes/automate/text) מתאימים.

### שמירת הקישור לפוסט
חברו לקלט **פוסט המקור** את רכיב [כתובת וידאו](https://nodaro.ai/docs/nodes/automate/video-url) שבו נמצא הפוסט. כך המתכון מצטט את הפוסט, וכל רעיון שנוצר ממנו מקשר חזרה לפוסט.

### הרצה
לחצו על **הרצה**. כשההרצה מסתיימת, האפליקציה מציגה את ההודעה ״מתכון התוכן מוכן״. הרכיב מציג את הנושא, את הפורמט עם רמת הביטחון שלו, את האורך, את הקצב, את הפתיח, את הביטים ואת הסיבות לכך שהפוסט עובד. רחפו מעל המתכון כדי לפתוח את הטקסט המלא שלו או כדי להעתיק אותו.

Workflow: רכיב ניתוח וידאו קורא את הפוסט, ורכיב מתכון תוכן הופך את הניתוח למתכון ששומר את הקישור לפוסט. רכיב רעיונות לתוכן כותב רעיונות למותג שלכם, ורכיב יצירת תסריט כותב תסריט אחד לכל רעיון.

- כתובת וידאו → ניתוח וידאו (וידאו)
- כתובת וידאו → מתכון תוכן (פוסט המקור)
- ניתוח וידאו → מתכון תוכן (חומר מקור)
- מתכון תוכן → רעיונות לתוכן (מתכונים)
- טקסט → רעיונות לתוכן (מותג)
- רעיונות לתוכן → יצירת תסריט (פרומפט)

## קלטים
| קלט | מקבל | מה הוא עושה |
| --- | --- | --- |
| **חומר מקור** | תוצאה של רכיב ניתוח וידאו, או כל רכיב שנותן טקסט, JSON או רשימה, כגון רכיב טקסט עם כיתוב או תמלול | החומר שהמתכון מבוסס עליו. נדרש. |
| **פוסט המקור** | רכיב [כתובת וידאו](https://nodaro.ai/docs/nodes/automate/video-url), או כל רכיב טקסט שיש בו קישור | הקישור של הפוסט עצמו. המתכון מצטט אותו. קישור מחובר גובר על השדה **קישור לפוסט (אופציונלי)**. |

**הקישור לדף, לא הקובץ.** רוב הרכיבים שמחוברים לרכיב כתובת וידאו מקבלים את הסרטון שהורד. הקלט **פוסט המקור** מקבל במקום זאת את הקישור לדף של הפוסט, כדי שהמתכון יוכל להפנות חזרה לפוסט.

**פוסט אחד בכל הרצה.** כשהקלט **חומר מקור** מקבל רשימה של כמה פוסטים, הרכיב קורא רק את הראשון ומציג על כך הודעה. כדי לקבל מתכון אחד לכל פוסט, העבירו את החיבור למצב **כל אחד**. ראו את הסעיף [מצבי חיבור](https://nodaro.ai/docs/concepts/nodes-and-connections#connection-modes) בדף רכיבים וחיבורים.

### איזה חומר נותן את המתכון הטוב ביותר
תוצאה של רכיב [ניתוח וידאו](https://nodaro.ai/docs/nodes/video/video-analysis) נותנת את המתכון הטוב ביותר. היא כוללת את התזמונים, את המילים המדוברות, את הטקסט שעל המסך ואת הסאונד, ולכן הפתיח והביטים מבוססים על מה שהפוסט באמת עושה. גם פוסט שנאסף בגריפה או טקסט פשוט, כגון כיתוב או תמלול, מתאימים. בלי תזמונים, הרכיב מעריך את הביטים לפי קצב דיבור טבעי.

## פלטים
| פלט | מה הוא מעביר |
| --- | --- |
| **JSON של המתכון** | המתכון כנתונים מובנים. ראו את הסעיף [מה יש במתכון](#what-the-recipe-contains). |
| **טקסט המתכון** | אותו מתכון כטקסט קריא. זה מה שאדם קורא, וגם מה שרכיב רעיונות לתוכן קורא כשהמתכון מגיע כטקסט. |

רכיב [רעיונות לתוכן](https://nodaro.ai/docs/nodes/video/content-ideas) מקבל כל אחד משני הפלטים.

## הגדרות
| הגדרה | מה היא עושה |
| --- | --- |
| **מודל AI** | מודל השפה שכותב את המתכון. ברירת המחדל היא Gemini 3.6 Flash. ברשימה מופיעים המודלים שיכולים להחזיר נתונים מובנים. הרמה של המודל קובעת את המחיר. ראו את הסעיף [קרדיטים](#credits). |
| **מיקוד (אופציונלי)** | במה המתכון צריך להתמקד במיוחד, למשל ״הפתיח וקצב העריכה״. עד 2,000 תווים. |
| **קישור לפוסט (אופציונלי)** | הקישור של הפוסט, שמשמש כששום דבר לא מחובר לקלט **פוסט המקור**. המתכון מצטט את הקישור, והרכיב אף פעם לא פותח אותו. כל עוד רכיב מחובר לקלט **פוסט המקור**, החלונית מציגה במקום השדה את ״נלקח מהרכיב המחובר״ ואת השם של אותו רכיב. |

## מה יש במתכון
| שדה | מה יש בו |
| --- | --- |
| `version` | `1` |
| `source` | מאיפה המתכון הגיע: `kind` (`video-analysis`, `post` או `text`) וגם, כשהם ידועים, ה-`url` וה-`platform` של הפוסט, ה-`handle` של החשבון, ה-`title` וה-`language`. הערכים האלה נקראים מהקלט, ואף פעם לא מומצאים. |
| `hook` | על 3 השניות הראשונות: `spoken` (מילה במילה, בשפת המקור), `onScreenText` (מילה במילה), `visual`, `types` (1 או 2 טכניקות פתיח, הראשית קודם) ו-`whyItStops`. |
| `format` | `label`, פורמט אחד מהרשימה שבהמשך, ו-`confidence`, מ-0 עד 1. |
| `beats` | המבנה של הפוסט, לפי הסדר. לכל ביט יש `start` ו-`end` בשניות, `purpose` ו-`description` של שורה אחת. |
| `whyItWorks` | 2–4 סיבות. לכל סיבה יש `reason` ו-`detail` שקשור לרגע מסוים בפוסט. |
| `cta` | הקריאה לפעולה: ה-`kind` שלה, וה-`text` שלה מילה במילה. הטקסט ריק כשהסוג הוא `none`. |
| `sound` | ה-`kind` של הסאונד ו-`detail` קצר. |
| `durationSec`, `pace`, `aspect` | האורך בשניות, שנמדד מהניתוח כשיש ניתוח. הקצב: `fast`, `medium` או `slow`. יחס הגובה־רוחב, כשהוא ידוע. |
| `topic`, `summary` | הנושא בכמה מילים, והדפוס שאפשר לחזור עליו, ב-2 או 3 משפטים. |

התוויות והתיאורים כתובים באנגלית. מילים מצוטטות, כגון הפתיח המדובר, נשארות בשפה של הפוסט.

### רשימות התוויות
כל תווית מגיעה מרשימה קבועה של מזהים באנגלית. רכיבי סינון, נתבים ורכיבים בהמשך התהליך יכולים להסתמך עליהן. בכל רשימה, חוץ מסוגי הסאונד, יש `other` לפוסט שלא מתאים לאף אחת מהאפשרויות האחרות.

- **פורמטים:** `talking-head`, `pov`, `skit`, `storytime`, `tutorial`, `listicle`, `before-after`, `transformation`, `demo`, `unboxing`, `reaction`, `comparison`, `myth-vs-fact`, `day-in-the-life`, `challenge`, `hot-take`, `trend-remix`, `testimonial`, `behind-the-scenes`, `other`.
- **סוגי פתיח**, כלומר הטכניקה של הפתיח: `question`, `bold-claim`, `result-first`, `problem-callout`, `tease`, `story-open`, `direct-address`, `relatable-moment`, `pattern-interrupt`, `visual-shock`, `text-overlay`, `sound-hook`, `other`.
- **מטרות הביטים:** `hook`, `setup`, `problem`, `build`, `demo`, `proof`, `reveal`, `payoff`, `twist`, `cta`, `other`.
- **סיבות לכך שהפוסט עובד**, כלומר הגורם שמאחורי כל סיבה: `curiosity`, `emotion`, `humor`, `relatability`, `social-proof`, `novelty`, `utility`, `aspiration`, `controversy`, `satisfaction`, `urgency`, `authority`, `other`.
- **סוגי קריאה לפעולה:** `none`, `follow`, `comment`, `share`, `save`, `link-in-bio`, `buy`, `sign-up`, `watch-next`, `dm`, `other`.
- **סוגי סאונד:** `voiceover`, `on-camera-speech`, `trending-sound`, `music`, `ambient`, `silent`, `mixed`.

## קרדיטים
לכל הרצה יש מחיר קבוע אחד, שנקבע לפי הרמה של מודל ה-AI. בניגוד לרוב רכיבי הטקסט של AI, רכיב מתכון תוכן מתומחר לפי רמה, ולא לפי הטוקנים שהקריאה משתמשת בהם.

| רמת המודל | קרדיטים להרצה |
| --- | --- |
| חסכוני, כגון Gemini 3.6 Flash (ברירת המחדל) | 6 |
| רגיל, כגון Claude Sonnet 4.6 | 22 |
| פרימיום, כגון Claude Opus 5 | 39 |

- **מאמץ חשיבה.** בקריאה ל-API, השדה `reasoningEffort` עם הערך `xhigh` או `max` מעביר את ההרצה רמה אחת למעלה, ולא מעבר לרמת פרימיום. בחלונית ההגדרות של הרכיב הזה אין בקרה של מאמץ חשיבה.
- **הרצות שנכשלו.** על הרצה שנכשלת, הקרדיטים מוחזרים. ראו את הדף [קרדיטים](https://nodaro.ai/docs/concepts/credits).
- **הניתוח מתומחר בנפרד.** המחיר של רכיב [ניתוח וידאו](https://nodaro.ai/docs/nodes/video/video-analysis), שבדרך כלל מזין את הרכיב, נקבע לפי אורך הסרטון. באיכות **Pro**, פוסט של עד 60 שניות עולה 238 קרדיטים.

את המחיר של התהליך כולו, מהפוסט ועד התסריטים, תמצאו בדף [רעיונות לתוכן](https://nodaro.ai/docs/nodes/video/content-ideas#credits).

## טיפים
- **נתחו את הפוסט קודם.** האיכות של הפתיח ושל הביטים תלויה בחומר, ורכיב ניתוח וידאו נותן את החומר המלא ביותר.
- **שמרו את הקישור.** חברו את רכיב כתובת וידאו לקלט **פוסט המקור**, כדי שכל רעיון שנוצר מהמתכון יקשר חזרה לפוסט שלו.
- **השתמשו במיקוד.** מלאו את השדה **מיקוד (אופציונלי)** כשחלק אחד חשוב יותר מכל השאר, כגון הפתיח או קצב העריכה.
- **שלבו כמה פוסטים.** צרו מתכון לכל פוסט, וחברו את כולם לרכיב רעיונות לתוכן. הרעיונות מתחלקים בין הפוסטים.

## פתרון בעיות
**ההרצה נעצרת עם ההודעה ״חברו קודם ניתוח וידאו, פוסט או טקסט״.** שום דבר שמיש לא מחובר לקלט **חומר מקור**. חברו רכיב ניתוח וידאו, פוסט או רכיב טקסט, והריצו שוב. ההרצה נעצרת לפני שנגבים קרדיטים.

**ההרצה מסתיימת עם ההודעה ״מתכון התוכן נכשל״.** המודל לא סיים לכתוב את המתכון. הקרדיטים מוחזרים. הריצו את הרכיב שוב.

**הרכיב מודיע שהוא קרא רק את הפוסט הראשון.** הקלט **חומר מקור** קיבל רשימה של כמה פוסטים. העבירו את החיבור למצב **כל אחד** כדי ליצור מתכון אחד לכל פוסט.

**במתכון אין קישור לפוסט.** שום דבר לא היה מחובר לקלט **פוסט המקור**, והשדה **קישור לפוסט (אופציונלי)** היה ריק. חברו את רכיב כתובת וידאו לקלט **פוסט המקור**, או הדביקו את הקישור בשדה **קישור לפוסט (אופציונלי)**.

## דרך ה-API
הנתיב `POST /v1/content-recipe` יוצר מתכון ב-Nodaro Cloud. גוף הבקשה מקבל את `source`, החומר של הפוסט כטקסט, ואת השדות האופציונליים `sourceUrl`, `focus`, `llmModel` ו-`reasoningEffort`. החומר יכול להיות תוצאה של ניתוח וידאו כמחרוזת JSON, פוסט, כיתוב או תמלול.

```bash
curl -s https://app.nodaro.ai/v1/content-recipe \
  -H "Authorization: Bearer $NODARO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
"source": "Caption: three mornings, one mug. Which one is you?",
"sourceUrl": "https://www.tiktok.com/@example/video/7300000000000000000",
"focus": "the hook and the editing rhythm"
}'
```

התגובה היא `{ "jobId": "…" }`. בדקו את הסטטוס של המשימה עם `GET /v1/jobs/:id/status` מדי כמה שניות, עד שהוא `completed`. ב-`output_data` של המשימה נמצא המתכון כ-`json` וכ-`text`. ראו את דף ה-API [משימות](https://nodaro.ai/docs/developers/api/jobs).

בקשה שאי אפשר להריץ נדחית עם `400` עוד לפני שנוצרת משימה, ולכן לא נגבים קרדיטים. זה קורה עם `source` ריק או ארוך מ-300,000 תווים, עם `focus` ארוך מ-2,000 תווים, עם מודל שלא יכול להחזיר נתונים מובנים, או עם `sourceUrl` שהוא לא קישור http או https.

אין כלי MCP ייעודי ואין מתודה ייעודית ב-SDK. בתהליך, סוג הרכיב הוא `content-recipe`. עוזרי AI וקוד יכולים להוסיף אותו עם [כלי התהליכים](https://nodaro.ai/docs/mcp/tools/projects-and-workflows) או עם [ה-API של התהליכים](https://nodaro.ai/docs/developers/api/workflows).

## שאלות נפוצות

### מה מחזיר רכיב מתכון תוכן?

רכיב מתכון תוכן מחזיר מתכון של פוסט אחד. המתכון כולל את הפתיח של 3 השניות הראשונות ואת הסיבה שהוא עוצר את הגלילה, ואת הפורמט עם רמת ביטחון. הוא כולל גם את הביטים המתוזמנים, 2–4 סיבות לכך שהפוסט עובד, את הקריאה לפעולה, את הסאונד, את האורך ואת הקצב. המתכון מגיע כ-JSON מובנה וכטקסט קריא.

### מה כדאי לחבר לרכיב מתכון תוכן?

תוצאה של רכיב ניתוח וידאו על הפוסט נותנת את המתכון הטוב ביותר, כי היא כוללת את התזמונים, את המילים המדוברות, את הטקסט שעל המסך ואת הסאונד. גם פוסט שנאסף בגריפה, כיתוב או תמלול מתאימים. חברו את רכיב כתובת וידאו לקלט פוסט המקור כדי לשמור במתכון את הקישור לפוסט.

### כמה קרדיטים עולה רכיב מתכון תוכן?

רכיב מתכון תוכן עולה 6 קרדיטים להרצה במודל חסכוני כגון Gemini 3.6 Flash, שהוא ברירת המחדל. מודל ברמה רגילה עולה 22 קרדיטים, ומודל ברמת פרימיום עולה 39 קרדיטים. על הרצה שנכשלה, הקרדיטים מוחזרים. לניתוח הווידאו שבדרך כלל מזין את הרכיב יש מחיר נפרד, לפי אורך הסרטון.

### האם אפשר להשתמש שוב במתכון בלי להעתיק את הפוסט המקורי?

כן. חברו את המתכון לרכיב רעיונות לתוכן. הרעיונות שלו לוקחים רק את המבנה של הפוסט, כלומר את הפורמט, את טכניקת הפתיח, את סדר הביטים ואת הקצב. המודל שכותב את הרעיונות אף פעם לא רואה את השורות המדוברות של הפוסט, את הטקסט שעל המסך או את הקריאה לפעולה.

### האם אפשר להשתמש ברכיב מתכון תוכן בהתקנה באירוח עצמי?

לא. רכיב מתכון תוכן רץ ב-Nodaro Cloud בלבד, והוא לא זמין בהתקנות באירוח עצמי.