# Analytics Traffic

> Собирает публичные метрики трафика (views, comments, likes) для опубликованных постов. Парсит публичные страницы vc.ru; Дзен/Telegram — stub'ы. Не использует приватные admin API.

- Skill: `artemiimillier/analytics-traffic` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add artemiimillier/analytics-traffic`
- Raw SKILL.md: https://api.skillmd.com/api/skills/artemiimillier/analytics-traffic/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics
- Author: artemiimillier (https://skillmd.com/u/artemiimillier)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/artemiimillier/analytics-traffic

---


# analytics-traffic

## Когда использовать
Через 24 часа (или больше) после публикации. Собирает публичные метрики
для одного или нескольких URL'ов / директории `content/published/<platform>/`.
Возвращает JSON-отчёт для дальнейшего report-агента.

НЕ используй для:
- private dashboard метрик (нужны OAuth/cookies — это другой скилл)
- A/B тестов
- историй кликов / heat-maps

## Алгоритм

1. **Собери URL'ы.** Два режима:
   - Передан `--urls url1,url2` → используешь их напрямую.
   - Передан `--from-content content/published/vc/` → читаешь все `.md`
     с `published_url` во frontmatter, берёшь оттуда URL'ы.
2. **Запусти скрипт:**
   ```
   pnpm exec tsx skills/analytics-traffic/scripts/collect.ts --platform vc --urls "url1,url2"
   ```
   или
   ```
   pnpm exec tsx skills/analytics-traffic/scripts/collect.ts --platform vc --from-content content/published/vc/
   ```
   stdout JSON:
   ```json
   {
     "platform": "vc",
     "urls": [
       {"url": "...", "views": 234, "comments": 12, "likes": 5, "error": null},
       {"url": "...", "views": 0, "comments": 0, "likes": 0, "error": "..."}
     ],
     "collectedAt": "2026-05-21T08:00:00Z",
     "errors": []
   }
   ```
3. **Запиши отчёт** в output путь (markdown):
   ```markdown
   # Traffic report: <platform>
   Собрано: <date>

   | URL | Views | Comments | Likes | Δ vs prev |
   | --- | --- | --- | --- | --- |
   | ... | ... | ... | ... | ... |

   ## Insights
   - ...
   ```

## Поддерживаемые платформы

- **vc.ru** — реальный парсинг публичных страниц.
- **dzen** — TODO (заглушка возвращает `error: 'not-implemented'`).
- **tg** (Telegram) — TODO (требует API для publicly-видимых каналов).

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

- Только публично-видимые метрики. Reads, subscribers — недоступны без API.
- Может вернуть ошибку, если страница за paywall'ом / 404.
- Rate-limit'а на vc.ru — щадящий, но для bulk-сбора используй задержку.