General Introduction
WeWe RSS is a free open source tool designed specifically for WeChat public number users. It grabs public number articles through the WeChat reading platform and generates RSS feeds, allowing users to view the content at any time with an RSS reader. This tool solves the problem of WeChat's public number information closure, supports private deployment, users can build their own services to ensure data security. weWe RSS provides regular updates and full-text output functions, simple operation and flexible deployment. According to official data, as of March 2025, the project has received more than 6,500 stars on GitHub, and is popular among technology enthusiasts and RSS users.
Function List
- Subscribe to WeChat: Add a public number via the WeChat Reading platform to generate an RSS feed.
- Multiple RSS formats: Support
.atom
,.rss
,.json
Three formats of output. - Historical Article Access: You can extract past content published by the public number.
- automatic update on a regular basis: Subscription feeds are regularly refreshed in the backend to keep content up to date.
- Full text output support: Provides full article content for in-depth reading.
- Title Filtering Function: Filter or exclude articles for specific keywords by parameters.
- OPML Export: Supports exporting all subscription sources as OPML files.
- Manually update subscriptions: Trigger instant updates from a single subscription source via the interface.
Using Help
Installation process
WeWe RSS supports multiple deployment methods, including Docker, local deployment and one-click deployment. Here are the detailed steps.
Method 1: Docker Deployment (recommended)
- Installing Docker
Make sure you have Docker installed on your device. Windows/Mac users can download Docker Desktop from the official website (https://www.docker.com/), Linux users run thesudo apt install docker.io
(Ubuntu for example). - SQLite version (simple deployment)
Enter the following command in the terminal to start it:
docker run -d --name wewe-rss -p 4000:4000 -e DATABASE_TYPE=sqlite -e AUTH_CODE=123567 -v $(pwd)/data:/app/data cooderl/wewe-rss-sqlite. cooderl/wewe-rss-sqlite: latest
-p 4000:4000
: Maps the port to local 4000.-e AUTH_CODE=123567
: Set up authorization codes that are customizable.-v $(pwd)/data:/app/data
: The data is saved in the current directory of thedata
Folder.
- MySQL version (stable deployment)
- Creating a Network: Run
docker network create wewe-rss
The - Starting MySQL::
docker run -d --name db -e MYSQL_ROOT_PASSWORD=123456 -e TZ='Asia/Shanghai' -e MYSQL_DATABASE='wewe-rss' -v db_data:/var/lib/mysql --network wewe-rss mysql:8.3.0 --mysql-native-password=ON
- Launch WeWe RSS::
docker run -d --name wewe-rss -p 4000:4000 -e DATABASE_URL='mysql://root:123456@db:3306/wewe-rss?schema=public&connect_timeout=30&pool_ timeout=30&socket_timeout=30' -e AUTH_CODE=123567 --network wewe-rss cooderl/wewe-rss:latest
- Checking the operation
Once deployed, open a browser and visithttp://localhost:4000
(local) or server IP plus port. If you see the interface, it is successful.
Approach II: Local deployment
- Installation of dependencies
Download Node.js (v18+ recommended) and pnpm (command:npm install -g pnpm
). - Cloning Code
git clone https://github.com/cooderl/wewe-rss.git
cd wewe-rss
- Configuration environment
Take SQLite as an example:
export DATABASE_URL="file:... /data/wewe-rss.db"
export DATABASE_TYPE="sqlite"
rm -rf apps/server/prisma
mv apps/server/prisma-sqlite apps/server/prisma
npx prisma generate --schema apps/server/prisma/schema.prisma
npx prisma migrate deploy --schema apps/server/prisma/schema.prisma
- Build and run
pnpm install && pnpm run -r build && pnpm run start:server
The pm2 daemon is recommended:pm2 start pnpm -- start:server
The
Method 3: One-click deployment
- To deploy via Zeabur (https://zeabur.com/templates/DI9BBD) or Railway (https://railway.app/), simply enter the project URL and follow the prompts.
How to use
After deployment, the operation of WeWe RSS is divided into two steps: account login and subscription addition.
Add Account
- show (a ticket)
http://localhost:4000
(or server address). - Click "Account Management" > "Add Account".
- Scan the QR code with WeChat and log in to your WeChat Reading account. If the prompt is invalid, you need to scan the code again.
Subscribe to Public
- Click "Public Source" > "Add".
- Enter the public share link (which can be found at WeChat Reading) and submit your subscription.
- The system grabs the content through WeChat Reader and generates RSS links. Note: The frequency of adding too much may be restricted, need to wait 24 hours to unblock.
Getting RSS Links
- On the "Public sources" screen, find the subscribed public numbers.
- Click to copy the RSS link (e.g.
http://localhost:4000/feeds/公众号ID.rss
). - Add the link to an RSS reader (such as Feedly).
Title Filter
- Add parameters after the RSS link:
- Contains keywords:
?title_include=Zhang San|Li Si
(Multiple Users)|
(Separation). - Exclude keywords:
?title_exclude=Zhang Sanfeng
The - Example:
http://localhost:4000/feeds/all.rss?title_include=新闻|technology&title_exclude=advertising
The
manual update
- After the RSS link add
?update=true
e.g.http://localhost:4000/feeds/公众号ID.rss?update=true
The - After updating need to request again no
update
parameter's link to view the results.
Featured Function Operation
full text output
- By default, only a summary is output. Enabling full text requires setting the environment variable
FEED_MODE=fulltext
(added at deployment). - Note: Full text mode increases response time and memory usage.
regular update
- By default, it is updated daily at 5:35 and 17:35 (
cron_expression=35 5,17 * * * *
). - This variable can be modified to adjust the frequency, e.g. hourly updates set to
0 * * * *
The
Private deployment
- set up
SERVER_ORIGIN_URL
is a public IP or domain name (e.g.http://你的域名:4000
) for easy extranet access. - Data is stored in SQLite or MySQL and regular backups are recommended.
Request limitations
- The default is 60 requests per minute (
MAX_REQUEST_PER_MINUTE=60
). In the case of "Blackout Today", you can reduce the frequency or wait 24 hours.
caveat
- network optimization: Domestic access to microsoft reading slow when set
PLATFORM_URL=https://weread.965111.xyz
The - Log Troubleshooting: In case of a runtime error, use the
docker logs wewe-rss
View Log. - Account Status::
- "Today's hack": request overrun, need to wait a day or restart service.
- "Disabled": re-sweep the code to log in.
With the above steps, you can quickly deploy and use WeWe RSS to enjoy a convenient public subscription experience.