דלגו לתוכן המדריך

מדריך · Claude Code ו-SEO

לחבר את Claude Code ל-Search Console, ולהפסיק לייצא אקסלים

עשרים דקות הגדרה חד-פעמית, ואחר כך שואלים את נתוני החיפוש של האתר בשפה חופשית: איזה עמוד ירד החודש, אילו שאילתות תקועות בעמוד השני, ומה גוגל בכלל לא מכניס לאינדקס.

9 דקות קריאהעודכן אוגוסט 2026נכתב על ידי נעמי שרעבי, MOVE

למה בכלל לחבר את זה

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

חיבור של Claude Code ל-Search Console מזיז את השאלות האלה לשיחה. אתם מנסחים את השאלה במילים, Claude שולף את הנתונים דרך ה-API, מצליב אותם ומחזיר טבלה או מסקנה. זה לא קסם ולא מחליף חשיבה - זה מוריד את זמן השליפה מרבע שעה לחצי דקה, וזה ההבדל בין לבדוק פעם בחודש לבין לבדוק כשמתחשק.

למי זה מתאים במיוחד

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

איך החיבור עובד מתחת למכסה

MCP - ראשי תיבות של Model Context Protocol - הוא תקן פתוח שמאפשר לכלים חיצוניים להציג את היכולות שלהם למודל. שרת MCP הוא פשוט תוכנית קטנה שרצה אצלכם על המחשב, מכריזה על רשימת פעולות, ויודעת לבצע אותן מול שירות חיצוני. Claude Code לא יודע כלום על Search Console מראש; הוא רק רואה את רשימת הפעולות שהשרת מציג לו, וקורא להן לפי הצורך.

המחשב שלךClaude Codeהטרמינל שלךשרת MCPmcp-search-consoleרץ מקומית, תהליך נפרדstdioHTTPSOAuth tokenSearch Console APIsearchconsole.googleapis.comהנכס שאושר לחשבוןשאילתות, קליקים, חשיפות ומצב אינדוקס - חוזרים כטקסט לשיחה
תרשיםהחיבור כולו רץ מקומית. שרת ה-MCP הוא התהליך היחיד שמחזיק את ההרשאות שלכם, והוא פונה ישירות ל-API של גוגל.

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

מה צריך להכין מראש

  • Claude Code מותקן ועובד בטרמינל.
  • Python 3.11 ומעלה. גרסה 3.10 ומטה תיכשל, ולפעמים בשקט - זו המלכודת מספר אחת בהתקנה הזו.
  • חשבון גוגל עם גישה לנכסב-Search Console. הרשאת צפייה מספיקה לכל השליפות; הרשאת בעלים נדרשת רק לפעולות כתיבה כמו הגשת sitemap.
  • פרויקט ב-Google Cloud. אפשר ליצור חדש בחינם תוך דקה, לא נדרש כרטיס אשראי לשימוש ב-Search Console API.
1

התקנת uv

2 דקות

uv הוא מנהל חבילות מהיר לפייתון. הוא נדרש כי הוא מביא איתו את uvx, שמריץ כלי פייתון בסביבה מבודדת בלי להתקין כלום גלובלית - כך שרת ה-MCP לא מתנגש בשום דבר אחר שמותקן אצלכם.

macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh
source $HOME/.local/bin/env
Windows · PowerShell
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

בודקים שההתקנה תפסה. אם הפקודה מחזירה מספר גרסה - אפשר להמשיך.

בדיקה
uv --version
2

הפעלת ה-API ויצירת הרשאות

8 דקות

שני דברים קורים כאן: מפעילים את Search Console API בפרויקט הענן, ואז יוצרים את ההרשאות שיאפשרו לשרת לדבר איתו בשמכם.

קודם - איזה סוג הרשאות

יש שתי דרכים, והבחירה משנה כמה עבודה תהיה לכם בהמשך. ברוב המוחלט של המקרים OAuth הוא התשובה הנכונה.

מי צריך לגשת לנתונים?OAuthאני, עם חשבון הגוגל שלינכנסים פעם אחת בדפדפןרואה כל נכס שיש לך גישה אליואפס הגדרות הרשאה בנכסהבחירה הנכונה כמעט תמידחשבון שירותמכונה, בלי אדם שמתחברקובץ מפתח JSON, בלי דפדפןחובה להוסיף כמשתמש בכל נכסמתאים לאוטומציה ולשרתיםרק כשאין מי שילחץ ״אישור״
תרשיםחשבון שירות דורש להוסיף את כתובת המייל שלו כמשתמש בכל נכס בנפרד. OAuth פשוט יורש את ההרשאות שכבר יש לכם.

הפעלת ה-API

  • נכנסים ל-console.cloud.google.com ובוחרים פרויקט קיים או יוצרים חדש.
  • בחיפוש למעלה מקלידים Search Console API, נכנסים לתוצאה ולוחצים Enable.

יצירת מזהה OAuth

עוברים ל-APIs & Services · Credentials, לוחצים Create credentials ובוחרים OAuth client ID. שדה סוג האפליקציה הוא הקריטי: בוחרים Desktop app, כי הקוד רץ אצלכם על המחשב ולא בשרת אינטרנט.

console.cloud.google.com/apis/credentialsAPIs & Services · CredentialsCreate OAuth client IDApplication typeDesktop appזה הסוג הנכון - Claude Code רץ אצלך, לא בשרת webOAuth client createdclient_secret_xxx.jsonDownload JSON← את הקובץ הזה שומרים
איור של המסךמסך יצירת מזהה OAuth. בסיום מורידים את קובץ ה-JSON ושומרים אותו במקום קבוע - הוא לא ניתן להורדה חוזרת.

הקובץ הזה הוא סוד

קובץ ה-JSON שהורדתם שקול לסיסמה. לא מעלים אותו לגיט, לא שולחים בסלאק ולא שומרים בתיקיית הפרויקט. מקום טוב: ~/.config/gsc/client_secrets.json, ובווינדוס תיקייה מקבילה תחת המשתמש שלכם.
3

חיבור השרת ל-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
4

אימות שהחיבור באמת עובד

5 דקות

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

claude mcp list
$ claude mcp list
Checking MCP server health…

gsc: uvx mcp-search-console - ✔ Connected

בפעם הראשונה שתבקשו נתונים, ייפתח דפדפן ותתבקשו לאשר גישה לחשבון הגוגל שלכם. זה קורה פעם אחת; אחרי האישור נשמר טוקן והחיבור נשאר פעיל. עכשיו הבדיקה האמיתית - פותחים claude ומבקשים:

claude
$ claude
> תרשום לי את כל הנכסים שיש לי ב-Search Console

● gsc - list_properties
  sc-domain:example.co.il        owner
  https://shop.example.co.il/    full

אם הרשימה חוזרת ריקה

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

מה אפשר לבקש עכשיו

השרת מציג כעשרים פעולות, אבל אין צורך לזכור אותן. מנסחים את השאלה בעברית, ו-Claude בוחר את הפעולה המתאימה. ארבע משפחות היכולות:

5 כליםביצועים
קליקים, חשיפות, CTR ומיקום - לפי שאילתה, עמוד, מדינה או מכשיר
2 כליםהשוואת תקופות
מה השתנה בין החודש הזה לקודם, ואיזה עמוד אחראי לירידה
3 כליםאינדוקס
בדיקת URL בודד או אצווה, וזיהוי עמודים שגוגל לא מכניס לאינדקס
3 כליםמפות אתר
רשימת ה-sitemaps, מתי נקראו לאחרונה וכמה כתובות התגלו
תרשיםמה שנפתח ברגע שהחיבור עובד. השמות הטכניים הם רק לידיעה - בפועל שואלים במילים.

שאלות שכדאי להתחיל מהן

  • ״השווה את 28 הימים האחרונים לתקופה המקבילה לפניהם, ותראה לי את עשרת העמודים שאיבדו הכי הרבה קליקים.״
  • ״אילו שאילתות מדורגות במקומות 11 עד 20? אלה ההזדמנויות הקרובות ביותר לעמוד הראשון.״
  • ״קח את חמש הכתובות האלה ובדוק לכל אחת אם היא באינדקס, ומה תאריך הסריקה האחרון.״
  • ״איזה עמוד קיבל חשיפות גבוהות עם CTR נמוך במיוחד? שם כנראה יש בעיית כותרת או תיאור.״

הטריק שמכפיל את הערך

כשאתם עובדים בתוך תיקיית האתר, Claude יכול לקרוא גם את הקוד וגם את נתוני החיפוש באותה שיחה. במקום ״העמוד הזה איבד קליקים״ אפשר לבקש ״תבדוק למה, ותציע תיקון לכותרת ולתיאור בקובץ עצמו״ - אבחון ותיקון באותה נשימה.

שש מלכודות שיעלו לכם שעה

  1. 01

    פייתון 3.10 ומטה

    השרת דורש 3.11 לפחות, והכישלון לא תמיד מפורש. אם השרת לא עולה, זו הבדיקה הראשונה: uv python list.

  2. 02

    נתיב יחסי או ~ בקובץ ההרשאות

    השרת רץ כתהליך נפרד עם תיקיית עבודה משלו. תמיד נתיב מלא ומוחלט, גם בווינדוס.

  3. 03

    חשבון שירות שלא נוסף לנכס

    זו הסיבה הנפוצה ביותר לרשימת נכסים ריקה. נכנסים ל-Search Console, הגדרות, משתמשים והרשאות, ומוסיפים את כתובת המייל של חשבון השירות.

  4. 04

    שם השרת מיד אחרי -e

    הדגל בולע ערכים מרובים ויקרא את השם כמשתנה סביבה. שמים את שם השרת אחרי ערך המשתנה.

  5. 05

    Domain property מול URL prefix

    שני נכסים שונים לחלוטין עם מספרים שונים. sc-domain:example.co.il מכסה את כל תת-הדומיינים והפרוטוקולים; https://example.co.il/ מכסה רק את המדויק.

  6. 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, ומייתר ייצוא ידני לאקסל. ניתוח קישורים חיצוניים, סריקת אתר וניתוח מתחרים נשארים בכלים הייעודיים.

מקורות

רוצים שהאתר שלכם יופיע בתשובות של AI, לא רק בגוגל?

אנחנו בונים אתרים עם SEO ו-GEO מובנים - מחיר קבוע אחד, באוויר תוך 14 יום, בלי ריטיינר.