К основному содержанию
скилл CX Codex

bbc-skill — скилл для Claude Code: сбор комментариев и установка

Скилл bbc-skill для Claude Code собирает комментарии к видео Bilibili в JSONL и сводку JSON. Данные охватывают отдельное видео или ролики автора для анализа откликов.

MIT 313 установок ★ 107 обновлён 2026-10-16

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add Agents365-ai/365-skills --skill bbc-skill -a claude-code
Открыть на GitHub

Что делает bbc-skill

Скилл загружает комментарии верхнего уровня, ответы и закреплённые комментарии по BV-номеру или URL. Для пакетного сбора видео автора есть команда fetch-user. Результат включает comments.jsonl, summary.json, архив ответов API и файл состояния для продолжения сбора.

Нужны Python 3.9+ и действующая cookie Bilibili: её можно передать через --cookie-file или переменную $BBC_COOKIE_FILE; также поддерживаются $BBC_SESSDATA и обнаружение браузера с --browser auto. Перед загрузкой проверьте cookie командой python3 -m bbc cookie-check. Без действующей cookie запрос завершится ошибкой авторизации.

Команды только читают данные и не публикуют, не редактируют и не удаляют комментарии. Повторный сбор в ту же папку продолжает работу по .bbc-state.json; для повторной загрузки уже собранных страниц есть --force. Режим --dry-run показывает план запроса без обращения к сети.

Какие задачи решает

  • собрать комментарии и ответы к видео по BV-номеру
  • выгрузить комментарии с видео по URL
  • получить комментарии со всех видео автора по UID
  • пересобрать сводку из готового comments.jsonl
  • проверить, действует ли cookie Bilibili

Примеры запросов агенту

  • Собери комментарии к видео BV1NjA7zjEAU и сохрани результат в папку по умолчанию.
  • Выгрузи комментарии по этой ссылке Bilibili, затем кратко разберись в настроении аудитории.
  • Собери комментарии со всех видео автора с UID 441831884.

Как установить bbc-skill

1Через Skills CLI (Vercel)

npx skills add Agents365-ai/365-skills --skill bbc-skill -a claude-code

2Вручную: положить файлы

~/.claude/skills/bbc-skill/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/bbc-skill/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о bbc-skill

Как установить bbc-skill в Claude Code?

Выполните npx skills add Agents365-ai/365-skills --skill bbc-skill -a claude-code. Файл скилла находится по пути ~/.claude/skills/bbc-skill/SKILL.md.

Что делает bbc-skill?

Загружает комментарии к видео Bilibili, включая ответы и закреплённые, и сохраняет их в JSONL вместе со сводкой JSON. Данные можно использовать для анализа отзывов и тем обсуждения.

Что нужно для сбора комментариев?

Нужны Python 3.9+ и cookie авторизованного пользователя Bilibili. Перед сбором проверьте её командой python3 -m bbc cookie-check.

Исходный текст

SKILL.md · MIT
---
disable-model-invocation: true
name: bbc-skill
description: Fetch Bilibili (哔哩哔哩) video comments for UP主 self-analysis. Use when the user asks to collect, download, export, or analyze comments on a Bilibili video (BV号 / URL / UID). Produces JSONL + summary.json suitable for further Claude Code analysis (sentiment, keywords, audience trends). Read-only; does not post/edit/delete.
license: MIT
homepage: https://github.com/Agents365-ai/365-skills/tree/main/plugins/bbc/skills/bbc-skill
metadata: {"version":"1.0.4","openclaw":{"requires":{"bins":["python3"]},"emoji":"💬"},"hermes":{"category":"data","tags":["bilibili","comments","up主","scraping","chinese"]}}
---

# bbc-skill — Bilibili Comment Collector

Download all comments (top-level + nested + pinned) for a Bilibili video and
produce data that Claude Code can analyze downstream.

## Update check

Throttle to one check per 24 hours per installation; never mutate the skill directory without explicit user consent.

1. If `<this-skill-dir>/.last_update` exists and is less than 24 hours old, skip this step entirely.

2. Otherwise, fetch the latest tag from upstream:

   ```bash
   git -C <this-skill-dir> ls-remote --tags origin 'v*' 2>/dev/null \
     | awk '{print $2}' | sed 's|refs/tags/||' \
     | sort -V | tail -1
   ```

3. Compare with this skill's `metadata.version` from the frontmatter. If the upstream tag is strictly newer (semver), tell the user one line and ask:

   > "A newer version of this skill is available: vX.Y.Z → vA.B.C. Want me to `git pull`?"

   If they say yes, run `git -C <this-skill-dir> pull --ff-only`. Refresh `.last_update` either way so the prompt doesn't repeat for 24 hours.

4. If upstream is the same or older, refresh `.last_update` silently and continue.

5. On any failure (offline, not a git checkout — e.g. ClawHub-installed copy, read-only path, no permission), swallow the error silently and continue with the user's task. Do not mention the failure.

## When to use

Trigger this skill when the user:

- Asks to **get / fetch / download / export / collect / analyze** comments of a
  specific Bilibili video (BV 号, URL, or video page).
- Asks to analyze **audience feedback / sentiment / keywords / top comments /
  IP distribution** of their own Bilibili videos.
- Provides a Bilibili URL like `https://www.bilibili.com/video/BVxxxxxxxxxx/`.
- Mentions their UP主 UID and wants batch analysis across their videos.

Do **not** use for: posting / deleting comments, downloading videos, barrage
(弹幕), live stream data, or private messages.

## Prerequisites

1. **Python 3.9+** (stdlib only — zero pip install).
2. **Bilibili cookie**. The user must be logged in to bilibili.com. The
   recommended path:
   - Install the Chrome/Edge extension
     [**Get cookies.txt LOCALLY**](https://chromewebstore.google.com/detail/get-cookiestxt-locally/cclelndahbckbenkjhflpdbgdldlbecc)
     (open-source, fully local, no upload).
   - On a logged-in bilibili.com tab, click **Export** → save
     `www.bilibili.com_cookies.txt`.
   - Pass via `--cookie-file` or set `$BBC_COOKIE_FILE`.

   Alternatives:
   - `$BBC_SESSDATA` env var with just the SESSDATA value.
   - Browser auto-detection (Firefox / Chrome / Edge on macOS) via
     `--browser auto`. Works best for Firefox; Chrome/Edge needs a logged-in
     profile with cookies flushed to disk.

**Auth delegation (Principle 7):** the skill never runs OAuth flows. The human
is expected to log in via browser; the agent only consumes the resulting
cookie.

## Quick start

Before any fetch, verify the cookie works:

```bash
python3 -m bbc cookie-check
```

Success envelope (stdout):

```json
{"ok":true,"data":{"mid":441831884,"uname":"探索未至之境","vip":false}}
```

Fetch all comments for a single video:

```bash
python3 -m bbc fetch BV1NjA7zjEAU
```

Or pass a URL:

```bash
python3 -m bbc fetch "https://www.bilibili.com/video/BV1NjA7zjEAU/"
```

Output (default `./bilibili-comments/<BV>/`):

- `comments.jsonl` — one comment per line, flattened
- `summary.json` — video metadata + statistics + top-N
- `raw/` — archived API responses
- `.bbc-state.json` — resume state

## Commands

| Command | Purpose |
| --- | --- |
| `bbc fetch <BV\|URL>` | Fetch all comments for one video |
| `bbc fetch-user <UID>` | Batch fetch all videos of a UP主 |
| `bbc summarize <dir>` | Rebuild `summary.json` from existing `comments.jsonl` |
| `bbc cookie-check` | Validate cookie; print logged-in user |
| `bbc schema [cmd]` | Return JSON schema for commands (for agent discovery) |

Call `bbc <cmd> --help` or `bbc schema <cmd>` for full parameter details — do
not guess flag names.

## Agent contract

### Stdout vs stderr

- **stdout**: stable JSON envelope `{"ok":true,"data":...}` or
  `{"ok":false,"error":...}`. JSON is the default when stdout is not a TTY.
  Pass `--format table` for human-readable tables.
- **stderr**: human log lines + NDJSON progress events for long tasks.

### Exit codes

| Code | Meaning |
| --- | --- |
| 0 | Success |
| 1 | Runtime / API error |
| 2 | Auth error (cookie invalid / missing) |
| 3 | Validation error (bad BV number, bad flag) |
| 4 | Network error (timeout / retries exhausted) |

### Error envelope

```json
{
  "ok": false,
  "error": {
    "code": "auth_expired",
    "message": "SESSDATA 已过期,请重新登录 B 站",
    "retryable": true,
    "retry_after_auth": true
  }
}
```

Error codes: `validation_error`, `auth_required`, `auth_expired`, `not_found`,
`rate_limited`, `api_error`, `network_error`. See `bbc schema` for the full
contract.

### Dry-run

Every fetch command supports `--dry-run` to preview the planned request
without making network calls:

```bash
python3 -m bbc fetch BV1NjA7zjEAU --dry-run
```

### Idempotency

Re-running the same `fetch` command on the same output directory resumes from
`.bbc-state.json` (skips already-fetched pages). Pass `--force` to refetch.

## Analysis workflow (for the agent)

After `fetch` completes:

1. **Read `summary.json` first** (< 10 KB) to establish global context: video
   metadata, total counts, time distribution, top-N.
2. **For thematic analysis**, `Grep` or `head`/`tail` on `comments.jsonl` —
   each line is a flat JSON object, never load the whole file unless small.
3. **Typical analyses**:
   - Sentiment distribution → scan `message` by batch
   - Top fans → group by `mid`, count entries, aggregate `like`
   - UP 主互动 → filter `is_up_reply=true`
   - Audience geography → `ip_location` histogram
   - Feedback timeline → bucket `ctime_iso` by day/week

The `summary.json` schema is documented in `references/agent-contract.md`.
Run the skill against any video to produce a real sample locally.

## Safety tier

All commands are **read-only** (tier: `open`). No mutation, no deletion, no
message sending. Dry-run available for all fetch commands.

## References

- `references/api-endpoints.md` — Bilibili API fields used
- `references/cookie-extraction.md` — per-browser cookie decryption
- `references/agent-contract.md` — full envelope + schema contract

## Limitations

- `all_count` returned by the API includes pinned comments. Completeness
  check: `top_level + nested + pinned == declared_all_count`.
- Very old comments (>2 years) may return thin data if the user was deleted.
- Anti-bot: aggressive `--max` values or repeated runs may trigger HTTP 412.
  The client sleeps 1s between requests and backs off on 412.

© Agents365-ai · MIT · Agents365-ai/365-skills

Похожие скиллы

Все скиллы по теме «Браузер и парсинг» →
bilibili-source daymade Скилл bilibili-source для Claude Code и пяти других платформ: запрашивает реальные метаданные, статистику, теги и данмаку с Bilibili через API без авторизации. Работает с BVID, av-номерами, ссылками b23.tv и полными URL. CX Codex +1 471установок extracting-youtube-comments-for-research apidojo Скилл extracting-youtube-comments-for-research для Claude Code выгружает комментарии YouTube и анализирует тональность, вопросы и боли зрителей, чтобы понять, что аудитория пишет под видео. CX Codex +1 942установок scraping-youtube-comments apidojo Скилл scraping-youtube-comments для Claude Code собирает через Apify комментарии к роликам YouTube и передаёт агенту текст, авторов, лайки и даты. Собранные комментарии помогают анализировать мнения зрителей. CX Codex +1 925установок 222wcnm-bilistalkermcp 222wcnm MCP-сервер 222wcnm-bilistalkermcp подключает ИИ-агентов к профилям Bilibili для сбора видео, субтитров и динамики конкретного автора. Пригодится при анализе контента китайских креаторов. CX Codex +1 ★ 10звёзд репо bilibili-cli jackwener Скилл bilibili-cli даёт агенту CLI-доступ к Bilibili: видео, пользователи, поиск, тренды, динамика, избранное и взаимодействия. Вывод в YAML экономит токены. CX Codex +1 792установок python-executor 101-skills Скилл python-executor для Claude Code запускает Python 3.10 в изолированной песочнице inference.sh. Обрабатывает данные, парсит сайты, рендерит графики без доступа к системе. CX Codex +1 130 300установок

Из того же набора33

Весь набор →
yt2bb Скилл yt2bb для Claude Code превращает YouTube-видео в версию для Bilibili: распознаёт речь, готовит двуязычные субтитры и встраивает их в ролик. Адаптирует англоязычные видео для китайской аудитории. CX Codex +1 407установок obsidian-dev-rules Скилл obsidian-dev-rules для Claude Code содержит правила разработки плагинов на TypeScript и тем оформления для Obsidian. Помогает работать с Vault и Editor API без утечек памяти. CX Codex +1 317установок journal-meta Скилл journal-meta достаёт полные метаданные научной статьи по DOI, PMID, arXiv-идентификатору или названию: авторов, журнал, импакт-фактор, число цитирований и аннотацию. CX Codex +1 317установок xfetch Скилл xfetch для Claude Code выгружает публичные твиты, профили и лайки из X через локальный скрипт без платного API. Собирает архивы и отслеживает аккаунты. CX Codex +1 316установок scientific-thinking Скилл scientific-thinking для анализа научных данных, оценки доказательств и конструирования аргументов. Помогает различить факты от интерпретаций, рассмотреть альтернативные объяснения и сформулировать выводы с чётким указанием их границ. CX Codex +1 308установок grant-thinking-general Скилл grant-thinking-general разбирает идеи грантов и логику исследовательских заявок: помогает уточнить проблему, цели, инновацию и выполнимость. CX Codex +1 301установок figshare-skill Ищет и скачивает публичные материалы Figshare, а также управляет статьями и файлами аккаунта через API. Загружает наборы данных и публикует статьи. CX Codex +1 299установок scientific-thinking-biology Скилл scientific-thinking-biology для Claude Code структурирует анализ биологических исследований и генетических данных. Помогает отличить ассоциацию от причинности, маркер от драйвера. CX Codex +1 296установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой