An open API service indexing awesome lists of open source software.

https://github.com/shliamb/autoseopage

Automated SEO page generation through a smart prompt chain
https://github.com/shliamb/autoseopage

auto-site generator-site seo web website

Last synced: 12 months ago
JSON representation

Automated SEO page generation through a smart prompt chain

Awesome Lists containing this project

README

          

# SEO PageGen AI

## 📘 Автоматизированное написание SEO-текстов на основе Gemini

Этот проект — прототип системы генерации SEO-текстов для веб-страниц с использованием моделей Gemini (2.0, 2.5, 2.5 Pro). Его цель — снизить порог входа для тех, кто хочет автоматизировать рутинную часть создания текстового контента: SEO-структуру, ключевые фразы, заголовки и логическое ядро статьи.

### ⚙️ Быстрый старт

#### Клонируем репозиторий
> git clone https://github.com/shliamb/AutoSEOpage.git

#### Создаем виртуальное окружение (Python >= 3.9)
> python -m venv venv
> source venv/bin/activate
> .\venv\Scripts\activate на Windows

#### Устанавливаем зависимости
> pip install -r requirements.txt

#### Запускаем генерацию
> python run.py

---

### 🚀 Как это работает

1. 💬 Вы вводите запрос — описываете желаемую структуру текста в терминале:
Что за страница (каталог, информационная, лендинг), цель, стиль, ключевые идеи, ЦА (целевая аудитория), нужные ключевые слова, особенности, структура, объем и т.д.

2. ⚙️ Программа запускает цепочку простых агентов (не функции, а логические блоки):

#### Этапы внутри:

- Планировщик:
- Создает логический план текста
- Определяет целевую аудиторию и её страхи/мотивацию
- Предлагает крючки и удержание внимания
- Формирует ключевые фразы и семантическое ядро
- Всё сохраняется в JSON

- SEO-Писатель:
- Создает title, description, keywords, основное тело текста
- Стандартизирует структуру под поисковые системы

- Проверяющий / Ревизор:
- Сравнивает результат с вашим запросом, SEO-целями и логикой
- Если есть отклонения (мало ключевых слов, нелогичное повествование, неправильные заголовки) — требует переработку
- Цикл повторяется до достижения заданного качества (можно ограничить в config.json — параметр max_rewrites)

3. 🧾 Форматы вывода:
- Markdown
- HTML
- Чистый текст
- Пользовательский шаблон (ручное форматирование)

---

### 🛠 Конфигурация (config.py)

Всё основное настраивается через config.py, включая:

DEFAULT_MODEL_GEMINI = "gemini-2.5-flash"
> Выбор модели: "gemini-2.0", "gemini-2.5", "gemini-2.5-pro"

MAX_ITERATIONS = 2
> Кол-во переоценок-рерайтов текста

OUTPUT_FORMAT = "MARKDOWN"
> Варианты: "markdown", "html", "plain"

Так же, нужно заполнить .env по примеру .env-test. Аккаунт API можно зарегать тут - [@myapi_aibot](https://t.me/myapi_aibot)

---

### 📚 Пример запуска

python run.py

Пример ввода:

> Это товарная страница кофейного аппарата. Хочу показать преимущества, целевая аудитория — офисы, предпочтения — простота, стильно, экономия времени. Упомянуть бренды. Подчеркнуть надежность. Формат markdown. Тон — деловой.

Программа создаст:

- SEO-заголовок
- Текст с ключевыми словами
- Метаданные в JSON (для CMS или разработки)
- Оценит, всё ли покрыто, и перезапустит генерацию при необходимости

---

### 🧪 Почему это может быть полезно

Этот проект — не полноценный фреймворк и не «агенты» в техническом смысле. Он не универсален, прост, требует ввода руками. Вы можете получить аналогичный результат через OpenAI или через Gemini вручную — но с потерей структуры, проверки и стандартизации.

Здесь:
- Простая CLI
- Конфиг-файл
- Расширяемая структура
- Возможность встроить в пайплайн генерации или редактор

---

### 📌 Ограничения и возможные улучшения

- Нет веб-интерфейса
- Нет полноценного менеджмента контекста
- Никакой ML-логики — просто передача JSON + вызов API
- Проверка поверхностная, без глубокого анализа

Будет полезно, если ты хочешь:
Быстро создать черновик SEO-текста
- Видеть планку качества
- Дополнительно отладить ключевые блоки вручную

---

### 🙋‍♂️ Присоединяйся

Проект пока простой. Если ты хочешь его развивать — добавляй багфиксы, улучшай структуру агентов, делай web-обёртку, фреймворк или даже системную интеграцию.

---

## 🔗 TODO

- Сохранение результатов в файл
- Подключение к CMS
- Асинхронность генерации
- Поддержка других LLM-API (OpenAI, Claude и др.)
- Интерфейс на Flask или Streamlit

---

Если ты хочешь добиться высокой эффективности генерации текстов — не надейся исключительно на ИИ. Участвуй в процессе, редактируй вручную, будь критичен. Эта программа — повод начать, не более.