TTokenySpace
返回 Skills 列表

Trending Feed Skill Free

获取 GitHub Trending 热门仓库列表，支持按语言过滤，返回含描述、星标数、主语言的结构化 JSON 数据。

#中文
下载 ZIP 来源页面
0

安装到 Tokeny（自动）

下载 ZIP
安装"trending-feed-skill-free"技能
技能信息：
- 名称: Trending Feed Skill Free
- 标识: trending-feed-skill-free
- 描述: 获取 GitHub Trending 热门仓库列表，支持按语言过滤，返回含描述、星标数、主语言的结构化 JSON 数据。
- 版本: 1.0.0
下载地址：
https://www.tokeny.space/api/skills/trending-feed-skill-free/download
继续

复制上方内容到 Tokeny 客户端并在会话中发送即可自动安装；也可直接 下载 ZIP并拖动到技能窗口安装。

SKILL.md

热榜订阅（免费版）

概述

本 Skill 帮助 Agent 快速获取 GitHub Trending 热门仓库列表，并通过 GitHub REST API 补全仓库详情，最终输出结构化 JSON。免费版聚焦"每日浏览一次、了解技术风向"的核心场景，提供完整的抓取、解析、格式化能力，适合个人开发者与技术爱好者快速试水。

核心能力

能力说明免费版支持
页面抓取抓取 GitHub Trending 默认页面是
语言过滤按编程语言筛选热门仓库是
字段补全调用 REST API 补全描述、星标、语言是
结构化输出统一 JSON 数组结构是
多平台格式化飞书 / Discord / Telegram / 控制台是
批量抓取一次抓取多语言、多时间窗否（专业版）
高级缓存多级缓存与命中率统计否（专业版）
定时推送定时抓取并推送到 IM 渠道否（专业版）

核心功能执行

用input_params参数进行配置。

输入: 用户提供核心功能执行所需的指令和必要参数。 处理: 解析核心功能执行的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回核心功能执行的响应数据,包含状态码、结果和日志。

  • 执行此能力时使用input_params参数,支持创建/查询/导出操作

参数配置与调用

用config_options参数进行配置。

输入: 用户提供参数配置与调用所需的指令和必要参数。 处理: 解析参数配置与调用的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回参数配置与调用的响应数据,包含状态码、结果和日志。

  • 执行此能力时使用config_options参数,支持修改/重置/导入操作

结果处理与输出

用output_format参数进行配置。

输入: 用户提供结果处理与输出所需的指令和必要参数。 处理: 解析结果处理与输出的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回结果处理与输出的响应数据,包含状态码、结果和日志。

  • 执行此能力时使用output_format参数,支持导出/保存/转换操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：热门仓库列表、支持语言过滤、返回结构化、核心能力、页面并解析仓库元、星标数、主语言、支持按编程语言过、Use、when、需要数据分析、报表生成、统计洞察、数据可视化时使用、不适用于实时流数、据处理等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

  1. 每日技术晨会素材：上班前抓取当日热榜，挑选 3-5 个项目在团队晨会分享，保持技术敏感度。
  2. 语言生态观察：长期关注 Python、Rust、Go 等语言，发现新兴框架与工具链演进趋势。
  3. 内容创作选题：技术博主或自媒体从热榜中挖掘选题，撰写趋势分析或项目解读文章。
  4. 招聘与团队建设：技术负责人通过热榜了解候选人所在技术栈的流行度，校准岗位要求。

快速开始

上手时间：< 60 秒。本 Skill 为纯指令型，无需安装额外依赖。

Step 1：抓取默认热榜

python3 ~/.skill-platform/workspace/skills/trending-feed/（请参考skill目录中的脚本文件）

Step 2：按语言过滤

python3 ~/.skill-platform/workspace/skills/trending-feed/（请参考skill目录中的脚本文件） python
python3 ~/.skill-platform/workspace/skills/trending-feed/（请参考skill目录中的脚本文件） javascript
python3 ~/.skill-platform/workspace/skills/trending-feed/（请参考skill目录中的脚本文件） rust

Step 3：查看输出结构

返回 JSON 数组，每个元素结构如下：

{
  "full_name": "owner/repo",
  "description": "仓库一句话描述",
  "language": "Python",
  "stars": 12345,
  "url": ""
}

Step 4：按平台格式化

获取数据后，由 Agent 根据所在平台格式化输出：

飞书 / 钉钉：

GitHub Trending · 今日热榜
1. owner/repo - 描述 ⭐ 12345 | Python
# ...

Discord / Telegram：

GitHub Trending 今日热榜
1. owner/repo - 描述 ⭐ 12345 | Python |

控制台：

1. owner/repo (⭐ 12345 | Python)
   描述
# ...

示例

语言过滤参数

参数值含义示例
不传默认全语言热榜fetch_trending.py
pythonPython 项目fetch_trending.py python
javascriptJavaScript 项目fetch_trending.py javascript
goGo 项目fetch_trending.py go
rustRust 项目fetch_trending.py rust

输出条数

  • 默认全语言热榜：返回 9 个仓库
  • 语言过滤时：返回 10 个仓库
  • 免费版暂不支持自定义条数（专业版支持 --limit 参数）

最佳实践

  1. 每日固定时间抓取：建议在工作日早晨执行一次，避免频繁调用触发 GitHub API 速率限制（未认证 60 次/小时）。
  2. 优先使用语言过滤：关注特定语言时使用语言参数，结果更聚焦，命中率更高。
  3. 结合本地缓存复用：同一日内重复查询时复用上次结果，免费版建议手动缓存到本地文件。
  4. 失败时使用 fallback 数据：脚本在 API 出错时会返回 fallback 数据，请检查日志中的错误标记。
  5. 输出前做去重：同一仓库可能在不同时间窗重复出现，输出前按 full_name 去重。

常见问题

Q1：抓取返回空列表怎么办？

A：请检查网络连接与 GitHub 站点可达性。若在公司网络下，可能需要配置代理。可尝试在脚本中设置 HTTPS_PROXY 环境变量。

已知限制

A：GitHub 未认证请求限制为 60 次/小时。建议：(1) 降低抓取频率；(2) 使用本地缓存复用结果；(3) 升级到专业版使用 GitHub Token 认证提升到 5000 次/小时。

Q3：语言过滤后结果不准确？

A：部分仓库未标注主语言，会被过滤掉。建议同时抓取全语言热榜对比，或使用专业版的多语言并集模式。

Q4：如何在飞书机器人中自动推送？

A：免费版需手动调用脚本并将输出粘贴到机器人。如需定时自动推送，请使用专业版的定时任务能力。

Q5：为什么默认只返回 9 个仓库？

A：免费版遵循 GitHub Trending 页面默认展示数量，便于快速浏览。专业版支持自定义条数与分页。

Q6：能否抓取历史热榜？

A：GitHub Trending 仅展示当前时段，不提供历史数据。免费版建议每日抓取后本地存档，形成历史序列。专业版支持定时抓取与增量对比，自动构建历史档案。

Q7：抓取结果如何持久化？

A：免费版可将 JSON 输出重定向到本地文件，例如 fetch_trending.py python > trending-$(date +%F).json，按日期归档便于后续分析。

免费版限制

本免费体验版限制以下高级功能：

  • 批量抓取多语言、多时间窗（专业版支持）
  • 高级缓存策略与命中率统计（专业版支持）
  • 定时抓取并自动推送到 IM 渠道（专业版支持）
  • 自定义输出模板与字段映射（专业版支持）
  • GitHub Token 认证提升速率限制（专业版支持）

解锁全部功能请使用专业版：trending-feed-skill-pro

依赖说明

运行环境

  • Agent 平台：支持 SKILL.md 的任意 AI Agent（Claude Code / Cursor / Codex / Gemini CLI 等）
  • 操作系统：Windows / macOS / Linux
  • Python：3.8+（用于运行抓取脚本）

依赖详情

依赖项类型是否必需获取方式
LLM APIAPI必需由 Agent 平台内置 LLM 提供
Python 标准库运行时必需Python 自带（urllib / json / re）
requests（可选）Python 包可选pip install requests，用于更稳定的 HTTP 请求
GitHub REST API外部 API必需公开 API，未认证 60 次/小时

API Key 配置

  • GitHub Token（可选）：免费版可不配置；如需提升速率限制，可在环境变量中设置 GITHUB_TOKEN，由专业版完整支持
  • 本 Skill 基于指令驱动：除上述可选 Token 外无需额外 API Key

可用性分类

  • 分类：MD+EXEC（纯 Markdown 指令，部分功能需要 exec 命令行执行能力）
  • 说明：基于 Markdown 的 AI Skill，通过自然语言指令驱动 Agent 执行任务

错误处理

错误场景原因处理方式
配置错误参数缺失或格式错误检查依赖说明中的配置要求
运行时错误运行环境不满足确认运行环境符合依赖说明
网络错误连接超时或不可达执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案

评论

加载中…