GitHub Trending Skill

Скилл для Claude, предназначенный для парсинга трендовых репозиториев GitHub. Позволяет получать популярные проекты за разные периоды (день, неделя, месяц) и сохранять структурированные данные для дальнейшего анализа.

Возможности

• Парсинг за несколько периодов: получает трендовые репозитории за день, неделю и месяц.
• Расширенные метаданные: извлекает название репозитория, URL, описание, основной язык, общее количество звёзд, форков и прирост звёзд за период.
• Структурированный вывод: сохраняет все данные в единый файл github_trending.json с чёткой структурой.
• Временная метка обновления: фиксирует время последнего парсинга в выходном файле.

Установка

1. Клонируйте репозиторий (если применимо) или убедитесь, что файлы находятся локально.

2. Установите зависимости: Проект требует Python и следующих пакетов:

   • requests
   • beautifulsoup4

   Установите их с помощью pip:

   pip install -r requirements.txt

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

Как самостоятельный скрипт

Можно запустить парсер напрямую из командной строки:

Это выполнит следующие действия:

1. Спарсит страницы GitHub Trending для всех настроенных периодов.
2. Выведет прогресс и статистику в консоль.
3. Создаст или перезапишет файл github_trending.json в корне проекта.

Как скилл Claude

Репозиторий структурирован как скилл Claude.

• Определение скилла: файл SKILL.md содержит метаданные скилла и инструкции для Claude.
• Вызов: Claude будет использовать этот скилл, когда вы запросите «GitHub trending», «popular repos» и т.п.

Формат вывода

Файл github_trending.json имеет следующую структуру:

{
  "update_time": "YYYY-MM-DD HH:MM:SS",
  "data": {
    "daily": [
      {
        "name": "owner/repo",
        "url": "https://github.com/owner/repo",
        "description": "Project description...",
        "language": "Python",
        "stars": "10,500",
        "forks": "1,200",
        "stars_today": "150 stars today"
      },
      ...
    ],
    "weekly": [...],
    "monthly": [...]
  }
}

Структура файлов

• scripts/github_trending_scraper.py — основная логика Python-скрипта.
• SKILL.md — файл определения скилла, используемый Claude.
• requirements.txt — зависимости Python.
• github_trending.json — выходной файл с данными (генерируется автоматически).