62 lines
3.2 KiB
Markdown
62 lines
3.2 KiB
Markdown
# [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)*
|