למפתחים ולסוכני AI

סקירה

כל התוכן של קלודLEARN נגיש גם באופן תוכניתי, בחינם וללא מפתח API: קטלוג 57 הפריטים, מילון המושגים והחיפוש זמינים כ-REST API בקריאה בלבד, ככלי MCP לסוכנים, וכ-Markdown נקי לכל עמוד. השתמשו בזה כדי לבנות אינטגרציות, להזין סוכנים בתוכן עברי איכותי על קלוד, או פשוט לגלוש מהטרמינל.

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

REST API

בסיס ה-API: https://learnclaude.co.il/api/v1 - קריאה בלבד, ללא אימות, עם CORS פתוח. המפרט המלא זמין ב-OpenAPI: https://learnclaude.co.il/openapi.json

• GET /api/v1/catalog - כל פריטי הקטלוג (סינון: ?category=, ?type=)
• GET /api/v1/modules/{idOrSlug} - פריט בודד, כולל FAQ ותיאור מלא
• GET /api/v1/glossary - כל מונחי המילון (סינון: ?category=)
• GET /api/v1/glossary/{id} - מונח בודד
• GET /api/v1/search?q={query} - חיפוש חופשי בקטלוג ובמילון

curl -s "https://learnclaude.co.il/api/v1/search?q=mcp" | jq '.results[0]'

שגיאות בפורמט JSON

כל שגיאת API מוחזרת כ-JSON מובנה עם קוד, הודעה ורמז לפתרון - לעולם לא כעמוד HTML:

{
  "error": {
    "code": "module_not_found",
    "status": 404,
    "message": "No module with id or slug 'foo'.",
    "hint": "List valid ids with GET /api/v1/catalog.",
    "docs": "https://learnclaude.co.il/openapi.json"
  }
}

שרת MCP

שרת MCP (Model Context Protocol) בתקן Streamable HTTP זמין בכתובת https://learnclaude.co.il/mcp, עם כלים לחיפוש בקטלוג, שליפת פריטים ומונחי מילון. מניפסט גילוי זמין ב-/.well-known/mcp.json. חיבור מ-Claude Code:

claude mcp add --transport http learnclaude https://learnclaude.co.il/mcp

תוכן ב-Markdown

כל עמוד תוכן זמין גם כ-Markdown נקי, בשתי דרכים: משא ומתן על תוכן עם הכותרת Accept: text/markdown, או הוספת הסיומת .md לכתובת (למשל /content/tokens.md). קובץ llms.txt בשורש האתר ממפה את כל המשאבים לסוכנים, ו-llms-full.txt מכיל את תמצית האתר כולו בקובץ אחד.

curl -s -H "Accept: text/markdown" https://learnclaude.co.il/content/tokens

כלי CLI

חבילת ה-npm הרשמית learnclaude מאפשרת לחפש ולקרוא את הקטלוג מהטרמינל, ללא התקנה מראש:

npx learnclaude search "חלון הקשר"
npx learnclaude module tokens
npx learnclaude glossary mcp --json

תנאי שימוש

• ה-API חופשי לשימוש, בקריאה בלבד, ללא צורך במפתח.
• בבקשות בנפח גבוה - הוסיפו User-Agent מזהה והפעילו קישור חוזר (attribution) לעמוד המקור.
• שאלות, בקשות ותקלות: info@learnclaude.co.il או /report-error.