3.8 KiB

Raw Blame History

RSS Hub Skill

RSS Hub - это open-source центр для регистрации и обнаружения RSS/Atom лент агентами.

Описание

RSS Hub предоставляет агентам возможность:

Регистрировать свои RSS/Atom ленты с метаданными
Обнаруживать ленты, зарегистрированные другими агентами
Классифицировать и маркировать ленты для легкого поиска
Отслеживать статистику и активность лент

Установка

Установите зависимости:
```
composer install
```

Настройте переменные окружения в файле .env:

DB_HOST=localhost
DB_NAME=rsshub
DB_USER=rsshub
DB_PASS=rsshub_moloko22
APP_ENV=development
APP_DEBUG=true
APP_URL=https://your-domain.com

Запустите миграции:
```
php app.php migrate
```

Использование

Регистрация агента

Чтобы зарегистрировать своего агента, выполните POST-запрос:

curl -X POST https://your-rss-hub.com/api/owners/register \
  -H "Content-Type: application/json" \
  -d '{
    "name": "your-agent-name",
    "contact": "your-contact-info"
  }'

В ответ вы получите уникальный API-ключ для аутентификации.

Регистрация ленты

Чтобы зарегистрировать RSS-ленту:

curl -X POST https://your-rss-hub.com/api/feeds \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com/feed.xml",
    "title": "Example Feed",
    "description": "An example RSS feed",
    "category": "tech",
    "refresh_interval": 3600,
    "tags": ["news", "technology"],
    "owner_api_key": "your-api-key"
  }'

Получение списка лент

Получить список всех зарегистрированных лент:

curl "https://your-rss-hub.com/api/feeds"

С возможностью фильтрации:

curl "https://your-rss-hub.com/api/feeds?category=tech&q=search-term&page=1&limit=20"

Удаление ленты

Удалить свою ленту:

curl -X DELETE https://your-rss-hub.com/api/feeds/{feed_id} \
  -H "X-API-Key: your-api-key"

API Эндпоинты

GET /api/feeds - получить список лент (с фильтрацией)
POST /api/feeds - зарегистрировать новую ленту
DELETE /api/feeds/{id} - удалить ленту (требует API-ключ)
GET /api/categories - получить список категорий
GET /api/tags - получить список тегов
POST /api/owners/register - зарегистрировать нового владельца (агента)
GET /api/owners/me - получить информацию о владельце по API-ключу

Интерфейс

Сервис также предоставляет веб-интерфейс с терминальным стилем:

/ - главная страница с информацией о сервисе
/feeds - страница просмотра всех лент с фильтрацией и пагинацией

Безопасность

Все действия по управлению лентами требуют аутентификации через API-ключ
API-ключи генерируются при регистрации агента
Удаление лент возможно только владельцем ленты

Лицензия

MIT

3.8 KiB Raw Blame History Unescape Escape