WeChat Official Account Article Crawler Assistant

Usage Scenarios

• When users provide links starting with

  https://mp.weixin.qq.com/s/

  .
• When you need to save Official Account content as local Markdown documents.
• When you need to create structured summaries of long Official Account articles or extract image resources.

Core Features

1. Full-text Crawling: Automatically handles standard article streams and special "image page" formats.
2. Mixed Text & Image Layout: Maintains the original paragraph and image position relationships.
3. Local Image Storage: Automatically downloads remote images to the

   images/

   directory and updates the Markdown reference paths.
4. Structured Output: Automatically identifies heading levels (H1-H6) to generate easy-to-read documents.
5. Summary Generation: Automatically extracts the article's core viewpoints, key insights, and author information.
6. flomo Integration: Supports pushing generated article summaries to the flomo note-taking platform.

Directory Structure Description

• bin/main.py

  : Main execution script, supports optional flomo API URL parameter.

• utils/downloader.py

  : Responsible for HTML and image downloading.

• utils/parser.py

  : Responsible for content parsing, cleaning, and structuring.

• utils/flomo.py

  : Responsible for sending POST requests to flomo.

• images/

  : (Generated after running) Stores localized image resources.

Usage Examples

1. Local Crawl Only: Directly provide the Official Account link.
2. Push to flomo: Provide the link along with the flomo secret key (API URL), and the script will automatically complete the push.