WeChat Article to Markdown
likemaoke/wechat-article-to-mdClaude Code скилл для парсинга статей из WeChat и конвертации в Markdown. Автоматически скачивает изображения, поддерживает режим Obsidian с форматом `![[filename]]`, помечает видео. Подходит для ведения базы знаний.
Установка
pip install requests beautifulsoup4README
Конвертер статей WeChat в Markdown
Claude Code Skill — парсинг статей из WeChat и конвертация в аккуратно отформатированные Markdown-документы с автоматической загрузкой изображений
Скилл для Claude Code, предназначенный для быстрого извлечения статей из WeChat и преобразования их в Markdown. Поддерживает автоматическую загрузку изображений, маркировку позиций видео и полную совместимость с Obsidian и другими инструментами для заметок.
✨ Возможности
- 📄 Автоматическое извлечение заголовка, автора и исходной ссылки
- 🖼️ Автоматическая загрузка всех изображений из статьи на локальный диск
- 🔄 Полная конвертация в Markdown (заголовки, списки, блоки кода, цитаты и т.д.)
- 🎥 Маркировка видео — автоматически отмечает позиции видео WeChat (с подсказкой просмотреть в оригинале)
- 📁 Гибкий вывод — поддержка обычного режима и режима Obsidian
- 🛠️ Очистка имён файлов — автоматическая обработка недопустимых символов
- 🤖 Интеграция с Claude Code — бесшовная работа в рабочем процессе Claude Code
- 💎 Глубокая адаптация под Obsidian — формат ссылок на изображения, оптимизированный для Obsidian
🚀 Быстрый старт
Установка зависимостей
pip install requests beautifulsoup4
Использование
# Обычный режим
python scripts/wechat_article_to_md.py https://mp.weixin.qq.com/s/xxxxxx
# Режим Obsidian (рекомендуется)
python scripts/wechat_article_to_md.py https://mp.weixin.qq.com/s/xxxxxx . -obsidian
# Указать директорию изображений для Obsidian vault
python scripts/wechat_article_to_md.py https://mp.weixin.qq.com/s/xxxxxx . -obsidian -img-dir /path/to/obsidian/vault/attachments/img💎 Полная совместимость с Obsidian
Почему рекомендуется режим Obsidian?
| Параметр | Обычный режим | Режим Obsidian |
|---|---|---|
| Формат ссылки на изображение |  | ![[filename.png]] |
| Директория изображений | images/ | attachments/img/ |
| Совместимость | Универсальный Markdown | Только Obsidian |
| Переносимость | Относительный путь фиксирован | Автопоиск по vault |
Сценарии использования с Obsidian
- 📚 Сохранение статей WeChat в базу знаний
- 🔍 Полнотекстовый поиск и двусторонние ссылки в Obsidian
- 📸 Изображения автоматически сохраняются в vault и доступны офлайн
- 🔄 Удобное редактирование и организация заметок
Быстрый старт с Obsidian
- Создайте Obsidian vault
- Укажите vault как директорию вывода скрипта
- Запустите с параметром
-obsidian— изображения автоматически сохранятся вattachments/img/ - Откройте сгенерированный
.md-файл в Obsidian — изображения отображаются корректно
📖 Подробная документация
См. SKILL.md для полного руководства по использованию.
🤖 Использование в Claude Code
После добавления скилла в Claude Code его можно вызвать в диалоге:
Пожалуйста, извлеки статью https://mp.weixin.qq.com/s/xxxxxx и конвертируй её в Markdown (режим Obsidian)
⚠️ Ограничения
- Видео WeChat нельзя скачать напрямую — скрипт добавляет маркер в позиции видео
- Загрузка изображений зависит от сетевого окружения
- Некоторые статьи WeChat могут иметь ограничения доступа
📄 Лицензия
MIT License
🤝 Участие в разработке
Issue и Pull Request приветствуются!