-> חזרה לדף הראשי
📧

Gmail Skill

שליחה וקריאת מיילים באמצעות Google Apps Script

זמן התקנה: 10-15 דקות

מה הסקיל הזה עושה?

הסקיל מאפשר לקלוד לקרוא ולשלוח מיילים מחשבון הג'ימייל שלכם. תוכלו לבקש "שלח מייל ליוסי" או "מה יש לי בתיבה?" וקלוד יטפל בזה!

📤
שליחת מיילים
עם תמיכה ב-HTML, CC ו-BCC
📥
קריאת תיבה
מיילים שלא נקראו + חיפוש
📝
יצירת טיוטות
שמירה לפני שליחה
✓
סימון כנקרא
עדכון סטטוס מיילים

1 מה צריך לפני שמתחילים?

חשבון גוגל

צריך חשבון גוגל עם Gmail פעיל. זה בחינם!

Node.js מותקן

בדקו שיש לכם Node.js:

node --version
💡

טיפ: הסקיל משתמש ב-clasp - הכלי הרשמי של גוגל לניהול Apps Script מהטרמינל.

2 התקנת Clasp

Clasp הוא CLI של גוגל לניהול פרויקטי Apps Script:

# התקנה גלובלית npm install -g @google/clasp

התחברות לגוגל

clasp login

ייפתח דפדפן להתחברות עם חשבון גוגל שלכם.

⚠️

הפעלת API: אם מקבלים שגיאה, היכנסו ל-הגדרות Apps Script והפעילו את "Google Apps Script API".

3 יצירת פרויקט Apps Script

  1. היכנסו לתיקיית הסקיל
    cd ~/.claude/skills/gmail/scripts
  2. צרו פרויקט Apps Script חדש
    clasp create --title "Gmail API" --type webapp

    זה יצור קובץ .clasp.json עם ה-ID שלכם

  3. העלו את הקוד לגוגל
    clasp push

4 הגדרת טוקן סודי

  1. פתחו את הפרויקט בדפדפן
    clasp open
  2. צרו טוקן אקראי
    openssl rand -hex 16

    העתיקו את התוצאה

  3. עדכנו את הטוקן בקוד

    בקובץ Code.gs, מצאו את הפונקציה setupToken() והחליפו את 'YOUR_SECRET_TOKEN_HERE' בטוקן שיצרתם.

  4. הריצו את הפונקציות

    בתפריט Run:

    • הריצו setupToken - לשמירת הטוקן
    • הריצו testAuth - לאישור הרשאות Gmail
  5. אשרו גישה ל-Gmail (OAuth)

    כשתריצו testAuth, גוגל יבקש הרשאות:

    • לחצו Review permissions
    • בחרו את חשבון הגוגל שלכם
    • תראו אזהרה "Google hasn't verified this app"
    • לחצו Advanced ואז Go to Gmail API (unsafe)
    • לחצו Allow לאישור גישה
💡

למה "unsafe"? הסקריפט לא פורסם ב-Google Marketplace. זה בטוח - זה הקוד שלכם שרץ על החשבון שלכם!

🔐

אבטחה: הטוקן מגן על ה-API שלכם. שמרו אותו במקום בטוח!

5 פריסה כ-Web App

בממשק של Apps Script:

  1. לחצו על Deploy > New deployment
  2. בחרו Web app
  3. הגדירו:
    • Execute as: Me
    • Who has access: Anyone
  4. לחצו Deploy והעתיקו את ה-URL

או דרך הטרמינל:

clasp deploy --description "Gmail API v1" clasp deployments # להעתקת ה-URL

6 הגדרת משתני סביבה

הוסיפו ל-~/.zshrc או ~/.bashrc:

export GMAIL_API_URL="https://script.google.com/macros/s/YOUR_DEPLOYMENT_ID/exec" export GMAIL_API_TOKEN="your-secret-token"

ואז:

source ~/.zshrc

7 בדיקה

# בדיקת קריאת תיבה curl -sL "$GMAIL_API_URL?token=$GMAIL_API_TOKEN&action=inbox&maxResults=1" # בדיקת שליחה (זהירות - באמת שולח!) curl -sL "$GMAIL_API_URL?token=$GMAIL_API_TOKEN&action=send&to=YOUR_EMAIL&subject=Test&body=Hello"

דוגמאות לשימוש

אחרי ההגדרה, פשוט תבקשו מקלוד:

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

פעולות זמינות

פעולה תיאור פרמטרים
send שליחת מייל to, subject, body
inbox קריאת תיבה maxResults, hours, query
draft יצירת טיוטה to, subject, body
markRead סימון כנקרא messageId
⚠️

חשוב: אין להשתמש באימוג'ים בנושא או בגוף המייל - הם נשברים בקידוד URL.

פתרון בעיות

"Invalid token"

וודאו שהטוקן ב-Code.gs תואם למשתנה הסביבה GMAIL_API_TOKEN.

"Script API not enabled"

היכנסו ל-הגדרות Apps Script והפעילו את ה-API.

אין הרשאות

הריצו את הפונקציה testAuth ב-Apps Script כדי לאשר הרשאות Gmail.

מיילים לא נשלחים

-> חזרה לדף הראשי קוד מלא ב-GitHub