AI LLM Feed — llms.txt та Markdown-фід для OpenCart

Модуль AI LLM Feed додає в OpenCart 3 та ocStore 3 інструмент для створення структурованого опису магазину для мовних моделей і AI-агентів у форматі llms.txt та Markdown.

Розширення створює файли llms.txt і llms-full.txt, а також окремі Markdown-файли товарів, категорій, виробників та інформаційних сторінок. Оновлення обробляються через чергу та Cron, що дає змогу використовувати модуль у магазинах із великим каталогом.

Важливо про llms.txt

llms.txt — це запропонований відкритий формат представлення основної інформації про сайт для мовних моделей і AI-агентів. Він допомагає надати AI-системі зрозумілий опис сайту та структуровані посилання на важливі сторінки без необхідності аналізувати меню, JavaScript і всю HTML-розмітку.

Протокол llms.txt поки що не використовується всіма AI-системами. Його підтримка та практичне застосування продовжують розвиватися, тому публікація цих файлів не гарантує сканування сайту, появу його сторінок у відповідях AI або покращення позицій у пошуковій видачі.

Модуль не замінює XML та HTML Sitemap, robots.txt, canonical URL, структуровану розмітку Schema.org, звичайну SEO-оптимізацію, внутрішню перелінковку або доступний для користувачів вміст сторінок. Це додатковий технічний канал і підготовка сайту до подальшого розвитку AI-пошуку та AI-агентів.

Файл llms-full.txt у цьому модулі є розширеним індексом із посиланнями на вибрані розділи. Модуль навмисно не об’єднує весь каталог в один великий текстовий файл: повні дані зберігаються в окремих Markdown-файлах, що спрощує їх оновлення та використання.

Важливо про формування URL

У модулі передбачений власний механізм побудови посилань на товари, категорії, виробників та інформаційні сторінки. Для формування SEO URL використовуються стандартна таблиця seo_url, структура category_path і налаштування URL самого модуля.

Під час генерації модуль не викликає стандартний механізм переписування URL OpenCart і не залежить від виконання сторонніх SEO-модифікаторів. Це зменшує ризик помилок, пов’язаних із конфліктами або особливостями сторонніх SEO URL і мультимовних розширень.

Формат посилань потрібно налаштувати відповідно до реальної структури сайту: вибрати мовні папки або окремі домени, повний чи короткий шлях категорії та суфікс URL. Перед повною генерацією рекомендується відкрити попередній перегляд товару та переконатися, що сформовані посилання відповідають URL на вітрині.

Що вміє модуль

• Створювати кореневий файл llms.txt
• Створювати додатковий файл llms-full.txt
• Створювати окремі Markdown-файли товарів
• Створювати окремі Markdown-файли категорій
• Створювати окремі Markdown-файли виробників
• Створювати окремі Markdown-файли інформаційних сторінок
• Створювати індекси розділів і мовний індекс
• Вивантажувати всі, лише вибрані або не вивантажувати окремі типи сутностей
• Формувати окремий набір файлів для кожної активної мови магазину
• Додавати окремі назви, описи, статичний текст і Sitemap URL для кожної мови
• Додавати HTML та XML Sitemap окремо для llms.txt і llms-full.txt
• Автоматично додавати завдання до черги під час змін у каталозі
• Обробляти чергу пакетами через Cron

Режими вмісту

Модуль дозволяє вибрати спосіб формування файлів llms.txt і llms-full.txt.

• Тільки посилання — модуль створює індекси, файли сутностей і структуровані посилання
• Тільки статичний текст — створюються llms.txt і llms-full.txt із заданої назви, короткого опису, ручного тексту та Sitemap URL
• Статичний текст + посилання — ручний текст виводиться після короткого опису, а автоматично сформовані посилання розміщуються нижче

Для llms.txt і llms-full.txt передбачені окремі поля назви, короткого опису, тексту, HTML Sitemap та XML Sitemap. Значення задаються окремо для кожної активної мови.

Налаштування вивантаження

Для товарів, категорій, виробників та інформаційних сторінок можна вибрати один із трьох режимів.

• Вивантажувати всі записи
• Вивантажувати лише вибрані записи
• Не вивантажувати цей тип сутностей

Якщо для категорій або виробників вибрано режим «Лише вибрані», ці налаштування також застосовуються до товарів. Наприклад, можна створювати файли тільки для товарів із вибраних категорій або лише для товарів певних виробників.

Вміст Markdown-файлу товару

Залежно від налаштувань файл товару може містити:

• Назву та короткий опис товару
• Посилання на сторінку товару
• ID товару
• Модель та SKU
• Виробника
• Основну категорію
• Звичайну та акційну ціну
• Статус наявності
• Дату останнього оновлення
• Атрибути товару
• Доступні опції
• Очищений опис у текстовому або Markdown-форматі
• Основне зображення
• Додаткові зображення з налаштованим лімітом

Налаштування URL

Модуль дозволяє налаштувати формат посилань відповідно до структури конкретного сайту.

• Короткі SEO URL
• Повні URL із шляхом батьківських категорій
• URL товарів із повним шляхом категорії
• URL категорій із повною вкладеністю
• Закінчення URL: без суфікса, / або .html
• Файли тільки для основної мови або для всіх активних мов
• Мовні папки, наприклад /ru/ або /en/
• Окремі домени, піддомени або базові URL для різних мов

Внутрішній код мови OpenCart, наприклад uk-ua або en-gb, використовується тільки для зберігання файлів і не додається до публічних URL.

Приклади налаштування URL

Сайт без мовних папок

Якщо вивантажується тільки основна мова й вона не має мовної папки, публічні адреси матимуть такий вигляд:

• https://example.com/llms.txt
• https://example.com/llms-full.txt
• https://example.com/llms/products/145.md

Основна мова без папки, інші мови з папками

Якщо основна мова відкривається без префікса, а інші мови використовують папки, для основної мови потрібно залишити поле порожнім, а для інших указати відповідні значення.

• https://example.com/llms.txt
• https://example.com/ru/llms.txt
• https://example.com/en/llms.txt
• https://example.com/en/llms/products/145.md

Мови на окремих доменах або піддоменах

Якщо для мов використовуються окремі домени або піддомени, у модулі потрібно вказати базовий URL для кожної мови.

• https://example.com/llms.txt
• https://ru.example.com/llms.txt
• https://en.example.com/llms.txt

SEO URL із закінченням .html

Якщо сторінки магазину мають закінчення .html, його потрібно вказати в налаштуванні суфікса SEO URL.

• https://example.com/product-url.html
• https://example.com/category/product-url.html

Автоматичне оновлення файлів

Модуль використовує стандартні події OpenCart. Під час додавання, редагування, видалення або швидкої зміни статусу товару, категорії чи інформаційної сторінки відповідна сутність додається до черги. Зміни виробників також додаються до черги.

Під час зміни категорії модуль також додає до черги пов’язані товари та дочірні категорії. Під час зміни виробника до черги додаються його товари. Це необхідно, оскільки назва категорії, шлях та виробник використовуються у файлах товарів та індексах.

Прямі SQL-запити не викликають події OpenCart. Якщо сторонній імпорт змінює базу даних напряму, навіть оновлення date_modified саме по собі не створить завдання. Після такого імпорту потрібно вручну запустити повну звірку або повне додавання каталогу до черги.

Cron-завдання

Модуль надає окремі URL для різних сценаріїв роботи.

• Регулярний Cron без action — обробляє наявну чергу пакетами. Саме цей URL потрібно додати до планувальника з інтервалом приблизно 1–5 хвилин
• action=full — додає весь актуальний каталог до черги. Запускається вручну після встановлення або коли потрібно повністю сформувати файли заново
• action=index — додає до черги тільки кореневі файли та індекси. Використовується після зміни назв, описів, Sitemap URL, мовних URL або розміщення розділів
• action=reconcile — видаляє застарілі записи та додає актуальний каталог до черги. Запускається вручну після прямого імпорту, масового видалення або розсинхронізації файлів

URL із action=full, action=index і action=reconcile не потрібно додавати до звичайного регулярного Cron. Вони призначені для окремих ручних сценаріїв.

Черга, файли та журнал

• Перегляд завдань у черзі
• Пагінація та сортування черги
• Ручна обробка черги
• Видалення окремого завдання
• Перегляд створених файлів та їхніх публічних URL
• Пагінація та сортування списку файлів
• Видалення окремого файла
• Видалення всіх створених файлів
• Локалізований журнал операцій, змін та помилок
• Пагінація та сортування журналу
• Очищення журналу
• Захист від одночасного ручного та Cron-запуску обробника

Переваги

• Структуроване представлення каталогу для AI-систем
• Підготовка магазину до подальшого розвитку AI-пошуку та AI-агентів
• Не потребує API-ключів або підключення до платних AI-сервісів
• Автоматичне оновлення файлів після стандартних змін у каталозі
• Пакетна обробка великих каталогів через чергу та Cron
• Гнучкий вибір товарів, категорій, виробників та інформаційних сторінок
• Окремий вміст для кожної мови
• Власний механізм побудови посилань
• Підтримка мовних папок, доменів і піддоменів
• Контроль результатів через список файлів і журнал
• Вбудована докладна довідка з прикладами налаштування

Сумісність

• OpenCart 3.x / ocStore 3.x
• PHP 7.x–8.x
• Українська, англійська та російська локалізації
• Доступ до планувальника Cron
• Дозвіл на запис до каталогу storage OpenCart

Встановлення

1. Завантажте архів модуля через розділ Extensions / Installer
2. Перейдіть у Extensions / Modifications та натисніть Refresh
3. Перейдіть у Extensions / Extensions
4. Виберіть тип розширень Feeds / Канали просування
5. Знайдіть AI LLM Feed та натисніть Install

Рекомендований порядок налаштування

1. Увімкніть модуль
2. Виберіть створення llms.txt і, за необхідності, llms-full.txt
3. Виберіть режим вмісту
4. Заповніть назву, короткий опис, текст і Sitemap URL для потрібних мов
5. Виберіть типи сутностей і режим їх вивантаження
6. Налаштуйте вміст Markdown-файлів товарів
7. Налаштуйте мовні папки або домени відповідно до структури сайту
8. Налаштуйте повний шлях категорії та суфікс SEO URL
9. Перевірте сформований Markdown через попередній перегляд товару
10. Збережіть налаштування
11. Один раз додайте повну генерацію до черги
12. Налаштуйте регулярний Cron для обробки черги
13. Перевірте публічні URL llms.txt і llms-full.txt

Якщо сервер повертає помилку 403 під час відкриття llms.txt або llms-full.txt, може знадобитися додати виняток для цих файлів у стандартне правило FilesMatch файла .htaccess. Приклад правила наведений у довідці модуля.

Ліцензія

Ліцензія поширюється на один домен + його піддомени.