作为技术人，每天刷 GitHub Trending 是必修课。但问题来了：
- 📝 看到好项目想记录，手动复制粘贴太麻烦
- 💡 想分享给团队/朋友，不知道怎么介绍更吸引人
- 📊 想系统化管理看过的项目，Excel/Notion 手动维护太累
于是我用 Cursor AI 编辑器，花了半天时间搞了这个自动化工具 👇
✨ 能做什么？
🤖 自动化工作流
每天早上 6 点自动运行，醒来就能看到昨日热榜 + AI 生成的深度分析。
📊 AI 生成的内容包括：
- 一句话简介（20字精准概括）
- 使用价值（150字深度分析）
- 目标用户群体（精准定位）
- 小红书推广文案（轻松活泼）
- 公众号推广文案（专业严谨）
- 智能标签分类
💰 成本？每月不到 1 元！ 使用 DeepSeek API，一天只要 ¥0.02，一个月不到一杯奶茶钱。
🚀 快速开始
1. 克隆项目
bash
git clone https://github.com/OceanEyes233/Github-Ranking.git2：集成Notion，创建Notion数据库表格
创建开发集成，获取Notion 集成密钥，创建Github Ranking数据库页面
在该集成中给数据库页面添加访问权限 在数据库页面中创建相应表头
- 名称 (Title) - 必需
- 一句话简介 (Text)
- 使用价值 (Text)
- 用户群体 (Text)
- Github链接 (URL)
- 标签分类 (Select 或 Multi-select)
- 小红书推广文案 (Text)
- 公众号推广文案 (Text)
- 日期 (Date) - 必需
3. 配置环境变量（3分钟搞定）
bash
cp config.example.env .env在 .env 中填入：
- GITHUB_TOKEN：可选，但强烈推荐（API 速率从 60/h → 5000/h）
- NOTION_API_KEY：Notion 集成密钥
- NOTION_DATABASE_ID：Notion数据库ID
- OPENAI_API_KEY：DeepSeek 或 OpenAI 的 API Key （用于生成营销文案-选填）
- OPENAI_API_BASE : AI API地址 默认api.openai.com/v1
- OPENAI_MODEL： 大数据模型（deepseek-chat，gpt-3.5-turbo, gpt-4, gpt-4-turbo-preview 等）
💡 详细配置步骤见项目 README，手把手教学
4. 运行测试
bash
npm test看看能否正常获取数据，不会保存到 Notion。
5. 启动定时任务
sql
npm start
# 或使用 PM2 持久化运行
pm2 start index.js --name github-trending🎯 实际效果
💻 技术亮点
1. 多数据源降级方案
GitHub Trending 没有官方 API，项目实现了 5 层降级：
javascript
OSS Insight → gtrend.yapie.me → ghapi.huchen.dev
→ gh-trending-api.com → GitHub 官方 API自动切换，保证 99% 的成功率。
2. 数据完整性验证
保存到 Notion 前自动验证所有字段，缺失字段的记录会被跳过并显示详细日志。
3. README 深度分析
不是简单的描述搬运，而是：
- 读取每个仓库的 README（最多 8000 字符）
- 发送给 AI 深度分析
- 生成个性化的营销内容
4. 超时和速率控制
- 所有网络请求都有超时保护
- API 调用之间有合理延迟
- GitHub Actions 支持（每天自动运行）
📦 部署方式
本地运行
bash
npm start # 立即执行一次 + 启动定时任务PM2 守护进程
sql
pm2 start index.js --name github-trending
pm2 startup # 开机自启GitHub Actions（推荐）
项目自带 .github/workflows/daily-fetch.yml，配置好 Secrets 后自动运行，完全免费！
🎁 适用场景
- 📚 个人学习：系统化追踪优质开源项目
- 🏢 技术团队：每日技术动态自动推送
- ✍️ 内容创作者：AI 生成的文案可直接用于公众号/小红书
- 🚀 产品经理：快速了解技术趋势和竞品动态
🔗 项目地址
GitHub: github.com/OceanEyes23...
如果觉得有用，欢迎 Star ⭐
写在最后
这个项目从想法到上线只用了 2 天，90% 的代码都是和 Cursor AI 对话生成的。
AI 时代的开发方式真的变了：
- 不再是"我会什么技术"，而是"我想实现什么功能"
- 编程变成了和 AI 沟通需求 + 把控架构
如果你还没试过 AI 辅助编程，强烈推荐试试 Cursor！
有任何问题欢迎评论区交流 👇