איך מקבלים מפתח API של Skills IL?

היכנסו לפרופיל שלכם באתר agentskills.co.il, לחצו על "צור מפתח API", והעתיקו את המפתח. כל חשבון מקבל 500 קרדיטים חינם.

כמה עולה השימוש ב-API?

חיפוש סקילס (GET /v1/skills) הוא חינמי. הפעלת סקיל (POST /v1/invoke) עולה קרדיט אחד, ושאילתה סמנטית (POST /v1/query) עולה 3 קרדיטים. כל חשבון מקבל 500 קרדיטים חינם.

אילו נקודות קצה זמינות?

ה-API מציע 5 נקודות קצה: GET /v1/skills (רשימת סקילס), GET /v1/skills/:slug (פרטי סקיל), GET /v1/skills/autocomplete (השלמה אוטומטית), POST /v1/invoke (הפעלת סקיל), ו-POST /v1/query (שאילתה סמנטית עם חיפוש וקטורי).

האם ה-API תומך בעברית?

כן, ה-API מחזיר תוכן דו-לשוני (עברית ואנגלית) לכל הסקילס, כולל שמות, תיאורים, תגיות ותוכן.

מה מגבלת הקצב של ה-API?

ה-API מגביל בקשות לפי כתובת IP ומפתח API. אם קיבלתם שגיאת 429, המתינו מספר שניות ונסו שוב.

תיעוד API

שלבו את Skills IL באפליקציות שלכם עם ה-REST API שלנו

קבלת מפתח API

Base URL

כל בקשות ה-API צריכות להישלח ל-Base URL הבא:

https://api.agentskills.co.il

Authentication

אמתו בקשות באמצעות מפתח API ב-header של x-api-key. קבלו מפתח מהפרופיל שלכם.

x-api-key: sk-il_your_key_here

Credits

כל מפתח API מגיע עם מכסת credits. לכל endpoint עלות שונה ב-credits.

1ל-invoke

3ל-query

500credits חינם

Pagination

ה-endpoint של רשימת סקילס מחזיר תוצאות עם pagination. השתמשו ב-parameters page ו-pageSize כדי לנווט בין התוצאות.

שם	סוג	Default	תיאור
`page`	number	1	מספר עמוד (מתחיל מ-1)
`pageSize`	number	12	תוצאות לעמוד (מקסימום 50)

ה-response כולל את השדות total, page, pageSize ו-totalPages כדי שתוכלו לבנות pagination:

// Response from GET /v1/skills?page=2&pageSize=10
{
  "skills": [...],
  "total": 109,
  "page": 2,
  "pageSize": 10,
  "totalPages": 11
}

Endpoints

GET/v1/skillsPublic

רשימת סקילס

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

Parameters

שם	מיקום	סוג	חובה	תיאור
`q`	query	string	לא	מונח חיפוש
`category`	query	string	לא	סינון לפי slug של קטגוריה
`agent`	query	string	לא	סינון לפי סוכן נתמך
`tier`	query	string	לא	סינון לפי דרגת אמון (verified, trusted, community, under-review)
`tag`	query	string	לא	סינון לפי תגית
`sort`	query	string	לא	מיון: popular (ברירת מחדל), newest, highest-rated, views
`page`	query	number	לא	מספר עמוד (ברירת מחדל: 1)
`pageSize`	query	number	לא	תוצאות לעמוד, 1-50 (ברירת מחדל: 12)

Response

{
  "skills": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "slug": "israeli-tax-calculator",
      "name_en": "Israeli Tax Calculator",
      "name_he": "מחשבון מס ישראלי",
      "description_en": "Calculate Israeli income tax...",
      "description_he": "חישוב מס הכנסה ישראלי...",
      "category_slug": "tax-and-finance",
      "trust_score": 92,
      "trust_tier": "verified",
      "supported_agents": [
        "claude-code",
        "cursor",
        "github-copilot"
      ],
      "install_command": "npx skills-il add skills-il/tax-and-finance --skill israeli-tax-calculator",
      "install_count": 150,
      "view_count": 1200,
      "avg_rating": 4.5,
      "review_count": 12,
      "tags": [
        "tax",
        "finance"
      ],
      "author_github": "skills-il",
      "github_stars": 45,
      "version": "1.0.0"
    }
  ],
  "total": 109,
  "page": 1,
  "pageSize": 12,
  "totalPages": 10
}

דוגמאות

curl "https://api.agentskills.co.il/v1/skills?category=tax-and-finance&page=1&pageSize=10"

GET/v1/skills/:slugPublic

פרטי סקיל

החזרת פרטים מלאים של סקיל לפי slug.

Parameters

שם	מיקום	סוג	חובה	תיאור
`slug`	path	string	כן	מזהה הסקיל

Response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "slug": "israeli-tax-calculator",
  "name_en": "Israeli Tax Calculator",
  "name_he": "מחשבון מס ישראלי",
  "description_en": "Calculate Israeli income tax...",
  "description_he": "חישוב מס הכנסה ישראלי...",
  "content_en": "# Israeli Tax Calculator\n\n## Instructions...",
  "category_slug": "tax-and-finance",
  "trust_score": 92,
  "trust_tier": "verified",
  "trust_breakdown": {
    "codeQuality": 95,
    "permissions": 90,
    "dataHandling": 88
  },
  "supported_agents": [
    "claude-code",
    "cursor",
    "github-copilot"
  ],
  "install_command": "npx skills-il add skills-il/tax-and-finance --skill israeli-tax-calculator",
  "install_count": 150,
  "view_count": 1200,
  "avg_rating": 4.5,
  "review_count": 12,
  "tags": [
    "tax",
    "finance"
  ],
  "author_github": "skills-il",
  "github_stars": 45,
  "github_url": "https://github.com/skills-il/tax-and-finance/tree/master/israeli-tax-calculator",
  "problem_statement": {
    "he": "...",
    "en": "..."
  },
  "when_to_apply": {
    "he": [
      "..."
    ],
    "en": [
      "..."
    ]
  },
  "best_practices": {
    "he": [
      "..."
    ],
    "en": [
      "..."
    ]
  },
  "faq": {
    "he": [
      {
        "q": "...",
        "a": "..."
      }
    ],
    "en": [
      {
        "q": "...",
        "a": "..."
      }
    ]
  }
}

דוגמאות

curl "https://api.agentskills.co.il/v1/skills/israeli-tax-calculator"

GET/v1/skills/autocompletePublic

השלמה אוטומטית

קבלת הצעות השלמה אוטומטית לפי מונח חיפוש.

Parameters

שם	מיקום	סוג	חובה	תיאור
`q`	query	string	כן	מונח חיפוש
`limit`	query	number	לא	מספר הצעות (ברירת מחדל: 5)

Response

[
  {
    "slug": "israeli-tax-calculator",
    "name": {
      "he": "מחשבון מס ישראלי",
      "en": "Israeli Tax Calculator"
    },
    "category_slug": "tax-and-finance"
  },
  {
    "slug": "tax-bracket-advisor",
    "name": {
      "he": "יועץ מדרגות מס",
      "en": "Tax Bracket Advisor"
    },
    "category_slug": "tax-and-finance"
  }
]

דוגמאות

curl "https://api.agentskills.co.il/v1/skills/autocomplete?q=tax&limit=5"

POST/v1/invokeנדרש מפתח API1 credit

הפעלת סקיל

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

Parameters

שם	מיקום	סוג	חובה	תיאור
`skill`	body	string	כן	שם הסקיל (עד 200 תווים)
`input`	body	object	לא	פרמטרים ספציפיים לסקיל

Response

{
  "success": true,
  "data": {
    "...": "skill-specific output"
  },
  "metadata": {
    "skill": "israeli-tax-calculator",
    "executionTimeMs": 1250,
    "creditsCharged": 1,
    "creditsRemaining": 499
  }
}

דוגמאות

curl -X POST "https://api.agentskills.co.il/v1/invoke" \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk-il_your_key_here" \
  -d '{"skill": "israeli-tax-calculator", "input": {"salary": 25000}}'

POST/v1/queryנדרש מפתח API3 credits

שאילתה סמנטית

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

Parameters

שם	מיקום	סוג	חובה	תיאור
`query`	body	string	כן	שאילתה בשפה טבעית (עד 2000 תווים)
`input`	body	object	לא	פרמטרים שיועברו לסקיל שהותאם

Response

{
  "success": true,
  "data": {
    "...": "output from matched skill"
  },
  "metadata": {
    "matchedSkill": "israeli-tax-calculator",
    "similarity": 0.89,
    "executionTimeMs": 2100,
    "creditsCharged": 3,
    "creditsRemaining": 497
  }
}

דוגמאות

curl -X POST "https://api.agentskills.co.il/v1/query" \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk-il_your_key_here" \
  -d '{"query": "help me calculate Israeli taxes"}'

Response Format

כל ה-endpoints מחזירים JSON. תשובות מוצלחות כוללות את הנתונים ישירות. במקרה של שגיאה, מוחזר אובייקט עם הודעת שגיאה.

// Catalog (GET /v1/skills)
{ "skills": [...], "total": 109, "page": 1, "pageSize": 12, "totalPages": 10 }

// Invoke & Query (POST /v1/invoke, POST /v1/query)
{ "success": true, "data": {...}, "metadata": { "creditsRemaining": 499 } }

// Error
{ "error": "Invalid API key" }

Error Codes

קוד	שגיאה	תיאור
`400`	בקשה לא תקינה	פרמטרים חסרים או לא תקינים
`401`	לא מאומת	מפתח API חסר או לא תקין
`403`	אין קרדיטים	אין מספיק קרדיטים לביצוע הפעולה
`404`	לא נמצא	הסקיל המבוקש לא נמצא
`429`	חריגה ממגבלת קצב	יותר מדי בקשות. נסו שוב בעוד כמה שניות.

מוכנים להתחיל?

צרו מפתח API מהפרופיל שלכם והתחילו לבנות עם Skills IL.

לפרופיל