GitHub Referrers

Источники трафика репозиториев из GitHub API

Зачем это нужно

Этот skill извлекает данные об источниках трафика на ваши репозитории. Данные помогают:

• Узнать, откуда приходят посетители — какие сайты ссылаются на ваш проект
• Оценить эффективность продвижения — работает ли блог, документация, соцсети
• Найти неожиданные источники — иногда проекты находят через необычные каналы
• Проанализировать популярные страницы — какие файлы репозитория просматривают чаще

Что вы получите

Отчёт в форматах CSV и Markdown:

Файл	Содержание
github_referrers.*	Источники трафика: реферер, просмотры, уникальные
github_paths.*	Популярные страницы: путь, просмотры, уникальные

Зависимости

Требует установленный github-core

Установка

Skill совместим с различными AI-агентами. Примеры ниже даны для OpenCode — для других инструментов смотрите их документацию по установке skills.

# Сначала установите core
git clone https://github.com/prikotov/github-core.git .opencode/skills/github-core

# Затем этот skill
git clone https://github.com/prikotov/github-referrers.git .opencode/skills/github-referrers

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

Напрямую через PHP

# Базовые запросы
php .opencode/skills/github-referrers/referrers.php                    # все данные для default_repo
php .opencode/skills/github-referrers/referrers.php --repo my-project  # конкретный репозиторий

# С параметрами
php .opencode/skills/github-referrers/referrers.php -t referrers       # только источники
php .opencode/skills/github-referrers/referrers.php -t paths           # только страницы
php .opencode/skills/github-referrers/referrers.php -l 10              # топ-10 записей

Параметры

Параметр	Сокращение	Описание	Пример
--repo	-r	Репозиторий из конфига	--repo my-project
--type	-t	Тип данных: referrers, paths, all	-t referrers
--limit	-l	Лимит записей	-l 10

Ограничения API

⚠️ GitHub API ограничения:

• Данные доступны только за последние 14 дней
• Popular paths/referrers — максимум 10 записей
• Rate limit: 5000 запросов/час

Через агента

После установки skill агент автоматически узнаёт о нём. Примеры запросов:

Покажи источники трафика для репозитория playbook

Откуда приходят посетители на мои репозитории?

Какие страницы репозитория самые популярные? Сделай выгрузку.

Результаты

Отчёты сохраняются в папку с датой:

github_reports/
└── 2026-03-06/
    ├── github_referrers_2026-03-06_10-30-15.csv
    ├── github_referrers_2026-03-06_10-30-15.md
    ├── github_paths_2026-03-06_10-30-15.csv
    └── github_paths_2026-03-06_10-30-15.md

CSV открывается в Excel/LibreOffice, Markdown — в любом текстовом редакторе или напрямую в Obsidian.

---

Постановка задач, архитектура, ревью — Dmitry Prikotov, реализация — GLM-5 в OpenCode