GitHub Stars 同步至 Notion 工具

开发开源项目

2025-03-28

GitHub Stars 同步至 Notion 工具

花费一个多小时，代码全程使用AI(Claude)生成，包括项目创建→目录划分→文件输出。

项目地址：

https://github.com/OnlyTL/github-stars-to-notion

功能介绍

这个工具的核心功能很简单：将你在GitHub上Star的仓库自动同步到Notion数据库中。具体包括以下几点：

两种同步模式

全量同步：一次性导入你所有Star过的仓库
增量同步：只同步上次同步后新Star的仓库，节省时间和资源

丰富的信息同步

工具会自动提取并同步多种仓库信息：

仓库名称和描述
当前星标数量
主要编程语言
项目主题标签
许可证类型
你标星的时间
仓库最后更新时间

自动化工作流

通过GitHub Actions实现定时自动同步
可自定义同步频率，适应不同需求
无需服务器，零护成本

最终效果

使用教程

设置过程相对简单，只需要几个基本步骤：

准备工作

首先，你需要准备以下几项：

GitHub个人访问令牌：
- 访问GitHub开发者设置
- 创建一个具有repo权限的令牌
- 保存好生成的令牌
Notion集成与数据库：
- 在Notion开发者页面创建一个新的集成
- 复制Integration Token
- 可以使用预设模板或自己创建数据库
- 将数据库与你的集成共享（Notion 页面右上角…选择集成）
- 从数据库URL中获取数据库ID

使用GitHub Actions自动同步（推荐方式）

Fork项目仓库：
- 访问github-stars-to-notion
- 点击"Fork"按钮创建自己的副本
设置仓库Secrets：
- 在你Fork的仓库中，进入Settings > Secrets and variables > Actions
- 添加以下三个Secrets：
  - TOKEN：你的GitHub个人访问令牌
  - NOTION_TOKEN：你的Notion集成令牌
  - NOTION_DATABASE_ID：你的Notion数据库ID
    - 页面地址中：如页面地址为https://www.notion.so/1bc54d7a9d5d804384e8f97a64f42f9d?v=1bc54d7a9d5d81229169000cd251dd11
      
      那么ID就是域名/后面，?前面的字符串
启动同步：
- 系统默认每天凌晨会进行全量同步
- 每小时会进行一次增量同步
- 你也可以在Actions页面手动触发工作流

本地运行方式

如果你更喜欢在本地环境中运行，可以按照以下步骤操作：

# 克隆仓库
git clone https://github.com/OnlyTL/github-stars-to-notion.git
cd github-stars-to-notion

# 安装依赖
npm install

# 创建.env文件并填入你的凭证
TOKEN=你的_github_个人访问令牌
NOTION_TOKEN=你的_notion_集成令牌
NOTION_DATABASE_ID=你的_notion_数据库_id

# 运行同步
npm run full-sync  # 全量同步
# 或者
npm run incremental-sync  # 增量同步

使用体验

设置完成后，你可以访问Notion数据库查看同步结果。所有Star的仓库都会以结构化的方式呈现，包含详细的信息。

Notion强大的数据库功能让你可以：

按语言或主题筛选项目
按星标数或更新时间排序
添加自己的笔记和分类标签
创建不同的视图来组织项目

这大大提高了GitHub Star列表的实用性，让你能够更有效地利用这些优质资源。

结语

 现在的AI工具确实能够显著提高开发效率。特别是在处理API文档解析、编写样板代码和调试等方面，AI能够提供很好的辅助。这个项目连README都是AI写的。顺带提一嘴，现阶段，Coding能力中Claude 确实是最强的，且没有之一，不过在更新3.7后，老是喜欢自由发挥，扩充一些有的没的的内容，不过可以通过Prompt 去控制。

#开源项目 ⁸ #开发 ¹³