Music DB — База музыкальных потоков (интернет-радио)

Скилл для сбора и управления базой интернет-радио потоков.

Источник данных

https://www.internet-radio.com/ — крупнейший каталог интернет-радиостанций.

Как работает парсинг

1. Сбор станций — парсинг страниц жанров (/stations/{genre}/), 2 страницы на жанр
2. Извлечение плейлистов — из каждой станции извлекается ссылка на .pls плейлист
3. Разрешение URL — из плейлиста формируется прямой URL потока (http://server:port/stream)
4. Проверка доступности — HEAD-запрос к прямому URL потока
5. Сохранение — данные сохраняются в state.json

Формат записи потока

{
  "url": "http://server:8000/stream",
  "name": "Station Name",
  "genre": "rock",
  "language": "en",
  "available": true,
  "source": "internet-radio.com",
  "station_url": "https://www.internet-radio.com/station/xxx/",
  "bitrate": 128,
  "listeners": 42,
  "audio_type": "mpeg",
  "genres": ["classic rock", "blues"],
  "added_at": "2026-05-23T18:00:00+00:00",
  "last_checked": "2026-05-23T19:00:00+00:00",
  "failed_checks": 0
}

Команды

# Показать количество потоков
python C:\Users\alter\.openclaw\skills\music-db\scripts\cli.py count

# Список потоков (по жанру)
python C:\Users\alter\.openclaw\skills\music-db\scripts\cli.py list rock

# Проверить доступность всех потоков
python C:\Users\alter\.openclaw\skills\music-db\scripts\cli.py check

# Добавить поток вручную
python C:\Users\alter\.openclaw\skills\music-db\scripts\cli.py add \x3Curl> \x3Cname> \x3Cgenre> [lang]

# Статистика по жанрам и языкам
python C:\Users\alter\.openclaw\skills\music-db\scripts\cli.py stats

# Наполнить базу с нуля (каждые 3 часа через cron)
python C:\Users\alter\.openclaw\skills\music-db\scripts\build_db.py

# Проверить доступность потоков (не удаляет, только отмечает)
python C:\Users\alter\.openclaw\skills\music-db\scripts\check_availability.py

Файлы

Периодические задачи

• Наполнение базы — каждые 3 часа (cron 0 */3 * * *)
• Проверка доступности — запускать через heartbeat или cron

Особенности

• Потоки не удаляются при недоступности, только отмечаются available: false
• Счётчик failed_checks увеличивается при каждой неудачной проверке
• Потоки с failed_checks >= 10 считаются «мёртвыми»
• Первичная проверка доступности — выборочно (первые 30 новых)