מעקב חקיקה בכנסת

שלב 1: זיהוי השאילתה החקיקתית

שאלו את המשתמש מה הוא רוצה לעקוב אחריו:

הבהירו:

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

שלב 2: שאילתה ב-API הפתוח של הכנסת

כתובת בסיס: https://knesset.gov.il/Odata/ParliamentInfo.svc/

הכנסת מספקת API מסוג OData v3:

חיפוש הצעות חוק לפי מילת מפתח:

GET https://knesset.gov.il/Odata/ParliamentInfo.svc/KNS_Bill?$filter=substringof('מילת_מפתח',Name)&$top=20&$format=json

קבלת פרטי הצעת חוק:

GET https://knesset.gov.il/Odata/ParliamentInfo.svc/KNS_Bill(BILL_ID)?$format=json

רשימת ועדות:

GET https://knesset.gov.il/Odata/ParliamentInfo.svc/KNS_Committee?$filter=KnessetNum eq 25&$format=json

קבלת מידע על חבר כנסת:

GET https://knesset.gov.il/Odata/ParliamentInfo.svc/KNS_Person(PERSON_ID)?$format=json

סינון לפי טווח תאריכים:

GET https://knesset.gov.il/Odata/ParliamentInfo.svc/KNS_Bill?$filter=LastUpdatedDate ge datetime'2024-01-01T00:00:00'&$format=json

הערה: ה-API של OData מחזיר XML כברירת מחדל. תמיד הוסיפו $format=json לקבלת תגובות JSON.

הערה: נתוני הצבעות (רשומות הצבעה לפי חבר כנסת) אינם זמינים דרך ה-API הציבורי של OData.

טיפים:

• השתמשו ב-$filter, $select, $top, $skip, $orderby של OData לשאילתות
• שמות הצעות חוק הם בעברית -- חפשו עם מילות מפתח בעברית
• השתמשו ב-substringof('text', Field) לחיפוש טקסט (תחביר OData v3)
• דפדוף: השתמשו ב-$top ו-$skip עבור קבוצות תוצאות גדולות

שלב 3: מעקב אחר התקדמות הצעת חוק דרך הקריאות

החקיקה הישראלית עוקבת אחר תהליך מוגדר:

הערה: ה-API משתמש בערכי StatusID מספריים ולא בשמות סטטוסים. ערכי StatusID מרכזיים כוללים קודים להכנה, ועדה, קריאות, אישור ודחייה. בדקו את ישות KNS_BillStatus או את שדה StatusID בהצעות החוק לקודים המספריים בפועל.

מעקב אחר הצעת חוק ספציפית דרך השלבים:

import requests

bill_id = 12345
url = f"https://knesset.gov.il/Odata/ParliamentInfo.svc/KNS_Bill({bill_id})?$format=json"
response = requests.get(url)
bill = response.json().get("d", {})

print(f"הצעת חוק: {bill.get('Name')}")
print(f"StatusID: {bill.get('StatusID')}")
print(f"עדכון אחרון: {bill.get('LastUpdatedDate')}")
print(f"SubTypeDesc: {bill.get('SubTypeDesc')}")

שלב 4: מעקב אחר פעילות ועדות

ועדות הכנסת מטפלות בביקורת חקיקתית מפורטת:

שאילתת ועדות:

GET https://knesset.gov.il/Odata/ParliamentInfo.svc/KNS_Committee?$filter=KnessetNum eq 25&$orderby=Name&$top=10&$format=json

שלב 5: ניתוח רשומות הצבעה של חברי כנסת

בדיקת פעילות ודפוסי הצבעה של חברי כנסת:

קבלת רשימת חברי כנסת נוכחיים (כנסת ה-25):

GET https://knesset.gov.il/Odata/ParliamentInfo.svc/KNS_PersonToPosition?$filter=KnessetNum eq 25 and (PositionID eq 43 or PositionID eq 61)&$top=120&$format=json

קבלת פרטי חבר כנסת ספציפי:

GET https://knesset.gov.il/Odata/ParliamentInfo.svc/KNS_Person(PERSON_ID)?$format=json

ניתוח דפוסי הצבעה:

1. אחזרו רשימת הצבעות להצעת חוק או ישיבה
2. הצליבו עם שיוך מפלגתי
3. זהו דפוסי הצבעה של קואליציה מול אופוזיציה
4. עקבו אחר שיעורי היעדרות והימנעות

שיוכי מפלגות (סיעות):

שלב 6: התראות חקיקה למגזר הטכנולוגיה

מעקב אחר חקיקה רלוונטית לתעשיית הטכנולוגיה:

מילות מפתח לחיפוש חקיקת טכנולוגיה:

דוגמה: חיפוש הצעות חוק טכנולוגיות אחרונות:

import requests

keywords = ["סייבר", "פרטיות", "בינה מלאכותית", "טכנולוגיה"]
for kw in keywords:
    url = "https://knesset.gov.il/Odata/ParliamentInfo.svc/KNS_Bill"
    params = {"$filter": f"substringof('{kw}',Name)", "$top": 5, "$orderby": "LastUpdatedDate desc", "$format": "json"}
    resp = requests.get(url, params=params)
    bills = resp.json().get("d", {}).get("results", [])
    for bill in bills:
        print(f"[StatusID: {bill['StatusID']}] {bill['Name']}")

שלב 7: הצגת ממצאים

עצבו את התוצאות עבור המשתמש:

1. סיכום הצעת חוק: שם, מציע/ים, סטטוס נוכחי, פעולה הבאה הצפויה
2. ציר זמן: תאריכים מרכזיים מההצעה ועד השלב הנוכחי
3. פירוט הצבעות: ספירת בעד/נגד/נמנע עם פילוח מפלגתי
4. הערות ועדה: נקודות דיון ותיקונים רלוונטיים
5. הערכת השפעה: ניתוח קצר של משמעות הצעת החוק לתחום המשתמש

דוגמה 1: מעקב אחר הצעת חוק ספציפית

המשתמש אומר: "מה הסטטוס של הצעת חוק הגנת הפרטיות?" פעולות:

1. חיפוש הצעות חוק: $filter=contains(Name,'הגנת פרטיות')
2. קבלת פרטי הצעת החוק האחרונה התואמת
3. בדיקת שלב נוכחי (ועדה, קריאה וכו')
4. רשימת חברי כנסת מציעים ושיוך מפלגתי תוצאה: סטטוס הצעת חוק עם ציר זמן ופעולה הבאה הצפויה

דוגמה 2: ניתוח רשומת הצבעות של חבר כנסת

המשתמש אומר: "איך הצביע ח"כ X על הצעות חוק בתחום הטכנולוגיה בכנסת הנוכחית?" פעולות:

1. מציאת חבר הכנסת לפי שם ב-API של חברי כנסת
2. אחזור רשומת הצבעות לכהונת הכנסת הנוכחית
3. סינון הצבעות על הצעות חוק בתחום הטכנולוגיה (סייבר, פרטיות, AI)
4. חישוב סטטיסטיקות דפוסי הצבעה תוצאה: טבלת סיכום הצבעות עם פירוט בעד/נגד

דוגמה 3: מעקב אחר ישיבות ועדה

המשתמש אומר: "מה דנה ועדת המדע והטכנולוגיה בחודש האחרון?" פעולות:

1. שאילתת API של ועדות מסוננת לפי ועדת המדע והטכנולוגיה
2. סינון ישיבות לפי טווח תאריכים (30 יום אחרונים)
3. אחזור סדרי יום ונושאי הצעות חוק שנדונו
4. סיכום נושאים מרכזיים והחלטות תוצאה: רשימת ישיבות עם סעיפי סדר יום ותוצאות

דוגמה 4: התראת חקיקת טכנולוגיה

המשתמש אומר: "האם יש הצעות חוק חדשות בנושא רגולציית AI?" פעולות:

1. חיפוש הצעות חוק עם מילות מפתח: "בינה מלאכותית", "AI", "אלגוריתם"
2. סינון לפי הצעות אחרונות (90 יום אחרונים)
3. בדיקת סטטוס כל הצעת חוק תואמת
4. זיהוי שיוכי ועדות והצבעות קרובות תוצאה: רשימת הצעות חוק פעילות בתחום AI עם סטטוס ומציעים

סקריפטים

• scripts/fetch_knesset.py -- שאילתת ה-API הפתוח של הכנסת להצעות חוק, הצבעות, מידע על חברי כנסת וישיבות ועדות. תומך בפקודות משנה: bills, bill, members, committees, votes, tech-alerts. הרצה: python scripts/fetch_knesset.py --help

חומרי עזר

• references/knesset-api.md -- תיעוד מלא של נקודות קצה ב-API הפתוח של הכנסת כולל תחביר שאילתות OData, סוגי ישויות, קודי סטטוס ודפוסי שאילתה נפוצים. היעזרו בו בעת בניית קריאות API.

שגיאה: "לא הוחזרו תוצאות"

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

שגיאה: "חריגה ממגבלת קצב API"

סיבה: יותר מדי בקשות בפרק זמן קצר פתרון: הוסיפו השהייה של שנייה אחת בין קריאות API. השתמשו ב-$top ו-$skip לדפדוף במקום אחזור כל הרשומות.

שגיאה: "חבר כנסת לא נמצא"

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

שגיאה: "נתוני הצבעה לא זמינים"

סיבה: לא לכל ההצבעות יש פירוט לפי חבר כנסת ב-API פתרון: בדקו את אתר הכנסת ישירות עבור רשומת הצבעת מליאה הספציפית.