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

חיפוש רופאים, רשומות משרד הבריאות, תחומי עיסוק, ערים ובחירת המערכת — באמצעות אותם שירותי נתונים שמשמשים את האתר.

ממשק קריאה בלבד, ללא מפתח API. נקודת כניסה · OpenAPI 3.1 · llms.txt · מדריך מלא באנגלית · קטלוג הנתונים.

REST — גרסה 2

• חיפוש אחיד — /api/v1/search?q=cardiology
• שליפת רשומה לפי מזהה — /api/v1/fetch?id=methodology
• חיפוש לפי תחום, יישוב ואזור — /api/v1/find?specialty=cardiology
• בחירה מערכתית לפי תחום — /api/v1/recommendations?specialty=cardiology
• תחומים, התמחויות וכינויים — /api/v1/specialty-catalog
• ערים, אזורים ובתי חולים — /api/v1/city-catalog
• דפדוף במרשם המלא — /api/v1/registry/browse?limit=20

/api/v1/compare?ids=… משווה 2–4 מזהי רשומות. ההשוואה עובדתית ואינה קובעת מי רופא טוב יותר.

MCP

כתובת החיבור: /mcp באותו דומיין שבו פתחתם את האתר; הכתובת המלאה מופיעה ב־קובץ החיבור. Streamable HTTP, JSON-RPC 2.0, ללא מצב מתמשך. שולחים initialize, אחריו tools/list ו־tools/call. בקשת GET אינה מפעילה כלי.

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "find_doctors",
    "arguments": {
      "specialty": "cardiology",
      "region": "center",
      "limit": 20
    }
  }
}

כלים מומלצים

• search — Unified discovery by Hebrew name, licence or specialty (selected English specialty aliases supported). Returns separate record types, stable IDs and canonical/JSON/Markdown URLs. Results are not a headcount or quality ranking.
• fetch — Retrieve the stable record ID returned by search: registry:, profile:, editorial:, directory: or specialty:. Profile facts withhold unverified licence/certificates. No arbitrary URL fetching.
• find_doctors — Find source profiles by specialty, clinic city/area, or hospital. Use specialty_catalog and city_catalog. All cross-source joins remain candidates. certified_only searches official records separately; never combine certificate and location/hospital evidence without verified identity. No broader-specialty substitution for a requested subspecialty.
• doctor_profile — Get source-safe profile facts by entry ID. Licence/year remain unknown for unverified cross-source links.
• recommend_doctors — Editorial prominent-doctor selections for a reviewed specialty. Not clinical quality. With city/area/hospital filters returns separately labelled source matches; never assumes editorial identity linkage or creates a new top list.
• compare_doctors — Factual side-by-side retrieval of 2–4 distinct doctor record IDs. Missing is unknown; no winner or clinical ranking.
• specialty_catalog — Practice, listed-directory, certified and editorial taxonomies with aliases. These vocabularies are distinct.
• city_catalog — Practice cities, the six editorial areas and hospital labels. Hospital location is never clinic geography.

תאימות לכלים הקודמים

• search_register — Name or exact licence lookup in the complete supplied Ministry snapshot.
• list_registered_specialties — List the 78 official registered specialty names.
• check_registered_specialty — Check the official record; ambiguous names remain ambiguous.
• search_enriched_doctors — Search source groups by q, hospital, category, city, region or evidence grade. City uses practice localities only; city/region with category uses practice-derived tags. Alphabetical.
• get_enriched_doctor — Read one entry ID. Use profile for publishable facts; keep licence_candidate separate.
• list_enrichment_filters — List covered hospitals, practice localities with supplied codes, six editorial area mappings, and inferred category labels.
• list_expertise_categories — List the broader directory categories and membership counts.
• search_by_expertise — Search by category ID or exact Hebrew name; basis=listed by default.
• get_directory_doctor — Read a dir-prefixed directory record and unverified registry suggestions.
• list_specialties — List the 11 editorial editions and their actual coverage.
• search_doctors — Search the 110 selected editorial profiles, ordered by v2 editorial prominence.
• get_doctor — Read an editorial profile by ID or slug, with sources and score components.
• get_methodology — Read the active scoring weights, selection rules and limits.
• search_hospital_doctors — Search the earlier 1,913-record Sheba snapshot only. Prefer enriched search for seven hospitals.
• get_hospital_doctor — Read one sheba-prefixed record from that original snapshot.

חוזה התשובה

הממשקים החדשים מחזירים apiVersion, documentationUpdated, data, links, meta. MCP מחזיר גם structuredContent וגם טקסט JSON. limit הוא 1–100, ברירת המחדל 20; offset מדפדף בתוצאות. סכמות השדות והשגיאות נמצאות ב־OpenAPI.

רשומה, פרופיל וזהות

מזהים כוללים קידומת: registry לרשומה רשמית, profile לפרופיל מקור, editorial לבחירת המערכת. שם זהה אינו מאמת שזה אותו אדם. אין להשלים רישיון, שנת רישוי או התמחות מתוך licence_candidate אל profile.

certified_only מחפש ברשומות הרשמיות בלבד. שילוב עם עיר או בית חולים נדחה כשנדרש חיבור זהות שלא אומת. הערים נלקחות מרשומת העיסוק בלבד, לעולם לא מכתובת בית החולים.

ייצוגים וגילוי

search מחזיר קישור לדף, JSON ו־Markdown לכל תוצאה. אינדקס מפות האתר מפנה למפות מפוצלות. הממשקים זמינים לקריאה; עצם פרסומם אינו מבטיח חיבור אוטומטי או ציטוט על ידי סוכן.

תאריכים ושימוש נכון

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