首页 › API

// 公共 api

以编程方式访问 HubLens 的 OSS 趋势数据。免费使用，无需认证。可用于你的应用、脚本、仪表板或 AI 工具。

// base url

https://hublens.dev/api/v1

// api 端点

GET/api/v1/trending

今日热门 OSS 项目（每日更新）。返回近 30 小时内、按评分排序的文章。

参数	类型	默认值	说明
limit	number	20	每页结果数（最多 50）
offset	number	0	跳过前 N 条结果
category	string	—	按分类筛选（如 "AI"、"DevTools"）
source	string	—	按来源筛选（"github"、"hn"）

GET/api/v1/archive

全量文章归档（分页）。可搜索所有历史记录的项目。

参数	类型	默认值	说明
limit	number	50	每页结果数（最多 100）
offset	number	0	跳过前 N 条结果
category	string	—	按分类筛选
source	string	—	按来源筛选
q	string	—	按 slug 或标题搜索

GET/api/v1/articles/:slug

按 slug 获取指定文章的完整详情。

// 使用示例

# 获取今日前5个热门项目
curl "https://hublens.dev/api/v1/trending?limit=5"

# 搜索与 React 相关的项目
curl "https://hublens.dev/api/v1/archive?q=react"

# 获取指定项目详情
curl "https://hublens.dev/api/v1/articles/facebook-react"

// 响应格式

所有列表类端点返回以下结构：

{
  "data": [
    {
      "slug": "owner-repo",
      "title_en": "Project Title",
      "title_zh": "...",
      "summary_en": "One-paragraph summary",
      "summary_zh": "...",
      "category": "AI",
      "tags": ["machine-learning", "python"],
      "stars": 12345,
      "stars_change": 234,
      "score": 87,
      "trending_score": 45,
      "source": "github",
      "repo_url": "https://github.com/owner/repo",
      "rank_overall": 1,
      "rank_category": 1,
      "updated_at": "2026-04-19T12:00:00.000Z"
    }
  ],
  "meta": {
    "total": 15,
    "limit": 20,
    "offset": 0,
    "generated_at": "2026-04-19T12:00:00.000Z"
  }
}

// 速率限制

>每 IP 每小时 60 次请求
>超出限制返回 429 Too Many Requests
>响应缓存 1 小时（数据每日更新）

// mcp server

在 Claude Code 等 AI 工具中直接使用 HubLens 数据。安装 MCP Server 后，可在 AI 助手中查询热门项目、搜索归档、获取文章详情。

# Add to Claude Code
claude mcp add hublens -- npx -y @hublens/mcp-server

添加后，AI 助手可调用 hublens_trending、 hublens_search、 hublens_article 等工具获取实时 OSS 趋势数据。

// cors 与使用

>CORS 全域许可，可从任意前端或脚本调用
>无需 API 密钥（免费使用）
>数据通过自动化管道每日更新一次