Larkin0302/mp-data

O que mp-data faz?

Habilidade do Claude Code para captura de dados de contas públicas do WeChat — faça login via QR Code e capture todos os artigos, gerando relatórios de análise visual.

Visão Geral

Esta skill utiliza Selenium + WebDriver para realizar login e captura automatizada de artigos de contas públicas (oficiais) do WeChat. Ela suporta:

• Login via escaneamento de QR Code — sem necessidade de nome de usuário/senha, seguro e confiável.
• Captura em lote de todos os artigos visíveis na lista de uma conta pública.
• Geração de relatórios de análise visual (gráficos de tendências, nuvem de palavras, gráfico de distribuição de datas).
• Exportação para CSV dos dados brutos.

Pré-requisitos

• Python 3.7+
• Google Chrome (ou Chromium)
• ChromeDriver (compatível com a versão do seu Chrome)
• O instalador de pacotes pip

Instalação

1. Clone este repositório:

   git clone https://github.com/Larkin0302/mp-data.git
   cd mp-data
   

2. Instale as dependências Python:

   pip install -r requirements.txt
   

3. Verifique se o ChromeDriver está no seu PATH ou coloque-o no diretório do projeto.

Como usar

No Claude Code

Você pode ativar esta skill em uma conversa do Claude Code com:

Use mp-data para capturar artigos da conta pública [NOME_DA_CONTA_PUBLICA].

O Claude irá:

1. Executar o script de login (você precisará escanear o QR Code com seu WeChat).
2. Navegar pela lista de artigos e extrair os dados.
3. Gerar um arquivo CSV com os dados e um relatório HTML com visualizações.

Manualmente (linha de comando)

python mp_data.py --account "NOME_DA_CONTA_PUBLICA"

Argumentos opcionais:

• --max-articles N: Limitar a captura a N artigos (padrão: todos).
• --output-dir DIR: Diretório de saída para CSV e relatório (padrão: ./output).
• --headless: Executar o Chrome em modo headless (sem interface gráfica).

Saída

• output/artigos.csv — Dados brutos (título, data, URL, resumo, etc.).
• output/relatorio.html — Relatório visual com:
  • Gráfico de tendência de publicação ao longo do tempo.
  • Gráfico de distribuição de datas (histograma).
  • Nuvem de palavras dos títulos.
  • Tabela interativa de artigos.

Estrutura do Projeto

mp-data/
├── mp_data.py          # Script principal de captura
├── generator.py        # Geração de relatório visual
├── requirements.txt    # Dependências Python
├── SKILL.md            # Documentação da skill
└── output/             # Diretório de saída (gerado)

Arquivos de Dependências (requirements.txt)

selenium==4.15.0
pandas==2.1.3
matplotlib==3.8.0
wordcloud==1.9.2
jieba==0.42.1

Observações

• Certifique-se de que sua conta do WeChat tenha permissão para acessar a conta pública alvo.
• A captura pode ser lenta dependendo do número de artigos (cerca de 1-2 segundos por artigo).
• Para grandes volumes, use --headless e --max-articles.
• A skill funciona no macOS e Linux. Testes no Windows não foram feitos.

Licença

MIT