sara-dashboards/seo_artifacts/SEO-EKEEPA-099_action_report.md

3.2 KiB
Raw Permalink Blame History

[SEO-EKEEPA-099] استقرار پروتکل و مستندات llms.txt / llms-full.txt و رفع مسدودسازی بات‌های هوش مصنوعی در botChecker

مشخصه مقدار
شناسه اقدام SEO-EKEEPA-099
سطح اولویت P0
تیم مسئول تحویل تیم سئو و معماری هوش مصنوعی
فاز اسپرینت Sprint 0 (فوریتی / P0)
تخمین زمان 1.5 ساعت کاری
امتیاز RICE Score: 900000 (Reach: 450000, Impact: 3.0, Confidence: 1.0, Effort: 1.5)
ستون نظارتی C-Level Chief AI / Lead Architect
آدرس دقیق فایل و خطوط public/llms.txt (ایجاد فایل جدید)

💼 اثر تجاری و بیزینسی (Business Impact)

ارتقای شاخص‌های حیاتی سئو، کاهش نرخ پرش و جهش ترافیک هدفمند ارگانیک


🔍 تحلیل ریشه‌ای علت باگ (Root-Cause Diagnosis)

تابع botChecker.ts در سرور Next.js بات‌های جستجوی زنده (OAI-SearchBot, PerplexityBot, ClaudeBot, GPTBot) را در لیست سفید خود لحاظ نکرده و برای آن‌ها اسکلت خالی (Blank Shell) با dehydratedState تهی بازمی‌گرداند؛ علاوه بر آن فایل‌های ماشین‌خوان llms.txt و llms-full.txt در ریشه دامنه خطای ۴۰۴ دارند و پلتفرم اکیپا از استنادهای موتورهای جستجوی مولد پسا-۲۰۲۶ محروم مانده است.


⚠️ کد باگ‌دار فعلی (Current Problematic Code)

// src/utils/botChecker.ts - فقدان بات‌های هوش مصنوعی
const botUserAgents = [
  "googlebot", "bingbot", "yandex", ... // غیبت کامل OAI-SearchBot, PerplexityBot, ChatGPT-User
];
// درخواست به https://ekeepa.co/llms.txt کد HTTP 404 برمی‌گرداند

✅ کد اصلاح‌شده و آماده پروداکشن (Fixed Production Code)

// ۱. افزودن بات‌های جستجوی زنده به src/utils/botChecker.ts
const aiSearchBots = ["oai-searchbot", "perplexitybot", "chatgpt-user", "claudebot", "gptbot"];
// ۲. استقرار public/llms.txt
# Ekeepa Escape Room Marketplace
> The authoritative catalog for escape rooms and immersive entertainment in Iran.
- Tehran Escape Rooms: https://ekeepa.co/s/tehran
- Karaj Escape Rooms: https://ekeepa.co/s/karaj
- Realtime Catalog API & Sitemaps: https://ekeepa.co/sitemap/rooms.xml

🎯 معیار پذیرش و تضمین کیفیت (Definition of Done & QA Criteria)

درخواست curl با هدر User-Agent: OAI-SearchBot به صفحه کاتالوگ حاوی dehydratedState باشد و آدرس https://ekeepa.co/llms.txt کد ۲۰۰ برگرداند.


🧪 دستور اجرای تست مستقل در ترمینال (Verification Command)

curl -sI -A "OAI-SearchBot" https://ekeepa.co/robots.txt | grep -E "HTTP/|200" && curl -sI https://ekeepa.co/llms.txt | grep "200"

گزارش استخراج‌شده از داشبورد مهندسی و سئو اکیپا (seo.zebellkhan.com)