API ו-MCP

כל מה שפורסם באתר — מאמרים, פוסטים, תיקים ומסמכים — זמין גם למכונות: לסוכני AI דרך MCP, ולתוכנות דרך JSON ו-RSS. הקריאה פתוחה וחינמית, בלי הרשמה.

שרת MCP של האתר

שרת MCP שמאפשר ל-Claude, ל-ChatGPT ולכל לקוח MCP אחר לחפש ולקרוא את כל התכנים שפורסמו באתר ואת המסמכים המצורפים אליהם. אין צורך בהזדהות.

https://www.z-g.co.il/api/mcp/site

ב-Claude: הגדרות ← Connectors ← Add custom connector, והדביקו את הכתובת. התעבורה היא Streamable HTTP עם תשובות JSON (בלי SSE), בגרסאות הפרוטוקול 2025-06-18, 2025-03-26 ו-2024-11-05. הקצב מוגבל ל-120 בקשות בדקה לכל כתובת IP.

כלי	מה הוא מחזיר
`site_list`	רשימת התכנים שפורסמו, לפי סוג או קטגוריה.
`site_search`	חיפוש טקסט חופשי בכל התכנים (עד 25 תוצאות).
`site_get`	פריט אחד במלואו, כ-Markdown, עם רשימת המסמכים המצורפים אליו.
`site_documents`	המסמכים המצורפים לתכנים: פסקי דין, החלטות, מכתבים ודוחות, ובאילו פריטים כל אחד מופיע.
`document_get_text`	הטקסט של מסמך PDF מצורף, לפי עמודים. מסמך סרוק מסומן scanned=true.
`site_updates`	מה חדש באתר, מהחדש לישן; עם since — רק מה שפורסם או נערך מאז.

דוגמה, בלי לקוח MCP:

curl -s https://www.z-g.co.il/api/mcp/site \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"site_search","arguments":{"query":"חופש מידע"}}}'

API לקריאה (JSON)

אותם נתונים, ב-HTTP רגיל. בלי מפתח, עם CORS פתוח. כל התשובות כוללות רק תוכן שפורסם.

`GET /api/v1/content`

פרמטר	משמעות
`(ללא)`	אינדקס של כל הפריטים
`type`	סוג אחד: article, blog, service, project, dictionary, media, page
`category`	סינון לפי קטגוריה או תגית
`q, limit`	חיפוש טקסט חופשי (עד 25 תוצאות)
`id`	פריט אחד במלואו כ-Markdown, למשל blog:<slug> או הכתובת שלו

`GET /api/v1/updates`

מה חדש באתר, מהחדש לישן — אותם פריטים כמו ב-RSS ובכלי site_updates. למעקב: שמרו את checked_at מכל תשובה והעבירו אותו כ-since בפעם הבאה; כל פריט מסומן new או updated.

פרמטר	משמעות
`since`	תאריך ISO; רק מה שפורסם או נערך מאז
`type`	סוגים מופרדים בפסיק: article, blog, dictionary, media, document
`limit`	ברירת מחדל 50, עד 200

`GET /feed.xml`

אותו זרם כ-RSS, לקוראי פידים. אפשר לסנן: /feed.xml?type=article,blog.

curl -s 'https://www.z-g.co.il/api/v1/updates?since=2026-10-01&type=blog,document'

קבצים ומסמכים

המסמכים עצמם מוגשים בכתובת /uploads/<name>. ה-MCP וה-API מגישים רק מסמכים שמצורפים לתוכן שפורסם. קובץ שהוסתר על ידי מנהל האתר עונה 404 בכל הממשקים, והטקסט שלו אינו מוגש. מסמך שהוחלף בגרסה מושחרת מוגש מאותה כתובת בגרסה החדשה בלבד.

ממשק כתיבה (מפתחות API)

ממשק הכתיבה פתוח רק למפתחות שמנפיק מנהל האתר, לכל מפתח הרשאות מוגדרות ותוקף של עד שנה. המפתח נשלח בכותרת Authorization: Bearer zg_…. כל קריאה נרשמת. אף מפתח אינו יכול למחוק תוכן או לפרסם פוסט — אלה נשארים פעולות של אדם.

הרשאה	מה היא מתירה
`plilist:draft`	יצירה ועריכה של טיוטות בהפליליסט (לא פרסום, לא נגיעה בפוסט שפורסם), כולל העלאת תמונות PNG/JPEG/WebP לטיוטות (רק בשם api-*)
`media:write`	הוספה ועדכון של פריטים ברשימת הפרסומים
`articles:edit`	עריכת התוכן של מאמר קיים, גם אם פורסם (בלי שינוי סטטוס, כתובת או מחיקה; כל עריכה שומרת את הגרסה הקודמת)
`plilist:edit`	עריכת התוכן של פוסט קיים בהפליליסט, גם אם פורסם (בלי שינוי סטטוס, כתובת או מחיקה; כל עריכה שומרת את הגרסה הקודמת)
`milon:write`	הוספה ועדכון של ערכים במילון, כולל פרסום (בלי מחיקה)
`cases:write`	העלאת קובצי PDF ותמונות לתיקי פוסטים (רק בשם api-*, בלי לגעת בקבצים קיימים) והוספה ועדכון של מסמכים בתיק (בלי מחיקה)
`uploads:replace`	החלפת התוכן של קובץ PDF קיים בגרסה מושחרת (כל שם קיים; הגרסה הקודמת נשמרת כקובץ לא פומבי <שם>-pre-redaction-<תאריך>.pdf; בלי יצירת שמות חדשים ובלי מחיקה)

נקודת קצה	מה היא עושה
`GET/PUT /api/v1/plilist/<slug>`	טיוטה בהפליליסט: יצירה ועדכון כל עוד היא טיוטה (plilist:draft)
`GET/PUT /api/v1/plilist/<slug>/edit`	עריכת התוכן של פוסט קיים, כולל פוסט שפורסם (plilist:edit)
`GET/PUT /api/v1/articles/<slug>`	עריכת התוכן של מאמר קיים (articles:edit)
`GET/PUT /api/v1/milon/<slug>`	יצירה ועדכון של ערך במילון (milon:write)
`PUT /api/v1/media-appearances`	הוספה ועדכון של פריט ברשימת הפרסומים (media:write)
`PUT /api/v1/case-documents`	הוספה ועדכון של מסמך בתיק של פוסט (cases:write)
`PUT /api/v1/uploads/api-<name>.pdf`	העלאת PDF או תמונה בשם שמתחיל ב-api- (cases:write)
`PUT /api/v1/uploads/<name>.pdf/replace`	החלפת PDF קיים בגרסה מושחרת; הגרסה הקודמת נשמרת כקובץ לא פומבי (uploads:replace)