miaqu766520-a11y/blogger-tracker

O que blogger-tracker faz?

Rastreador de criadores de código aberto (habilidade do Claude Code): monitore novos vídeos do Bilibili/Douyin através do seu navegador local gratuitamente - armazenamento local + relatórios Markdown, opção de envio para Feishu; mecanismo pago TikHub como backup.

Como funciona

Esta habilidade do Claude Code permite rastrear novos uploads de vídeos de criadores específicos no Bilibili e Douyin sem depender de APIs pagas. Ela usa seu navegador local (Chrome/Chromium) para simular uma sessão de navegação real, acessar os perfis dos criadores e extrair os metadados dos vídeos.

Fluxo básico

1. Configuração: Você fornece uma lista de URLs de perfis de criadores (Bilibili ou Douyin).
2. Execução: A skill abre cada perfil no navegador local, aguarda o carregamento e extrai os vídeos mais recentes (título, URL, data de publicação, visualizações, etc.).
3. Armazenamento: Os dados são salvos em arquivos JSON locais no diretório ~/.blogger-tracker/data/. Um relatório Markdown resumido é gerado em ~/.blogger-tracker/reports/.
4. Notificação (opcional): Se configurado, a skill envia um resumo dos novos vídeos para um webhook do Feishu (Lark) para integração com equipes.
5. Fallback: Se o navegador falhar (por exemplo, sem modo headless, versão incorreta), a skill automaticamente tentará usar a API paga do TikHub (requer chave de API).

Pré-requisitos

• Node.js v16 ou superior
• Chrome/Chromium instalado (navegador padrão do sistema)
• Claude Code com permissão para executar scripts Node.js
• (Opcional) Chave de API TikHub para fallback pago
• (Opcional) Webhook do Feishu para notificações

Instalação

A habilidade é executada diretamente via Claude Code. Nenhuma instalação global é necessária além do agente.

1. Certifique-se de que o Claude Code tem acesso ao sistema de arquivos local.

2. Se desejar usar o fallback pago, configure a variável de ambiente:

   export TIKHUB_API_KEY="sua_chave_aqui"
   

3. Para notificações no Feishu, defina:

   export FEISHU_WEBHOOK_URL="https://open.feishu.cn/open-apis/bot/v2/hook/..."
   

Uso

Monitorar um criador

/rastrear bilibili "https://space.bilibili.com/123456"

/rastrear douyin "https://www.douyin.com/user/MS4wLjABAAAA..."

Listar criadores rastreados

/rastrear lista

Gerar relatório Markdown

/rastrear relatório

Limpar dados locais

/rastrear limpar

Estrutura de arquivos

~/.blogger-tracker/
├── data/
│   ├── bilibili_123456.json
│   ├── douyin_user1.json
│   └── ...
├── reports/
│   └── relatorio_2025-03-26.md
└── config.json

Configuração

O arquivo config.json é gerado automaticamente na primeira execução. Você pode editá-lo manualmente:

{
  "creators": [
    {"platform": "bilibili", "url": "https://space.bilibili.com/123456"},
    {"platform": "douyin", "url": "https://www.douyin.com/user/MS4wLjABAAAA..."}
  ],
  "tikhub_api_key": "",
  "feishu_webhook_url": "",
  "interval_minutes": 60,
  "browser_path": "/usr/bin/chromium"
}

Licença

MIT - Código aberto para modificação e redistribuição.

Contribuição

Pull requests são bem-vindos! Veja o repositório original para issues e contribuições.