Pangu-Immortal/hunter-ai-content-factory
自动发布 24 小时情报系统:好文章的 80% 在于选题。Hunter AI 自动从 GitHub Trending、Twitter、HackerNews Reddit 等平台采集热点,用 AI 判断哪些值得写,自动生成文章和插图,自动发布。
What is this project?
Hunter AI Content Factory is a tool that automates content creation. It watches trending topics across several platforms, uses Google's Gemini AI to write articles about them, and prepares those articles for publishing — mostly to WeChat public accounts (公众号).
The README's tagline sums it up: "Content production can be like coding — with input, output, and quality assurance."
What problem does it solve?
If you run a content account (a blog, a WeChat public account, a Xiaohongshu page), you need a steady stream of posts. This tool tries to remove the manual work: instead of you hunting for topics, researching, writing, and formatting, the tool does all of that in a pipeline.
How does it work?
The core is a 6-step workflow:
- Topic selection — pick what to write about
- Research — gather background material
- Structure — outline the article
- Writing — generate the actual text
- Packaging — polish and format it
- Publishing — push it out
Where does the topic come from? The tool collects data from five sources:
- GitHub Trending (popular open-source projects)
- Twitter/X (real-time hot topics)
- Reddit (community discussions)
- HackerNews (tech news)
- Xiaohongshu (lifestyle/consumer trends)
What does the AI do? It uses Gemini 2.0 Flash to write the content. The README mentions two quality features:
- 去 AI 味 ("de-AI-ing") — making the text sound less like a robot wrote it, with opinions, experience, and actionable advice
- Semantic deduplication — using a vector database (ChromaDB) to check that new articles aren't too similar to previously published ones
How does it deliver the result? Articles come out as Markdown files in an output/ folder. Optionally, it can send a notification to your WeChat via PushPlus (a notification service). Note: PushPlus sends to your personal WeChat chat window, not directly to a public account — you still copy the article and publish it manually.
The five content templates
| Template | Data source | Output | Best for |
|---|---|---|---|
github |
GitHub Trending | Long-form article for WeChat | Tech bloggers |
pain |
Twitter + Reddit | "Pain point diagnosis" report | Product managers |
news |
All 5 platforms combined | News briefing | Tech media |
xhs |
Xiaohongshu trending | Product recommendation post | Lifestyle bloggers |
auto |
All platforms | "AI life hacker" content | General creators |
You run a template from the command line, e.g. uv run hunter run -t github. There's also a --dry-run flag to test without publishing.
How do you use it?
Option 1: Online (no install) — There's a hosted version on Hugging Face Spaces (click and use) and a GitHub Codespaces environment (online editor where you can modify code).
Option 2: Local install — Run run.sh (Mac/Linux) or run.bat (Windows). The README says it auto-downloads Python and all dependencies on first run (3–5 minutes), then starts quickly.
Configuration — You need a Gemini API key (from Google AI Studio). Enter it in the web UI's settings page. Some templates need extra credentials:
githubtemplate: optional GitHub token (raises API rate limits from 60 to 5000 requests/hour)painandnewstemplates: Twitter cookies (to access Twitter data)xhstemplate: Xiaohongshu cookies- PushPlus token (optional, for WeChat notifications)
Tech stack (briefly)
- AI: Gemini 2.0 Flash
- HTTP: httpx
- Browser automation: Playwright (for scraping sites that need a real browser)
- Vector database: ChromaDB (for similarity checks)
- Relational database: SQLite
- Package manager: uv
- Web UI: Gradio
Project structure
src/intel/ # data collection layer
src/templates/ # content templates
src/factory/ # content production
src/utils/ # helper functions
data/ # stored data
output/ # generated articles
config.yaml # configuration file
License and community
- License: PolyForm Noncommercial License 1.0.0 — you can use, modify, and distribute it for non-commercial purposes only. Commercial use is prohibited; contact the author for a commercial license.
- Community: There's a QQ group (794834282) and a Telegram group focused on "traffic algorithms & business logic" — the README describes it as a place for people trying to grow accounts, covering positioning, viral content frameworks, funnel building, and monetization.
One caveat worth noting
The README is honest about a limitation: PushPlus notifications go to your personal WeChat chat window, not to a public account. So the "publish" step is really "notify you that an article is ready" — you still manually copy it from output/ and post it yourself.
Related
- Project
- Project
- Project
- Project
- Project