github-trending（GitHub趋势数据获取）Skill 是什么？

GitHub趋势数据获取Skill：不用官方 API，也能把每日热门仓库抓到手

定位清晰：这个技能只解决一件事——把 GitHub 趋势页上的热门仓库和开发者数据，变成可用的结构化数据，供仪表板、周报、选题或技术调研使用。
两条技术路线：一条是抓取 github.com/trending 页面（推荐，数据与页面一致），另一条是用 GitHub 搜索 API 按“创建时间 + 星数 + 语言”筛选近似趋势仓库（官方接口，更稳定）。
字段完整：仓库归属者、名称、链接、描述、语言、语言色值、总星数、分支数、当日/本周/本月新增星数，一次抓取全部拿到。
工程化配套：技能内容里直接给出了 Next.js 服务端 API 路由写法与 React useTrending 钩子，抓取放到服务端做，前端只管渲染，规避跨域问题。
有明确前提：GitHub 没有官方趋势 API，抓取要尊重速率限制、注意页面结构变化，并且必须带 User-Agent，这些本技能都做了提示。

1. 该技能叫什么？如何一键安装 AI 技能提升开发效率？

GitHub趋势数据获取Skill，英文名 github-trending，技能 ID 为 13149。它的触发词包括“GitHub 趋势”“趋势仓库”“热门仓库”“GitHub 发现”。

它解决的问题非常具体：GitHub 官方没有提供趋势数据的 API，github.com/trending 只是一个网页。想给团队做技术雷达、给自己的产品加一个“今日热门”模块、或者每周写一篇技术趋势观察，都绕不开“怎么把网页上的数据变成程序能用的 JSON”。这个技能把抓取逻辑、字段解析、数字格式化、缓存策略和前端调用方式一次性固化成可复用的方案。

“一键安装”的思路与步骤：

确认前提：需要一个支持 AI 技能调用的客户端或技能市场入口（具体平台以官方说明为准）；若要在自己项目里落地代码，则需要 Node.js 环境和一个支持 TypeScript 的工程，抓取页面依赖 cheerio 解析 HTML（以官方说明为准）；想提高 GitHub 搜索 API 的调用额度，可以准备一个 GITHUB_TOKEN 环境变量（可选但推荐）。
执行安装：在技能市场或技能管理入口中搜索技能名 github-trending 或技能 ID 13149，点击安装/启用。具体的安装命令、入口路径与版本信息，以官方说明为准。
验证是否生效：安装后直接用自然语言触发一次，例如输入“帮我看看今天的 GitHub 趋势仓库”，如果技能返回包含仓库名、描述、语言、星数、今日新增星数的列表，说明已生效；若返回格式异常，可尝试更换触发词“热门仓库”“GitHub 发现”再试一次。
前置提醒：抓取必须在服务端进行（浏览器直连 GitHub 会遇到跨域问题），并且要带上 User-Agent 请求头，否则容易被拒绝。

2. 该技能的主要功能和特点

趋势页抓取（推荐路线）：直接请求 github.com/trending，通过解析 article.Box-row 元素，逐条提取趋势仓库信息，返回结构化的 TrendingRepo 数组。
维度筛选：支持按语言过滤（如 typescript、python），也支持按时间范围过滤——daily（日）、weekly（周）、monthly（月），对应 URL 上的 ?since= 参数，覆盖“今日热门”和“本周热门”两种典型需求。
字段颗粒度细：输出包含 owner、name、fullName、url、description、language、languageColor、stars、forks、starsToday。其中语言色值是从页面上的彩色圆点样式里解析出来的，做前端徽标时可以直接用，省去自己维护一份语言配色表。
数字智能归一：内置 parseNumber 处理逻辑，会把页面上的 12,345 和 1.2k 这类写法统一换算成整数，避免前端出现“1.2k 个星”这种脏数据。
官方 API 替代路线：调用 GitHub 搜索 API，用 created:>日期、stars:>=数量、language:语言 组合查询，按星数降序返回，可作为抓取失败时的兜底方案。
开箱即用的框架集成：技能内容直接给出了 Next.js 的 app/api/trending/route.ts 示例（含 revalidate: 3600 一小时缓存）和 React 的 useTrending 钩子（内置 isLoading、error 状态），前后端不用再各写一套。
风险提示到位：明确列出五条注意事项——无官方 API、尊重速率限制、HTML 结构可能变化、必须带 User-Agent、只在服务端抓取。

和“随手写一段爬虫”相比，它的差异在于：字段解析规则、分词与数字处理、缓存建议、跨域规避、降级方案都已预先设计好，拿过来接进项目即可，不需要再踩一遍解析选择器的坑。

3. 如何使用该技能？

第 1 步：安装并触发。 安装技能后，用自然语言直接提问即可。

输入示例：

帮我列出本周 GitHub 上 TypeScript 语言的热门仓库，只要前 10 个。

输出说明：返回一个仓库列表，每项含仓库全名、链接、一句话描述、主语言、总星数、分支数和“本周新增星数”，可直接复制进周报或表格。

第 2 步：指定筛选条件。 使用时可以明确三件事——语言（可省略，省略即全语言）、时间范围（日/周/月）、数量。例如“看看这个月的 Python 热门仓库”“最近 7 天最火的开源项目有哪些”。

第 3 步：在自己的项目里调用抓取逻辑。 核心是拼接 URL 后请求并解析：

let url = 'https://github.com/trending';
if (language) url += `/${encodeURIComponent(language)}`;
if (since) url += `?since=${since}`;
// 请求时务必带上 User-Agent

第 4 步：用搜索 API 做兜底。 当页面抓取失败或结构变动时，切换到搜索接口：

const query = `created:>${since} stars:>=${minStars} language:${language}`;
// GET https://api.github.com/search/repositories?q=...&sort=stars&order=desc&per_page=25

注意这里的额度限制：未认证时每分钟 10 次请求，带令牌时每分钟 30 次。

第 5 步：包一层服务端接口。 在 Next.js 中新增 app/api/trending/route.ts，从 searchParams 读取 language 与 since，服务端 fetch 抓取后返回 Response.json(repos)，并设置 next: { revalidate: 3600 } 缓存一小时，避免每次刷新都去打 GitHub。

第 6 步：前端接入钩子。 使用 useTrending({ language, since }) 获取 repos、isLoading、error 三个返回值，加载态和错误态直接渲染，切换语言或时间范围时依赖项变化会自动重新请求。

第 7 步：做异常兜底。 对抓取结果做非空校验（owner 和 name 都存在才入数组），接口失败时返回中文错误信息与 500 状态码，前端展示“暂时获取不到趋势数据，请稍后重试”。

4. 同类型竞品对比分析

方案名称	定位	核心功能	安装/使用门槛	适用场景	优势与不足
github-trending（本技能）	趋势数据的抓取与工程化封装	趋势页抓取、语言/时间筛选、字段解析、Next.js 路由与 React 钩子、搜索 API 兜底	低，安装技能即可对话调用；代码落地需 Node.js 与 cheerio	趋势看板、技术周报、内容选题、技术选型调研	优势：字段全、含语言色值、前后端示例齐备、有降级方案；不足：依赖页面结构，GitHub 改版时需同步调整选择器
GitHub 官方搜索 API 自建	官方数据接口	按创建时间、星数、语言检索仓库，返回完整仓库对象	中，需要自行写查询构造、分页与缓存	需要稳定接口、可接受“近似趋势”定义的项目	优势：官方支持、结构稳定、有令牌额度；不足：不是真正的趋势榜单，缺少“今日新增星数”这类指标
GitHub CLI / Octokit 等官方客户端	官方 SDK 与命令行工具	封装 REST/GraphQL 调用，处理认证与重试	中，需要配置令牌与依赖	深度集成 GitHub 的自动化脚本与服务端应用	优势：类型完善、维护活跃；不足：同样拿不到趋势页数据，只解决“调用 API 麻烦”的问题
手动浏览趋势页 / 第三方聚合站	零代码方案	人工查看榜单，或用别人做好的榜单页面	极低	个人随手看看、灵感收集	优势：零成本；不足：无法批量、无法入库、无法接入产品，历史数据留存困难

选择建议：如果只是“我想知道今天什么火”，手动看页面就够了；如果要把趋势数据变成产品功能或固定产出的内容，本技能的开箱即用程度更高；如果对接口稳定性要求极高、且能接受用“近期创建 + 高星”近似趋势，可以以搜索 API 为主、页面抓取为辅。

5. 该技能的典型应用场景与实际体验情况

场景一：技术选型与趋势雷达（开发者/架构师）。 痛点是想了解某个语言生态最近在火什么，但逐个仓库点开太慢。使用方式是问“最近一个月 Go 语言的热门仓库有哪些”，然后重点看描述和新增星数，快速筛出值得研究的项目。实际体验：上手几乎零成本，因为是对话式调用，不需要先写代码；效果上，新增星数比总星数更能反映“当下热度”，这一点对判断趋势帮助很大。注意：热度不等于质量，仍需自己判断项目成熟度。

场景二：技术内容运营与选题（自媒体/社区运营）。 痛点是每天要找选题，靠人工刷榜单效率低且容易遗漏。使用方式是每天固定拉一次日榜、每周拉一次周榜，把仓库描述作为素材池。实际体验：结构化输出能直接粘进表格，语言字段方便做分类栏目；注意事项是描述文本来自页面，可能出现截断或空描述，需要人工润色，且引用时要自己核实项目背景。

场景三：团队技术周报（Tech Lead）。 痛点是把“本周值得关注的开源动态”做成固定栏目，每次手工整理要花半小时以上。使用方式是通过服务端接口 + 一小时缓存，把数据接到内部看板或周报模板里。实际体验：revalidate: 3600 的缓存设计很实用，多人同时刷新也不会把请求打到 GitHub；useTrending 钩子省掉了加载态和错误态的手写逻辑。注意：抓取必须放在服务端，否则会被跨域拦住。

场景四：产品内嵌“趋势发现”模块（全栈/独立开发者）。 痛点是想给自家开发者社区或工具站加一个“热门项目”板块，但从零写爬虫要处理解析、缓存、容错三件事。使用方式是按技能给出的路由与钩子结构落地，先跑通列表，再补分页与详情跳转。实际体验：字段与选择器都给了现成参照，调试成本主要花在环境上；注意事项是页面 HTML 结构一旦调整，article.Box-row 这类选择器就可能失效，建议加监控与搜索 API 兜底，并对结果做空值过滤。

6. 该技能能为用户带来的价值

省掉“从零设计”的时间：字段定义、选择器、数字换算、缓存策略、错误处理都已有参照实现，一个下午能跑通原型，而不必先花时间研究页面结构。
降低抓取类需求的门槛：不需要是爬虫老手，按技能给出的 URL 拼接规则和请求头要求操作即可，同时被明确告知“无官方 API”这一关键前提，避免走错方向。
数据可用性更高：结构化字段 + 数字归一 + 语言色值，让数据可以直接进数据库、进图表、进周报，减少二次清洗。
风险可控：技能主动提示速率限制、结构变化、User-Agent、仅服务端抓取四条红线，并给出搜索 API 这条官方兜底路线，让方案在异常时不会直接瘫痪。
长期价值：一旦趋势数据接入固定流程（日榜/周榜/看板），就形成了一条可持续的技术情报管道，选题、选型、周报、产品模块都能复用同一套数据源。

7. 常见问题 FAQ

Q1：这个技能怎么安装？安装后怎么确认能用？ 在支持 AI 技能的平台中，通过技能市场或技能管理入口搜索技能名 github-trending 或技能 ID 13149 安装启用，具体命令与入口路径以官方说明为准。验证方式很简单：直接说“看看今天的 GitHub 趋势仓库”，能返回带仓库名、语言、星数的结构化列表即表示生效。

Q2：它收费吗？需要额外的密钥吗？ 技能本身的费用与额度规则以官方说明为准。抓取 github.com/trending 页面不需要密钥；但如果走 GitHub 搜索 API 兜底路线，建议配置 GITHUB_TOKEN，因为未认证时每分钟只有 10 次请求，带令牌可提升到每分钟 30 次。

Q3：为什么不能直接调用一个官方的“趋势 API”？ 因为 GitHub 没有提供官方的趋势数据接口，github.com/trending 只是一个网页。所以要么解析页面 HTML，要么用搜索 API 按“近期创建 + 高星”做近似替代，技能里两条路线都给了。

Q4：这个技能适合谁用？ 适合三类人：需要做技术选型和趋势跟踪的开发者与架构师；需要每天找选题的技术内容运营；以及想给产品加“热门项目”模块的全栈或独立开发者。如果只是偶尔想看看榜单，直接手动浏览主页更省事。

Q5：和直接用 GitHub 搜索 API 相比，该怎么选？ 如果你需要“今日新增星数”这类只有趋势页才有的指标，或者希望数据与 GitHub 趋势榜完全一致，选本技能的页面抓取路线；如果你更看重接口稳定性、能接受用“近期创建且星数高”来近似趋势，可以以搜索 API 为主。实践中更稳妥的做法是两者结合：页面抓取为主，搜索 API 兜底。