DuckWu/xhs-claude-skills

O que xhs-claude-skills faz?

Plugin para extrair e transcrever posts do Xiaohongshu para o Obsidian, compatível com Claude Code e multiplataforma.

Visão Geral

Este skill permite que usuários do Claude capturem conteúdo de posts do Xiaohongshu (imagens, textos e vídeos) e os convertam em notas do Obsidian com transcrição automática por IA. Ideal para colecionar ideias, seguir tendências ou documentar pesquisas.

Funcionalidades

• Extração de conteúdo: Baixa posts do XHS a partir de URLs compartilháveis.
• Suporte a mídia: Imagens, carrosséis, vídeos e legendas.
• Transcrição por IA: Converte áudio de vídeos em texto usando Whisper ou APIs similares.
• Saída formatada: Gera arquivos Markdown prontos para o Obsidian com metadados.
• Multiplataforma: Funciona em desktop e celular.

Como Usar

1. Copie o link de um post do Xiaohongshu.
2. No Claude Code, execute o comando:

xhs extract "https://www.xiaohongshu.com/explore/..."

3. O skill irá baixar o conteúdo e perguntar se deseja transcrição.
4. O resultado será salvo na pasta obsidian-xhs/ dentro do seu vault do Obsidian.

Configuração

Defina as seguintes variáveis de ambiente ou configure no .env:

XHS_COOKIE=seu_cookie_para_autenticacao
WHISPER_MODEL=base  # opções: tiny, base, small, medium, large
OBSIDIAN_VAULT=/Users/seunome/Documents/Obsidian

Requisitos

• Python 3.8+
• requests, beautifulsoup4, yt-dlp
• (Opcional) openai-whisper para transcrição local

Instalação

pip install requests beautifulsoup4 yt-dlp openai-whisper

Exemplo de Saída

---
title: Post de exemplo do XHS
date: 2025-03-01
source: https://www.xiaohongshu.com/explore/...
tags: [exemplo, xhs, inspiração]
---

# Post de exemplo do XHS

Conteúdo extraído do post...

## Mídia

![Imagem 1](./media/img_001.jpg)

## Transcrição

(Texto transcrito do vídeo aparece aqui)

Contribuições

Pull requests são bem-vindos! Veja o repositório original para mais detalhes.

Licença

MIT