# mingjinmuzi/wechat-monitor architecture

> Architecture diagram of the GitHub repository mingjinmuzi/wechat-monitor, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mingjinmuzi/wechat-monitor
- Repository: https://github.com/mingjinmuzi/wechat-monitor

## Overview

WeChat Monitor tracks public-account articles: users register accounts or search for recent posts, fetch selected articles, then inspect a style-analysis prompt or generate a report from stored article data. The runtime is a set of independent Node.js scripts sharing JSON files; it has no central application server. README describes AI analysis and visualized reporting, but the sampled analysis script only prepares a prompt and the sampled report generator writes Markdown, so those capabilities are represented at that documented level. Unsampled subsystems and their internal connections are not inferred.

Main entry points: [`scripts/monitor.js`](https://github.com/mingjinmuzi/wechat-monitor/blob/main/scripts/monitor.js) (Monitor accounts), [`scripts/fetch-article.js`](https://github.com/mingjinmuzi/wechat-monitor/blob/main/scripts/fetch-article.js) (Fetch article), [`scripts/fetch-article-full.js`](https://github.com/mingjinmuzi/wechat-monitor/blob/main/scripts/fetch-article-full.js) (Fetch full article), [`scripts/fetch-article-data.js`](https://github.com/mingjinmuzi/wechat-monitor/blob/main/scripts/fetch-article-data.js) (Fetch metrics)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_tracking["Account tracking"]
  node_account_setup["Register account<br/>[add-account.js]"]
  node_monitor["Monitor accounts<br/>[monitor.js]"]
  node_latest_search["Search latest"]
end

subgraph group_collection["Article collection"]
  node_basic_fetch["Fetch article<br/>[fetch-article.js]"]
  node_full_fetch["Fetch full article"]
  node_metrics_fetch["Fetch metrics"]
end

subgraph group_analysis["Analysis and reporting"]
  node_style_analysis["Style analysis<br/>[analyze-style.js]"]
  node_report["Generate report<br/>[generate-report.js]"]
end

subgraph group_state["Local data"]
  node_account_store[("Account records")]
  node_article_store[("Article records")]
  node_new_urls["New article URLs"]
  node_report_files["Markdown reports"]
end

node_user(("User"))
node_search_service{{"Tavily search"}}
node_wechat{{"WeChat articles"}}

node_user -->|"registers account"| node_account_setup
node_account_setup -->|"writes records"| node_account_store
node_user -->|"starts monitoring"| node_monitor
node_monitor -->|"reads and updates"| node_account_store
node_monitor -->|"checks known URLs"| node_article_store
node_monitor -->|"searches accounts"| node_search_service
node_monitor -->|"writes discoveries"| node_new_urls
node_user -->|"requests articles"| node_latest_search
node_latest_search -->|"searches WeChat"| node_search_service
node_search_service -->|"returns results"| node_latest_search
node_user -->|"fetches article"| node_basic_fetch
node_user -->|"requests full capture"| node_full_fetch
node_user -->|"requests metrics"| node_metrics_fetch
node_basic_fetch -->|"loads article page"| node_wechat
node_full_fetch -->|"loads article page"| node_wechat
node_metrics_fetch -->|"loads article page"| node_wechat
node_basic_fetch -->|"writes article"| node_article_store
node_full_fetch -->|"writes article"| node_article_store
node_metrics_fetch -->|"writes metrics"| node_article_store
node_user -->|"requests analysis"| node_style_analysis
node_style_analysis -->|"reads articles"| node_article_store
node_user -->|"requests report"| node_report
node_report -->|"reads articles"| node_article_store
node_report -->|"writes Markdown"| node_report_files

click node_account_setup "https://github.com/mingjinmuzi/wechat-monitor/blob/main/scripts/add-account.js"
click node_monitor "https://github.com/mingjinmuzi/wechat-monitor/blob/main/scripts/monitor.js"
click node_latest_search "https://github.com/mingjinmuzi/wechat-monitor/blob/main/scripts/get-latest-article.js"
click node_basic_fetch "https://github.com/mingjinmuzi/wechat-monitor/blob/main/scripts/fetch-article.js"
click node_full_fetch "https://github.com/mingjinmuzi/wechat-monitor/blob/main/scripts/fetch-article-full.js"
click node_metrics_fetch "https://github.com/mingjinmuzi/wechat-monitor/blob/main/scripts/fetch-article-data.js"
click node_style_analysis "https://github.com/mingjinmuzi/wechat-monitor/blob/main/scripts/analyze-style.js"
click node_report "https://github.com/mingjinmuzi/wechat-monitor/blob/main/scripts/generate-report.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_account_setup,node_monitor,node_latest_search,node_user toneBlue
class node_basic_fetch,node_full_fetch,node_metrics_fetch toneAmber
class node_style_analysis,node_report toneMint
class node_account_store,node_article_store,node_new_urls,node_report_files toneRose
class node_search_service,node_wechat toneIndigo
```

## Components

### Account tracking

- [Register account](https://github.com/mingjinmuzi/wechat-monitor/blob/main/scripts/add-account.js): `scripts/add-account.js`
- [Monitor accounts](https://github.com/mingjinmuzi/wechat-monitor/blob/main/scripts/monitor.js): `scripts/monitor.js`
- [Search latest](https://github.com/mingjinmuzi/wechat-monitor/blob/main/scripts/get-latest-article.js): `scripts/get-latest-article.js`

### Article collection

- [Fetch article](https://github.com/mingjinmuzi/wechat-monitor/blob/main/scripts/fetch-article.js): `scripts/fetch-article.js`
- [Fetch full article](https://github.com/mingjinmuzi/wechat-monitor/blob/main/scripts/fetch-article-full.js): `scripts/fetch-article-full.js`
- [Fetch metrics](https://github.com/mingjinmuzi/wechat-monitor/blob/main/scripts/fetch-article-data.js): `scripts/fetch-article-data.js`

### Analysis and reporting

- [Style analysis](https://github.com/mingjinmuzi/wechat-monitor/blob/main/scripts/analyze-style.js): `scripts/analyze-style.js`
- [Generate report](https://github.com/mingjinmuzi/wechat-monitor/blob/main/scripts/generate-report.js): `scripts/generate-report.js`

### Local data

- **Account records**
- **Article records**
- **New article URLs**
- **Markdown reports**

### Other components

- **User**
- **Tavily search**
- **WeChat articles**

## Connections

- User → Register account: registers account (evidence: `README.md`)
- Register account → Account records: writes records (evidence: `scripts/add-account.js`)
- User → Monitor accounts: starts monitoring (evidence: `README.md`)
- Monitor accounts → Account records: reads and updates (evidence: `scripts/monitor.js`)
- Monitor accounts → Article records: checks known URLs (evidence: `scripts/monitor.js`)
- Monitor accounts → Tavily search: searches accounts (evidence: `scripts/monitor.js`)
- Monitor accounts → New article URLs: writes discoveries (evidence: `scripts/monitor.js`)
- User → Search latest: requests articles (evidence: `README.md`)
- Search latest → Tavily search: searches WeChat (evidence: `scripts/get-latest-article.js`)
- Tavily search → Search latest: returns results (evidence: `scripts/get-latest-article.js`)
- User → Fetch article: fetches article (evidence: `README.md`)
- User → Fetch full article: requests full capture (evidence: `README.md`)
- User → Fetch metrics: requests metrics (evidence: `scripts/fetch-article-data.js`)
- Fetch article → WeChat articles: loads article page (evidence: `scripts/fetch-article.js`)
- Fetch full article → WeChat articles: loads article page (evidence: `scripts/fetch-article-full.js`)
- Fetch metrics → WeChat articles: loads article page (evidence: `scripts/fetch-article-data.js`)
- Fetch article → Article records: writes article (evidence: `scripts/fetch-article.js`)
- Fetch full article → Article records: writes article (evidence: `scripts/fetch-article-full.js`)
- Fetch metrics → Article records: writes metrics (evidence: `scripts/fetch-article-data.js`)
- User → Style analysis: requests analysis (evidence: `README.md`)
- Style analysis → Article records: reads articles (evidence: `scripts/analyze-style.js`)
- User → Generate report: requests report (evidence: `README.md`)
- Generate report → Article records: reads articles (evidence: `scripts/generate-report.js`)
- Generate report → Markdown reports: writes Markdown (evidence: `scripts/generate-report.js`)
