ホーム API

// 公開 api

HubLens の OSS トレンドデータをプログラムから取得できます。無料・認証不要で、アプリ・スクリプト・ダッシュボード・AI ツールに組み込めます。

// base url

https://hublens.dev/api/v1

// エンドポイント

GET/api/v1/trending

本日のトレンド OSS (日次更新)。直近 30 時間の記事をスコア順で返します。

パラメータデフォルト説明
limitnumber201 ページの件数 (最大 50)
offsetnumber0スキップ件数
categorystringカテゴリで絞り込み (例: "AI", "DevTools")
sourcestringソースで絞り込み ("github", "hn")
GET/api/v1/archive

記事アーカイブ全件 (ページング対応)。過去にトラッキングした全 OSS を検索できます。

パラメータデフォルト説明
limitnumber501 ページの件数 (最大 100)
offsetnumber0スキップ件数
categorystringカテゴリで絞り込み
sourcestringソースで絞り込み
qstringslug またはタイトルで検索
GET/api/v1/articles/:slug

指定 slug の記事の詳細を取得します。

// 使い方の例

# 本日のトレンド上位 5 件を取得
curl "https://hublens.dev/api/v1/trending?limit=5"

# React 関連の repo をアーカイブから検索
curl "https://hublens.dev/api/v1/archive?q=react"

# 指定 repo の詳細を取得
curl "https://hublens.dev/api/v1/articles/facebook-react"

// レスポンス形式

list 系のエンドポイントは以下の構造を返します。

{
  "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 あたり 1 時間 60 リクエスト
  • >制限を超えると 429 Too Many Requests を返します
  • >レスポンスは 1 時間キャッシュされます (データは日次更新)

// mcp サーバー

Claude Code 等の AI ツールから直接 HubLens のデータを利用できます。MCP サーバーを追加すると、トレンド検索・アーカイブ検索・記事詳細を 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 キー不要 (無料枠で提供)
  • >データは自動パイプラインで 1 日 1 回更新