דוקומנטציה ואינטגרציה

AIqel הוא מנוע ידע headless. מערכות אחרות יכולות לשאוב ממנו ידע מעובד ולהזרים אליו תוכן חדש — דרך REST API, שרת MCP, או סקיל.

אימות — מפתח API

כל קריאה ל־/v1/* דורשת מפתח כ־Bearer token. המפתח נשמר כ־hash בלבד ומוצג פעם אחת בעת היצירה.

Authorization: Bearer <your-api-key>

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

שליפת ידע — חיפוש

POST/v1/search— חיפוש מאוחד בתמלולים, תרגומים, תובנות ותגיות
curl -X POST https://api-production-4978.up.railway.app/v1/search \
  -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' \
  -d '{ "q": "רעיונות גדולים" }'

כל תוצאה כוללת kind (insight/transcript/tag/item), הפריט המקורי, תקציר ותגיות עם סוג הישות (person/company/place/topic).

הזרמת תוכן — הוספת פריט לעיבוד

POST/v1/items— יוצר פריט ומריץ אותו בצינור

type: "audio" נכנס בשלב התמלול; type: "text" מדלג על תמלול ונכנס ישר לתרגום → תובנות → תיוג — אותו צינור בדיוק.

# אודיו
curl -X POST https://api-production-4978.up.railway.app/v1/items -H "Authorization: Bearer $KEY" \
  -H 'Content-Type: application/json' \
  -d '{ "type":"audio", "title":"פרק", "audioUrl":"https://...mp3", "targetLang":"he" }'

# טקסט
curl -X POST https://api-production-4978.up.railway.app/v1/items -H "Authorization: Bearer $KEY" \
  -H 'Content-Type: application/json' \
  -d '{ "type":"text", "text":"...", "targetLang":"he" }'
# → { "id": "...", "status": "..." }

שליפת פריט מעובד + polling

GET/v1/items/:id— פריט + תמלול + תרגומים + תובנות (עם תגיות)
GET/v1/items?status=&limit=— רשימת פריטים ל־polling
POST/v1/sources— הוספת מקור למעקב (פודקאסט / טלגרם / RSS)

שרת MCP

@aiqel/mcp חושף את ה־API ככלים ל־MCP (Claude Desktop / Claude Code / סוכנים). כל כלי עוטף endpoint אחד:

  • search_knowledge — חיפוש ידע
  • add_item — הוספת תוכן
  • get_item — שליפת פריט
  • add_source — הוספת מקור
  • list_items — רשימת פריטים
{
  "mcpServers": {
    "aiqel": {
      "command": "tsx",
      "args": ["apps/mcp/src/index.ts"],
      "env": {
        "AIQEL_API_URL": "https://api-production-4978.up.railway.app",
        "AIQEL_API_KEY": "aiqel_XXXX..."
      }
    }
  }
}

NotebookLM Enterprise

אפשר לשמור פריט או תובנה בודדת כ־מקור ב־NotebookLM Enterprise (Gemini Enterprise / Google Cloud Discovery Engine). התוכן נבנה כ־Markdown — כותרת, קישור למקור, התרגום לעברית (או התמלול), והתובנות עם התגיות שלהן — ומועלה ל־notebook מוגדר מראש.

GET/integrations— בודק אילו אינטגרציות מוגדרות (notebooklm.configured)
POST/items/:id/notebooklm— מעלה פריט שלם כמקור
POST/blocks/:id/notebooklm— מעלה תובנה בודדת כמקור
POST/items/:id/audio-overview— מייצר סקירה קולית (פודקאסט) בעברית מהפריט

הסקירה הקולית נוצרת אסינכרונית ב-NotebookLM (מספר דקות). ל-Google אין API להורדת האודיו — מקבלים קישור ל-Studio לניגון/הורדה. אפשר לכוון עם episodeFocus ו-languageCode.

הפעלה דורשת את משתני הסביבה הבאים ב־API. ללא הגדרה, ה־endpoints מחזירים 409 notebooklm_not_configured, וה־UI מציג במקום זאת כפתור "העתק ל-NotebookLM" שמעתיק את אותו Markdown ללוח.

NOTEBOOKLM_ENDPOINT_LOCATION=global   # us | eu | global
NOTEBOOKLM_PROJECT_NUMBER=123456789012
NOTEBOOKLM_LOCATION=global
NOTEBOOKLM_NOTEBOOK_ID=<notebook-id>
# credential — אחד מהשניים:
GOOGLE_APPLICATION_CREDENTIALS=/path/sa.json
# או inline:
GOOGLE_SERVICE_ACCOUNT_JSON={"type":"service_account", ...}

ה־service account מקבל access token בהיקף https://www.googleapis.com/auth/cloud-platform.

סקיל וקבצי תיעוד

SKILL.md מלמד סוכן איך להשתמש ב־AIqel — לחפש ידע, להוסיף תוכן ולשלוף תובנות — ומפנה לכלי ה־MCP ול־REST API. הורד או שתף את הקבצים:

  • סקיל — SKILL.md

    סקיל להטמעה בסוכן

    הורדה

  • תיעוד REST — API.md

    כל ה־endpoints

    הורדה

  • תיעוד MCP — MCP.md

    הגדרת שרת ה־MCP

    הורדה