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

62 lines
3.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# [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)
```typescript
// src/utils/botChecker.ts - فقدان بات‌های هوش مصنوعی
const botUserAgents = [
"googlebot", "bingbot", "yandex", ... // غیبت کامل OAI-SearchBot, PerplexityBot, ChatGPT-User
];
// درخواست به https://ekeepa.co/llms.txt کد HTTP 404 برمی‌گرداند
```
---
### ✅ کد اصلاح‌شده و آماده پروداکشن (Fixed Production Code)
```typescript
// ۱. افزودن بات‌های جستجوی زنده به 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)
```bash
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)*