# Shirman Digest > Собирает дайджест AI & Tech трендов за день с shir-man.com и генерирует красивый HTML-отчёт с вкладками. Используй когда пользователь просит: дайджест, тренды, новости AI, что нового в tech, shirman, shir-man, ежедневный обзор технологий, tech digest, trend report — даже если не упоминает shir-man напрямую. - Skill: `jojoprison/shirman-digest` (Agent Skill, multi-file: 7 files) - Install (CLI): `npx skillmds@latest add jojoprison/shirman-digest` - Raw SKILL.md: https://api.skillmd.com/api/skills/jojoprison/shirman-digest/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Web & Frontend - Author: jojoprison (https://skillmd.com/u/jojoprison) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/jojoprison/shirman-digest --- # /shirman-digest — Ежедневный дайджест AI & Tech трендов Скилл автоматически собирает самое важное за день из мира AI и технологий с [shir-man.com/homepage/](https://shir-man.com/homepage/) — SPA-дашборда, агрегирующего GitHub Trending, Hacker News, Lobsters и AI-новости. Результат — готовый HTML-отчёт с 4 вкладками (без дублей), темой и ссылками на оригиналы. ## Зачем shir-man.com — это единственная точка входа для обзора трендов, но сайт SPA без API, данные не парсятся обычным скрапером. Скилл решает эту проблему: навигирует SPA через headless-браузер, параллельно читает статьи, и упаковывает всё в удобный отчёт. Без скилла это занимает 30-40 минут ручной работы. ## Алгоритм ### Шаг 1: Навигация по SPA (PinchTab) shir-man.com — SPA, поэтому нужен headless-браузер для навигации. PinchTab snapshot даёт accessibility tree с минимумом токенов. 1. `pinchtab_navigate(url: "https://shir-man.com/homepage/")` 2. `pinchtab_wait(seconds: 3)` — SPA грузит данные асинхронно 3. `pinchtab_snapshot(filter: "interactive", format: "compact")` — получить элементы (~19 нод vs 269 в полном DOM) 4. Переключить селекторы колонок: - Первая колонка: Midjourney → **GitHub** (самые быстрорастущие репозитории) - Третья колонка: Hype Replicate → **Lobsters** (экспертный контент) 5. Пройти вкладки внизу (кружочки-переключатели): - **Собрать:** Top signals, HN Best Show, GitHub Fastest rising, Popular - **Пропустить:** Virality map, Topic cloud (визуализации без парсируемых ссылок) 6. На каждой вкладке: snapshot → извлечь ссылки из StaticText нод > **Почему StaticText, а не eval?** PinchTab eval возвращает 404 (известный баг [#225](https://github.com/pinchtab/pinchtab/issues/225)). Данные извлекаются из snapshot accessibility tree — менее точно, но работает стабильно. ### Шаг 1.5: Извлечение URL из ссылок (ОБЯЗАТЕЛЬНО) PinchTab compact snapshot показывает текст ссылок, но НЕ href. Для каждой карточки в отчёте **ОБЯЗАТЕЛЬНА** кликабельная ссылка на оригинал. Без ссылки карточка бесполезна. **Способы получения URL:** 1. **GitHub репо** — URL строится из текста ссылки: `https://github.com/{link_text}` (текст уже содержит `owner/repo`) 2. **HN статьи** — домен виден в StaticText (напр. `GIST.GITHUB.COM`, `SAMHENRI.GOLD`). Для получения точного URL: - WebSearch: `"{заголовок статьи}" site:{домен}` — быстрый поиск точного URL - Или: `WebFetch("https://hn.algolia.com/api/v1/search?query={title}&tags=story")` — HN API возвращает `url` поле 3. **Lobsters статьи** — аналогично HN: домен виден, искать через WebSearch по заголовку + домену 4. **Show HN / Top Signals** — ссылки в карусели: кликнуть на link-ноду (`pinchtab_click`), snapshot → извлечь URL из адресной строки, `pinchtab_back` для возврата **Правило:** Если URL не удалось найти ни одним способом — пометить карточку `🔗 ссылка не найдена` и указать домен-источник как текст. Но стремиться к 100% покрытию ссылками. **Параллельность:** Запускать WebSearch/WebFetch для разрешения URL параллельно (до 8 одновременно), чтобы не тратить время. ### Шаг 2: Чтение статей (WebFetch) WebFetch в 5-10x эффективнее браузера для чтения контента: параллельный fetch без ожидания рендера. 1. Собрать уникальные URL из Шага 1.5 + snapshot'ов 2. Запустить WebFetch **параллельно** (до 8 одновременно) 3. Извлечь из каждой статьи: заголовок, ключевые тезисы, практическую ценность 4. При 404 или ошибке — пропустить без ретрая (URL может быть устаревшим) ### Шаг 3: Генерация HTML-отчёта Создать `claudedocs/shir-man-daily-report-YYYY-MM-DD.html`. **4 вкладки** (без дублей между разделами): | Вкладка | Контент | |---------|---------| | GitHub Trending | Быстрорастущие репозитории с описанием | | Hacker News | Лучшие обсуждения и статьи | | Lobsters | Экспертный технический контент | | AI Agents | Новые инструменты и фреймворки | **Правило дедупликации:** Каждая статья/проект появляется ТОЛЬКО в одной вкладке. Приоритет размещения: AI Agents (если про AI инструмент) → GitHub Trending (если репозиторий) → Hacker News (если HN источник) → Lobsters. Если статья появилась на HN и Lobsters — оставить там где больше очков. Deep Reads, Обзор, Попробовать — УБРАНЫ, их контент распределяется по 4 основным вкладкам. **Убранные вкладки и причины:** - ~~Обзор~~ — пересказ того что уже есть в остальных вкладках - ~~Deep Reads~~ — 100% дубли из HN/Lobsters/AI Agents - ~~Попробовать~~ — частично дубли AI Agents + GitHub Trending **Каждая карточка ОБЯЗАТЕЛЬНО содержит:** - Заголовок + **кликабельная ссылка на оригинал** (ОБЯЗАТЕЛЬНО! Без ссылки карточка бесполезна — см. Шаг 1.5) - Краткое описание (2-3 предложения) - Цветной бейдж источника - Блок «Ключевой вывод» для важных статей (выделенный фон, 1-2 предложения) **⚠️ НЕ допускается:** карточка без `` ссылки на оригинальный ресурс. Если URL не разрешён — использовать домен + заголовок в WebSearch. **Стиль отчёта:** ``` CSS variables → тёмная тема по умолчанию, светлая по toggle Переключатель темы → кнопка в шапке, состояние в localStorage Бейджи источников → GitHub: зелёный, HN: оранжевый, Lobsters: красный, AI: фиолетовый Layout → responsive CSS grid, max-width: 1200px, system-ui шрифт Градиенты → заголовок страницы и заголовки вкладок ``` **Язык:** Весь текст на русском. Технические термины (GitHub, Hacker News, API и т.д.) — в оригинале. **HTML skeleton** — структура отчёта: ```html AI & Tech Дайджест — YYYY-MM-DD
``` ### Шаг 4: Открыть отчёт ```bash open claudedocs/shir-man-daily-report-YYYY-MM-DD.html ``` ### Шаг 5: Очистка ```bash pkill -f pinchtab ``` PinchTab daemon и MCP-процессы остаются жить между сессиями — их нужно убивать после каждого запуска, иначе они накапливаются. ## Известные ограничения | Проблема | Причина | Workaround | |----------|---------|------------| | `pinchtab_eval` → 404 | Баг PinchTab [#225](https://github.com/pinchtab/pinchtab/issues/225) | Парсить данные из snapshot StaticText | | `pinchtab_type` не работает | macOS баг [#226](https://github.com/pinchtab/pinchtab/issues/226) | Не нужен для этого скилла (только клики) | | WebFetch 404 на некоторых URL | Устаревшие ссылки или paywall | Пропускать, не ретраить | | Snapshot refs меняются | Ожидаемое поведение после навигации | Пере-snapshot после каждого клика | | shir-man.com без API | SPA рендерит всё на клиенте | Только headless-браузер (PinchTab) |