Google Search Console API لمنظومتك التقنية الخاصة
بيانات أداء Search Console لديك، عبر نقطة نهاية REST نظيفة.
اسحب النقرات والظهور وCTR ومتوسط الموضع — حسب الاستعلام والصفحة والنطاق الزمني — من Google Search Console مباشرةً إلى منتجك أو لوحة تحكمك أو مستودع بياناتك. اربط GSC مرة واحدة داخل SEOcrawl AI، وأنشئ مفتاح Bearer من لوحة التحكم، ثم استدعِ REST /v1 — دون أن تبني OAuth من Google بنفسك. إنها نفس طبقة البيانات القانونية التي تُشغّل MCP الخاصة بـ SEOcrawl AI، فتبقى أرقامك متطابقة دائمًا. أمّا تغطية الفهرسة وفحص عناوين URL فهما التاليتان على REST، وهما متاحتان اليوم عبر MCP.
حدّد النطاق مرة واحدة. ثم اسحب بيانات GSC.
أنشئ رمز Bearer من لوحة التحكم ومرّره في ترويسة Authorization. حدّد معرّف نطاق Search Console مرة واحدة، ثم استعلم عن أدائه عبر REST. ونفس المفتاح يعمل على واجهة REST API وخادم MCP معًا.
عنوان URL الأساسي
https://api.seocrawl.ai/v1ترويسة Authorization
Authorization: Bearer sca_live_your_token_hereكل مقاييس Search Console, عبر REST
النقرات والظهور وCTR ومتوسط الموضع — حسب الاستعلام والصفحة والنطاق الزمني والمقارنة بين الفترات. كل نقطة نهاية مرتبطة بنطاق: حدّد id النطاق أولًا ثم اقرأ بيانات Search Console الخاصة به. مجموعات GSC هذه حيّة في v1؛ أمّا تغطية الفهرسة وفحص عناوين URL فتكشفهما MCP اليوم وتصلان إلى REST تاليًا.
النطاقات
اسرد نطاقات Search Console المرتبطة بحسابك. استخدم id كل نطاق في مسار كل نقطة نهاية من نقاط GSC.
- GET
/v1/propertiesحيّة
الأداء
إجمالي النقرات والظهور وCTR ومتوسط الموضع لنطاق زمني — إضافةً إلى فرق المقارنة مع الفترة السابقة للنافذة نفسها.
- GET
/v1/properties/{id}/gsc/summaryحيّة - GET
/v1/properties/{id}/gsc/compareحيّة
الاستعلامات
استعلامات البحث التي تظهر بها مع مقاييس كل استعلام — والسجل اليومي الكامل لأي كلمة مفتاحية واحدة.
- GET
/v1/properties/{id}/gsc/top-keywordsحيّة - GET
/v1/properties/{id}/gsc/keywords/detailحيّة
الصفحات
عناوين URL الأفضل أداءً مع مقاييس Search Console — والتفصيل اليومي الكامل لأي صفحة واحدة.
- GET
/v1/properties/{id}/gsc/top-pagesحيّة - GET
/v1/properties/{id}/gsc/pages/detailحيّة
تغطية الفهرسة
ما يفهرسه Google فعليًا: حالات التغطية وسجل الفهرسة. متاحة اليوم في MCP؛ ونقاط نهاية REST قيد الطرح.
- GET
/v1/properties/{id}/indexation/summaryقريبًا
فحص عناوين URL
فحص لكل عنوان URL على حدة — التغطية وآخر زحف وحالة الفهرسة لصفحة واحدة. متاح الآن عبر MCP، وREST تاليًا.
- GET
/v1/properties/{id}/url-inspectionقريبًا
بيانات Search Console حقيقية, مصمّمة للمنتجات
أداؤك الفعلي في Google Search Console — لا تقديرات طرف ثالث — عبر واجهة REST نظيفة بمصادقة Bearer وحدود استخدام واضحة، تتشارك طبقة بيانات قانونية واحدة مع MCP حتى لا تتناقض الأرقام أبدًا.
مباشرةً من Search Console
النقرات والظهور وCTR ومتوسط الموضع مسحوبة من نطاق GSC الخاص بك — الأرقام الحقيقية التي يبلّغ عنها Google، لا تقديرات مُنمذجة أو مُستخلَصة. موارد يمكن التنبؤ بها، وأفعال قياسية، وJSON مُنمّط، وأخطاء متوافقة مع معايير RFC.
بلا بناء OAuth من Google
اربط Search Console مرة واحدة داخل SEOcrawl AI، ثم اقرأها بمفتاح Bearer واحد يبدأ بـ sca_live_. تجاوَز مشروع Google Cloud وشاشة الموافقة وتحديث الرموز — أنشئ المفاتيح وألغِها من لوحة التحكم خلال ثوانٍ.
طبقة بيانات قانونية واحدة
نقاط نهاية GSC في REST وأدوات GSC في MCP شقيقتان فوق المزوّد نفسه، وتطابقهما مُختبَر في CI. لوحة تحكمك ووكلاء الذكاء الاصطناعي لديك يرون دائمًا النقرات والظهور والمواضع ذاتها.
تفصيل حسب الاستعلام والصفحة
اقرأ إجماليات النطاق، أو انزل إلى التفاصيل: أهم الاستعلامات، أهم الصفحات، الاتجاه اليومي لكلمة مفتاحية واحدة، أو سجل عنوان URL واحد — نفس الأبعاد التي تراها في Search Console، لكن يمكن الوصول إليها عبر HTTP.
مقارنة الفترات مدمجة
اطلب نطاقًا عبر range (last_7_days أو last_28_days أو last_3_months أو last_year) أو تاريخَي from/to صريحين، وستصلك مقارنة الفترات جاهزة — بلا استدعاء ثانٍ وبلا حسابات تواريخ في العميل لتسوية الفروق.
حدود استخدام موثّقة
60 طلبًا في الدقيقة و1,000 طلب في الساعة لكل رمز، مع استجابات 429 + Retry-After واضحة. حدود REST رصيد منفصل عن استهلاك MCP — فلا يستنزف أحدهما حصة الآخر.
ابدأ في 3 خطوات
من الصفر إلى أول استدعاء لبيانات Search Console خلال دقيقتين.
أنشئ مفتاحًا
اربط Search Console داخل SEOcrawl AI، ثم افتح رموز API وأنشئ رمز Bearer. انسخه فورًا لأنه يظهر مرة واحدة فقط — ويبدأ بـ sca_live_.
حدّد النطاق
استدعِ GET /v1/properties مع Authorization: Bearer sca_live_… للحصول على id (وهو UUID) لنطاق Search Console الذي تريد قراءته.
اسحب بيانات GSC
استدعِ /v1/properties/{id}/gsc/summary?range=last_28_days للإجماليات، أو /gsc/top-keywords و/gsc/top-pages ونقاط /detail — ثم مرّر JSON مباشرةً إلى منتجك أو لوحة تحكمك أو مستودع بياناتك.
ثلاث طرق للوصول إلى بيانات Search Console
أرقام GSC نفسها بأسطح مختلفة — اختر ما يناسب طريقتك في البناء.
واجهة REST API
للمنتجات ولوحات التحكم وخطوط معالجة البيانات. مصادقة Bearer، وJSON مُنمّط، وحدود استخدام. أنت على هذه الصفحة الآن — وواجهة SEO API الكاملة تضيف نقاط نهاية للترتيب وظهور الذكاء الاصطناعي بالمفتاح نفسه.
خادم MCP
لوكلاء الذكاء الاصطناعي — يسأل Claude وChatGPT وأي عميل MCP بيانات Search Console لديك بلغة طبيعية.
استكشف MCPمن يبني على واجهة Search Console API
فرق تريد بيانات أداء GSC الحقيقية داخل أنظمتها الخاصة.
الوكالات
مرّر بيانات Search Console لكل عميل إلى بوابة مخصّصة أو Looker Studio أو طبقة التقارير لديك — مفتاح واحد وكل النطاقات، دون تصديرات يدوية من GSC.
شركات SaaS والشركاء
ادمج مقاييس Search Console الحيّة داخل واجهة منتجك. امنح مستخدميك النقرات والظهور والمواضع دون أن تصل واجهة Google بنفسك.
فرق البيانات
أنزِل نقرات GSC وظهورها وCTR والموضع في مستودع بياناتك وفق جدول منتظم. اربطها بالإيرادات وابنِ النماذج التي تحتاجها لوحاتك.
المطوّرون
أتمِت مراقبة الاستعلامات والصفحات، ونبّه عند تراجع الترتيب، وأوصِل بيانات Search Console بالتطبيقات وسير العمل التي تشغّلها بالفعل.
الأسئلة الشائعة
هل هذه واجهة Search Console الرسمية من Google؟
لا. هذه واجهة REST خاصة بـ SEOcrawl AI ومُصادَق عليها بـ Bearer، تعمل فوق بيانات Search Console التي ربطتها بحسابك بالفعل. تربط GSC مرة واحدة داخل SEOcrawl AI، ثم تقرأ النقرات والظهور وCTR والموضع عبر مفتاح sca_live_ واحد — دون إنشاء مشروع في Google Cloud أو شاشة موافقة OAuth أو منطق لتحديث الرموز. الأرقام هي أرقام Search Console الحقيقية الخاصة بك؛ والواجهة والمصادقة هما ما نقدّمه نحن.
ما بيانات Search Console التي يمكنني سحبها اليوم؟
إجماليات نطاق زمني (النقرات والظهور وCTR ومتوسط الموضع)، ومقارنات بين الفترات، وأهم استعلاماتك وصفحاتك مع مقاييسها، والتفاصيل اليومية الكاملة لكلمة مفتاحية واحدة أو صفحة واحدة — إضافةً إلى قائمة نطاقاتك المرتبطة. أمّا تغطية الفهرسة وفحص عناوين URL الحيّ فمتاحان الآن عبر MCP، ونقاط نهايتهما في REST قيد الطرح تاليًا. وإن كنت تفضّل قراءة الحساب بدل الاستعلام عنه، فإن تدقيق Google Search Console يغطي البيانات نفسها في مطالبة واحدة.
كيف أُصادِق؟
برمز Bearer. أنشئ مفتاح sca_live_ من لوحة التحكم وأرسله في كل طلب بالصيغة Authorization: Bearer <key>. لا توجد دورة OAuth لحسابك الخاص — الترويسة وحدها تكفي.
ما النطاقات الزمنية المدعومة؟
تقبل كل نقطة نهاية في GSC إمّا range (last_7_days أو last_28_days أو last_3_months أو last_year) وإمّا زوج from/to صريحًا. وتُرجع نقطة gsc/compare النافذة نفسها مقارنةً بالفترة السابقة لها، فتحصل على الفروق دون استدعاء ثانٍ.
ما حدود الاستخدام؟
60 طلبًا في الدقيقة و1,000 طلب في الساعة لكل رمز. وإن تجاوزتها حصلت على 429 مع ترويسة Retry-After. تُحتسب حدود REST بمعزل عن استهلاك MCP، فلا يتنافس الاثنان على الرصيد نفسه.
هل هما المفتاح نفسه والبيانات نفسها كما في MCP؟
نعم. رمز sca_live_ نفسه يصادق واجهة REST API وخادم MCP معًا، وكلاهما يقرأ من طبقة بيانات قانونية واحدة — لذا فإن أرقام Search Console التي تسحبها عبر REST مطابقة تمامًا لما يراه وكلاء الذكاء الاصطناعي لديك عبر MCP. بيانات اعتماد واحدة، وسطحان.
هل أنت جاهز للبناء فوق بيانات Search Console؟
اربط GSC مرة واحدة، وأنشئ مفتاح Bearer من لوحة التحكم، ونفّذ أول استدعاء REST لبيانات Search Console خلال دقائق — أو استكشف MCP لوكلاء الذكاء الاصطناعي.
