developer-oss-research

開発者・オープンソースの調査

Crawlora API から正規化された JSON として、GitHub のリポジトリ、ユーザー、組織、および Chrome ウェブストアの拡張機能を調べます。github.com や Chrome ウェブストアをスクレイピングする必要はありません。

このスキルを使う場面

• 「この GitHub のリポジトリ／ユーザー／組織について教えて」（スター数、言語、フォロワー数）。
• 「今 GitHub でトレンドになっているのは？」（言語別）。
• 「このリポジトリには誰が貢献していますか？」／「リリース情報は？」
• 「この Chrome 拡張機能について教えて」（権限、プライバシー、レビュー）。
• 「<キーワード>に合う拡張機能を検索して」／「この拡張機能に似たものは？」

セットアップ（初回のみ）

• https://crawlora.net で無料の Crawlora API キーを取得します（月 2,000 クレジット、カード不要）。
• ヘルパーを実行する前に、環境変数に CRAWLORA_API_KEY を設定します。
• ヘルパーは環境変数から CRAWLORA_API_KEY を読み取り、https://api.crawlora.net/api/v1 にリクエストを送信します。キーがない場合、または無効な場合は 401 が返されます。

仕組み

1. GitHub リポジトリ — /github/search/repositories（q。GitHub の検索構文を使用できます）でリポジトリを検索し、詳細は /github/repo/{owner}/{repo} から取得します。さらに /contributors、/languages、/releases、/forks も利用できます。
2. GitHub ユーザー／組織 — /github/search/users（q）で検索します。/github/user/{username}（および /followers、/following、/repos、/events、/pinned）または /github/org/{org}（および /repos）を利用できます。/github/trending と /github/trending/developers では、language と since で絞り込み、現在のトレンドを確認できます。
3. Chrome ウェブストア — /chromewebstore/search（term）で拡張機能の id を検索し、詳細は /chromewebstore/item から取得します。/permissions、/privacy、/reviews、/similar も利用できます。/chromewebstore/charts と /chromewebstore/category では一覧やトレンドを確認でき、/chromewebstore/developer では一人の公開者が提供するすべての拡張機能を一覧表示できます。

エンドポイント、メソッド、パラメーターの全一覧については、reference/endpoints.md を参照してください。

API の呼び出し

# GitHub:
scripts/crawlora.sh /github/search/repositories q="language:go stars:>1000" | jq '.'
scripts/crawlora.sh /github/repo/anthropics/claude-code | jq '.'
scripts/crawlora.sh /github/trending language=python | jq '.'

# Chrome Web Store:
scripts/crawlora.sh /chromewebstore/search term="ad blocker" | jq '.'
scripts/crawlora.sh /chromewebstore/item id=<extension-id> | jq '.'

すべてのリクエストには scripts/crawlora.sh を使用してください。API キーがコマンドライン引数に含まれないようにできます。

エンドポイントリファレンス

このスキルで使用する GitHub と Chrome ウェブストアのすべてのエンドポイントについては、reference/endpoints.md を参照してください。

使用例

• リポジトリのデューデリジェンス： /github/repo/{owner}/{repo} と /contributors、/releases を使って、依存する前に活動状況やメンテナンスの健全性を評価します。
• トレンドの調査： /github/trending（言語別）と /github/trending/developers を使って、注目を集めているものの日次／週次の動向を確認します。
• 拡張機能の安全性チェック： ブラウザー拡張機能を推奨またはインストールする前に、/chromewebstore/item と /permissions、/privacy を確認します。

注意事項と制限

• クレジット／成功時のみ課金： 2xx の場合にのみ課金されます。無料プランは月 2,000 クレジットです。キーは https://crawlora.net で取得できます。
• 公開データのみ — 公開プロフィール、リポジトリ、拡張機能のページが対象です。
• セキュリティ： キーの保存先は CRAWLORA_API_KEY のみです。ハードコード、クエリパラメーターへの指定、コミットは絶対に行わないでください。
• GitHub 検索では、q の中で GitHub 独自の検索修飾子（language:、stars:>N、org: など）を利用できます。 github.com の検索バーと同じ構文です。
• 一覧取得エンドポイントはページ分割されています（page／per_page）。すべてを取得するには各ページを順に取得してください。