למה בכלל לחבר את זה
העבודה השוטפת מול Search Console מורכבת בעיקר משליפות חוזרות: לפתוח את הממשק, לבחור טווח תאריכים, לסנן, לייצא, ולהצליב באקסל מול הייצוא של החודש הקודם. הממשק מצוין לתחקור נקודתי, ופחות טוב לשאלות שמערבבות כמה חתכים - למשל ״אילו עמודים איבדו קליקים החודש למרות שהחשיפות עלו״.
חיבור של Claude Code ל-Search Console מזיז את השאלות האלה לשיחה. אתם מנסחים את השאלה במילים, Claude שולף את הנתונים דרך ה-API, מצליב אותם ומחזיר טבלה או מסקנה. זה לא קסם ולא מחליף חשיבה - זה מוריד את זמן השליפה מרבע שעה לחצי דקה, וזה ההבדל בין לבדוק פעם בחודש לבין לבדוק כשמתחשק.
למי זה מתאים במיוחד
איך החיבור עובד מתחת למכסה
MCP - ראשי תיבות של Model Context Protocol - הוא תקן פתוח שמאפשר לכלים חיצוניים להציג את היכולות שלהם למודל. שרת MCP הוא פשוט תוכנית קטנה שרצה אצלכם על המחשב, מכריזה על רשימת פעולות, ויודעת לבצע אותן מול שירות חיצוני. Claude Code לא יודע כלום על Search Console מראש; הוא רק רואה את רשימת הפעולות שהשרת מציג לו, וקורא להן לפי הצורך.
נקודה חשובה לשקט נפשי: אין כאן שרת ביניים של צד שלישי. קובץ ההרשאות יושב אצלכם בדיסק, השרת רץ אצלכם, והתקשורת היחידה שיוצאת החוצה היא מהמחשב שלכם אל גוגל.
מה צריך להכין מראש
- Claude Code מותקן ועובד בטרמינל.
- Python 3.11 ומעלה. גרסה 3.10 ומטה תיכשל, ולפעמים בשקט - זו המלכודת מספר אחת בהתקנה הזו.
- חשבון גוגל עם גישה לנכסב-Search Console. הרשאת צפייה מספיקה לכל השליפות; הרשאת בעלים נדרשת רק לפעולות כתיבה כמו הגשת sitemap.
- פרויקט ב-Google Cloud. אפשר ליצור חדש בחינם תוך דקה, לא נדרש כרטיס אשראי לשימוש ב-Search Console API.
התקנת uv
2 דקותuv הוא מנהל חבילות מהיר לפייתון. הוא נדרש כי הוא מביא איתו את uvx, שמריץ כלי פייתון בסביבה מבודדת בלי להתקין כלום גלובלית - כך שרת ה-MCP לא מתנגש בשום דבר אחר שמותקן אצלכם.
curl -LsSf https://astral.sh/uv/install.sh | sh
source $HOME/.local/bin/envpowershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"בודקים שההתקנה תפסה. אם הפקודה מחזירה מספר גרסה - אפשר להמשיך.
uv --versionהפעלת ה-API ויצירת הרשאות
8 דקותשני דברים קורים כאן: מפעילים את Search Console API בפרויקט הענן, ואז יוצרים את ההרשאות שיאפשרו לשרת לדבר איתו בשמכם.
קודם - איזה סוג הרשאות
יש שתי דרכים, והבחירה משנה כמה עבודה תהיה לכם בהמשך. ברוב המוחלט של המקרים OAuth הוא התשובה הנכונה.
הפעלת ה-API
- נכנסים ל-
console.cloud.google.comובוחרים פרויקט קיים או יוצרים חדש. - בחיפוש למעלה מקלידים
Search Console API, נכנסים לתוצאה ולוחציםEnable.
יצירת מזהה OAuth
עוברים ל-APIs & Services · Credentials, לוחצים Create credentials ובוחרים OAuth client ID. שדה סוג האפליקציה הוא הקריטי: בוחרים Desktop app, כי הקוד רץ אצלכם על המחשב ולא בשרת אינטרנט.
הקובץ הזה הוא סוד
~/.config/gsc/client_secrets.json, ובווינדוס תיקייה מקבילה תחת המשתמש שלכם.חיבור השרת ל-Claude Code
3 דקותעכשיו מוסיפים את השרת. שימו לב למבנה הפקודה: כל מה שלפני הסימן -- הוא דגלים של Claude Code עצמו, וכל מה שאחריו היא הפקודה שמריצה את השרת.
claude mcp add --scope user -e GSC_OAUTH_CLIENT_SECRETS_FILE=/Users/me/.config/gsc/client_secrets.json gsc -- uvx mcp-search-console--scope userהופך את השרת לזמין בכל הפרויקטים שלכם, לא רק בתיקייה הנוכחית. בלי הדגל הזה ברירת המחדל היאlocal, כלומר התיקייה הזו בלבד.-eמגדיר משתנה סביבה עבור השרת. הנתיב חייב להיות מלא ומוחלט - נתיב יחסי או~יגרמו לשרת ליפול בהפעלה.gscהוא השם שתראו בהמשך ב-/mcp. אפשר לבחור כל שם.
מלכודת שקטה בסדר הדגלים
-e. הדגל בולע ערכים מרובים, ולכן יקרא את השם כזוג KEY=value נוסף ויחזיר שגיאה. בפקודה למעלה שם השרת מופיע אחרי ערך המשתנה, וזה בדיוק הסדר הנכון.למי שהעדיף חשבון שירות, אלה שני משתני הסביבה במקום זה שלמעלה:
claude mcp add --scope user \
-e GSC_CREDENTIALS_PATH=/Users/me/.config/gsc/service_account.json \
-e GSC_SKIP_OAUTH=true \
gsc -- uvx mcp-search-consoleאימות שהחיבור באמת עובד
5 דקותקודם בודקים שהשרת נטען. הפקודה מציגה מצב בריאות לצד כל שרת מחובר.
$ claude mcp list Checking MCP server health… gsc: uvx mcp-search-console - ✔ Connected
בפעם הראשונה שתבקשו נתונים, ייפתח דפדפן ותתבקשו לאשר גישה לחשבון הגוגל שלכם. זה קורה פעם אחת; אחרי האישור נשמר טוקן והחיבור נשאר פעיל. עכשיו הבדיקה האמיתית - פותחים claude ומבקשים:
$ claude > תרשום לי את כל הנכסים שיש לי ב-Search Console ● gsc - list_properties sc-domain:example.co.il owner https://shop.example.co.il/ full
אם הרשימה חוזרת ריקה
מה אפשר לבקש עכשיו
השרת מציג כעשרים פעולות, אבל אין צורך לזכור אותן. מנסחים את השאלה בעברית, ו-Claude בוחר את הפעולה המתאימה. ארבע משפחות היכולות:
שאלות שכדאי להתחיל מהן
- ״השווה את 28 הימים האחרונים לתקופה המקבילה לפניהם, ותראה לי את עשרת העמודים שאיבדו הכי הרבה קליקים.״
- ״אילו שאילתות מדורגות במקומות 11 עד 20? אלה ההזדמנויות הקרובות ביותר לעמוד הראשון.״
- ״קח את חמש הכתובות האלה ובדוק לכל אחת אם היא באינדקס, ומה תאריך הסריקה האחרון.״
- ״איזה עמוד קיבל חשיפות גבוהות עם CTR נמוך במיוחד? שם כנראה יש בעיית כותרת או תיאור.״
הטריק שמכפיל את הערך
שש מלכודות שיעלו לכם שעה
- 01
פייתון 3.10 ומטה
השרת דורש 3.11 לפחות, והכישלון לא תמיד מפורש. אם השרת לא עולה, זו הבדיקה הראשונה: uv python list.
- 02
נתיב יחסי או ~ בקובץ ההרשאות
השרת רץ כתהליך נפרד עם תיקיית עבודה משלו. תמיד נתיב מלא ומוחלט, גם בווינדוס.
- 03
חשבון שירות שלא נוסף לנכס
זו הסיבה הנפוצה ביותר לרשימת נכסים ריקה. נכנסים ל-Search Console, הגדרות, משתמשים והרשאות, ומוסיפים את כתובת המייל של חשבון השירות.
- 04
שם השרת מיד אחרי -e
הדגל בולע ערכים מרובים ויקרא את השם כמשתנה סביבה. שמים את שם השרת אחרי ערך המשתנה.
- 05
Domain property מול URL prefix
שני נכסים שונים לחלוטין עם מספרים שונים. sc-domain:example.co.il מכסה את כל תת-הדומיינים והפרוטוקולים; https://example.co.il/ מכסה רק את המדויק.
- 06
השוואה לנתונים של אתמול
הנתונים האחרונים בגוגל אינם סופיים ומתעדכנים 2-3 ימים אחורה. להשוואות רציניות עוצרים את הטווח שלושה ימים לפני היום.
שאלות נפוצות
- האם החיבור הזה שולח את נתוני הנכס שלי לשרת חיצוני?
- לא. שרת ה-MCP רץ על המחשב שלכם כתהליך מקומי, ופונה ישירות ל-API של גוגל. הנתונים שחוזרים נכנסים לשיחה עם Claude, בדיוק כמו כל טקסט אחר שאתם מדביקים לשיחה. אין שרת ביניים של צד שלישי.
- צריך תוכנית בתשלום של Search Console?
- אין תוכנית בתשלום. Search Console ו-Search Console API הם בחינם. מה שכן קיים הן מגבלות קצב של ה-API, ובעבודה רגילה של איש SEO אחד לא תגיעו אליהן.
- אפשר לחבר גם את Google Analytics 4?
- כן, זה שרת MCP נפרד עם הרשאות משלו. העיקרון זהה: מפעילים את ה-API בענן, יוצרים הרשאות, ומוסיפים את השרת ב-claude mcp add. שווה לחבר את שניהם רק אחרי ש-Search Console עובד לכם חלק.
- למה הנתונים בשיחה לא זהים למה שאני רואה בממשק?
- שתי סיבות נפוצות: הנתונים הטריים ביותר בגוגל אינם סופיים ומתעדכנים 2-3 ימים אחורה, ובנוסף חשוב לוודא שאתם שואלים על אותו סוג נכס - Domain property מול URL prefix הם שני נכסים שונים עם מספרים שונים.
- זה מחליף כלי SEO כמו Screaming Frog או Ahrefs?
- לא. זה נותן גישה מהירה בשפה טבעית לנתונים שכבר יש לכם ב-Search Console, ומייתר ייצוא ידני לאקסל. ניתוח קישורים חיצוניים, סריקת אתר וניתוח מתחרים נשארים בכלים הייעודיים.
