convez.ai
PluginAutomaçãoIntermediário
oikon48

CC Doc Tracker

oikon48/cc-doc-tracker

Rastreador automático de mudanças na documentação do Claude Code

Ver no GitHub
BomPluginScore · de 0 a 100

Plugin que automatiza o rastreamento de mudanças na documentação oficial do Claude Code. Utiliza scraping baseado em Git para sincronizar, comparar e manter histórico completo de alterações em 4 execuções diárias, armazenando documentação pura em Markdown com metadados mínimos.

Instalação

$npx convez-ai oikon48/cc-doc-tracker

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
21
Forks
0
Acompanhando
1
Saúde
42%
Último commit
há 1 dia
Versão
—
Issues abertas
0
Contribuidores
2

Casos de uso

  • Monitorar atualizações de documentação do Claude Code em tempo real
  • Manter histórico Git completo de todas as mudanças de docs
  • Sincronizar múltiplas fontes (llms.txt e docs_map.md) com deduplicação automática

Veredito

Ferramenta especializada e bem estruturada para quem precisa rastrear mudanças na documentação do Claude Code. Implementação sólida em TypeScript com automação confiável (100% de sucesso), mas nicho específico limitado a usuários dessa plataforma.

README

A tradução para o português deste README ainda está na fila.

📚 Claude Code Documentation Tracker

日本語

Fetch Docs License: MIT

Automatically fetch and track changes in Claude Code's official documentation using Git-based scraping.

🎯 Features

  • 🔄 Automated Updates: 4 times daily (3:00, 9:00, 15:00, 21:00 JST)
  • 📝 Pure Markdown: Direct storage from source
  • 📊 Git-based Tracking: Complete change history
  • 🗑️ Full Sync: Adds new docs, updates existing, removes deleted
  • 🚀 TypeScript: Type-safe implementation
  • ⚡ Lightweight: Minimal dependencies

🔍 How It Works

System Architecture

1. Fetch Sources in Parallel
   ├── llms.txt (authoritative URL list)
   └── docs_map.md (titles and structure)

2. Merge & Dedupe
   ├── Combine both sources
   └── Remove duplicate URLs

3. Sync Local Files
   ├── Compare merged list with local files
   └── Delete orphaned files (not in sources)

4. Fetch Each Document
   ├── Direct Markdown fetch (no HTML conversion)
   ├── Add minimal frontmatter (title, source)
   └── Save to docs/en/[filename].md

5. Git Tracking
   ├── New files → "Added [file]"
   ├── Changed files → "Modified [file]"
   └── Deleted files → "Deleted [file]"

Data Flow

┌─ llms.txt (authoritative) ─┐   ┌─ docs_map.md (titles) ─┐
│  48 URLs                   │   │  44 URLs + metadata    │
└────────────┬───────────────┘   └──────────┬─────────────┘
             └──────────┬─────────────────────┘
                        ↓
               [Merge & Dedupe: 48 docs]
                        ↓
              [Sync: Remove orphaned files]
                        ↓
             [Fetch: Get Markdown directly]
                        ↓
               [Git: Track all changes]

Key Components

ComponentPurpose
llms.txtAuthoritative URL list (always up-to-date)
docs_map.mdTitles and structure (may become stale)
mergeDocLists()Merge and dedupe both sources
syncLocalFiles()Remove files not in merged list
fetchDoc()Fetch and save individual docs
metadata/Track statistics and failures

🤖 Automation

Runs automatically at:

  • 3:00 JST (18:00 UTC)
  • 9:00 JST (0:00 UTC)
  • 15:00 JST (6:00 UTC)
  • 21:00 JST (12:00 UTC)

Manual trigger: Actions tab → "Run workflow"

📈 Statistics

Current success rate: 100% (48/48 documents)

{
  "totalDocs": 48,
  "successfulFetch": 48,
  "failedFetch": 0,
  "deletedFiles": 0
}

🛠️ Tech Stack

  • node-fetch - HTTP client
  • dotenv - Environment variables
  • TypeScript 5.3
  • GitHub Actions

📝 License

MIT

⚠️ Known Limitations

  • claude_code_docs_map.md may become stale (last observed: 2025-11-06)
  • llms.txt is treated as the authoritative source for URLs
  • Subdirectory paths (e.g., sdk/migration-guide.md) are supported

⚠️ Disclaimer

Unofficial tool. Not affiliated with Claude Code or Anthropic.


Made with ❤️ for the Claude Code community

Ver o original no GitHub

Bom para

Relacionados