Weixin MCP - Читатель статей WeChat

Минималистичный MCP, позволяющий большим языковым моделям читать статьи из официальных аккаунтов WeChat.

Основные функции

• 🎭 Эмуляция браузера: Использование Playwright для полной эмуляции среды браузера

• 📝 Извлечение контента: Автоматическое извлечение заголовка, автора, времени публикации и основного текста

• ⚡ Лаконичная реализация: Минимальный код для реализации основных функций

Related MCP server: WeChat Article Parser

Рабочий процесс

1. Пользователь отправляет URL и запрос большой языковой модели

2. Большая языковая модель вызывает инструмент MCP

3. MCP получает контент статьи и отправляет его большой языковой модели

4. Большая языковая модель выдает ответ на естественном языке на основе контента статьи

Технологический стек

• Python 3.10+

• fastmcp - MCP-фреймворк

• url-md (Rust, один бинарный файл) - защита от парсинга + извлечение в Markdown за один шаг

• pyyaml - парсинг frontmatter

Информация об обновлении v0.3.0: Уровень парсинга был упрощен с 4 подпроцессов agent-browser + парсинг BeautifulSoup до одиночного вызова url-md md <url>. Внутри url-md уже реализованы обход защиты от парсинга / извлечение основного текста WeChat / преобразование в Markdown / генерация frontmatter. Зависимости сокращены, поле content обновлено до формата Markdown (сохраняются ссылки на изображения / списки / иерархия заголовков). Интерфейс протокола MCP не изменился, существующие конфигурации Claude/Cursor не требуют корректировки.

Информация об обновлении v0.2.0: Предыдущее решение на базе Playwright было заблокировано усиленной защитой WeChat от парсинга (issue #3). Уровень парсинга был делегирован agent-browser (проект на Rust с открытым исходным кодом Apache-2.0). Начиная с v0.3.0, проект переведен на url-md.

Быстрый старт

1. Установка url-md (обязательно с v0.3.0)

# macOS / Linux
curl -fsSL https://raw.githubusercontent.com/Bwkyd/url-md/main/install.sh | bash

# Windows (PowerShell)
irm https://raw.githubusercontent.com/Bwkyd/url-md/main/install.ps1 | iex

# 验证
url-md --version

6 секунд от нуля до готовности. 7 МБ, один бинарный файл, не требует внешних зависимостей вроде Chrome (постоянные ссылки WeChat используют быстрый путь reqwest).

2. Установка зависимостей Python

pip install -r requirements.txt

3. Конфигурация

{
  "mcpServers": {
    "weixin-reader": {
      "command": "python",
      "args": [
        "C:/Users/你的用户名/Desktop/wx-mcp/wx-mcp-server/src/server.py"
      ]
    }
  }
}

Примечание: Пожалуйста, замените путь на путь к вашему реальному проекту.

Пример использования

Использование напрямую в Claude:

请帮我总结这篇文章：https://mp.weixin.qq.com/s/nEJhdxGea-KLZA_IGw9R5A

Claude автоматически вызовет инструмент read_weixin_article для получения контента статьи и его анализа.

Описание функций

read_weixin_article(url: str)

Чтение контента статьи из официального аккаунта WeChat.

Параметры:

• url: URL статьи WeChat, формат: https://mp.weixin.qq.com/s/xxx

Возвращаемое значение:

{
  "success": true,
  "title": "文章标题",
  "author": "作者名",
  "publish_time": "2025-11-05",
  "content": "# 文章正文\n\n![封面](https://...)\n\n段落内容...",
  "cover_url": "https://mmbiz.qpic.cn/.../wx_fmt=jpeg",
  "error": null
}

Начиная с v0.3.0, поле content представлено в формате Markdown (в v0.2.0 и ранее был обычный текст). Если последующий агент/промпт уже настроен на обработку обычного текста, вы можете удалить синтаксис Markdown перед возвратом или оставить его, так как LLM лучше понимают Markdown в исходном виде.

Меры предосторожности

• ⚠️ Только для личного обучения и исследований

• ⚠️ Соблюдайте условия обслуживания платформы WeChat

• ⚠️ Не рекомендуется выполнять частый парсинг (рекомендуемый интервал > 2 секунд)

• ⚠️ Не использовать в коммерческих целях