yc-reader

Y Combinator Reader（読み取り専用）

ホストが以下のシェルプローブをまだ実行していない場合（たとえば Codex の場合）、セットアップ方法を選ぶ前に、シェルツールを使って ! で囲まれたコマンドを実行してください。実際の出力を使用し、シェルにアクセスできない場合は、その制限を報告してください。

yc-oss/api から Y Combinator の企業データを取得します。これは、公開ローンチ済みの YC 企業をすべてインデックス化した、非公式のオープンソース API です。データは YC の Algolia 検索インデックスを情報源としており、GitHub Actions によって毎日更新されます。

これは読み取り専用のデータソースです。 企業プロフィール、バッチ一覧、業界・タグ別の内訳、採用状況、多様性データを提供します。書き込み操作はありません。API は静的な JSON ファイルを提供します。

認証は不要です。 API は公開されており、無料です。curl を使って JSON エンドポイントを取得するだけです。

---

ステップ 1：前提条件を確認する

このスキルに必要なのは、データ取得用の curl と、JSON の解析・フィルタリング用の jq だけです。どちらもほとんどのシステムにプリインストールされています。

!`(command -v curl > /dev/null && echo "CURL_OK" || echo "CURL_MISSING") && (command -v jq > /dev/null && echo "JQ_OK" || echo "JQ_MISSING")`

JQ_MISSING と表示された場合は、インストールしてください。

# macOS
brew install jq

# Linux (Debian/Ubuntu)
sudo apt-get install jq

jq を利用できない場合でも、curl で未加工の JSON を取得し、Python などのツールを使ってその場で解析できます。ただし、jq を使うとフィルタリングがはるかに簡単になります。

---

ステップ 2：ユーザーが必要としている情報を特定する

ユーザーのリクエストに対応するエンドポイントを選んでください。詳細については references/api_reference.md を参照してください。

ユーザーのリクエスト	エンドポイント	備考
YC 全体の統計情報	meta.json	企業数、バッチ一覧、業界・タグ一覧
全企業	companies/all.json	全データセット（約 5,700 社）— 応答サイズが大きい
トップ企業	companies/top.json	業績上位の YC 企業、約 91 社
採用中の企業	companies/hiring.json	現在採用中の約 1,400 社
非営利企業	companies/nonprofit.json	YC が支援する非営利企業
多様性データ	companies/black-founded.json、hispanic-latino-founded.json、women-founded.json	創業者の多様性
特定のバッチ	batches/{batch-name}.json	例：winter-2026.json、spring-2026.json、fall-2025.json
単一企業のプロフィール	batches/{batch-name}/{slug}.json	例：batches/summer-2009/stripe.json、batches/winter-2009/airbnb.json
業界別	industries/{industry}.json	例：fintech.json、healthcare.json
タグ別	tags/{tag}.json	例：ai.json、developer-tools.json

バッチ名の形式

バッチ名は {season}-{year} 形式です。例：winter-2026、spring-2026、summer-2026、fall-2025。過去のバッチも summer-2005 まで同じ形式です。企業別エンドポイントでは、短縮形（w09、s21）も使用できます。

業界名とタグ名の形式

小文字を使い、複数語の場合はハイフンでつなぎます。例：real-estate、developer-tools、machine-learning。

---

ステップ 3：リクエストを実行する

ベース URL

https://yc-oss.github.io/api/

一般的なパターン

# Fetch and pretty-print
curl -s https://yc-oss.github.io/api/companies/top.json | jq .

# Count companies in a result
curl -s https://yc-oss.github.io/api/batches/winter-2025.json | jq length

# Filter by field (e.g., hiring companies in a batch)
curl -s https://yc-oss.github.io/api/batches/winter-2025.json | jq '[.[] | select(.isHiring == true)]'

# Extract specific fields
curl -s https://yc-oss.github.io/api/companies/top.json | jq '.[] | {name, one_liner, batch, team_size, website}'

# Search by name (case-insensitive)
curl -s https://yc-oss.github.io/api/companies/all.json | jq '[.[] | select(.name | test("stripe"; "i"))]'

主なルール

1. -s フラグを使う：進行状況の出力を抑制するため、curl に指定します。
2. jq にパイプで渡す：出力を読みやすくし、フィルタリングします。
3. 必要な場合を除き、companies/all.json の取得は避ける：応答サイズが大きく（約 5,700 社）、可能であれば、より具体的なエンドポイント（バッチ、業界、タグ）を優先してください。
4. API にユーザーの求める情報に特化したエンドポイントがない場合は、jq の select/filter を使う：クライアント側で結果を絞り込めます。
5. バッチ名は小文字とハイフンを使う：Winter 2025 や W25 ではなく winter-2025 を使います。
6. タグ名と業界名は小文字とハイフンを使う：Developer Tools ではなく developer-tools を使います。

一般的な jq フィルター

フィルター	用途
jq length	結果の数を数える
jq '.[0]'	最初の企業
jq '.[:10]'	最初の10社
jq '[.[] | select(.isHiring == true)]'	採用中の企業のみ
jq '[.[] | select(.status == "Active")]'	アクティブな企業のみ
jq '[.[] | select(.team_size > 100)]'	従業員数が100人を超える企業
jq '.[] | {name, one_liner, batch, website}'	特定のフィールドを選択
jq '[.[] | select(.name | test("query"; "i"))]'	名前で検索
jq 'sort_by(-.team_size) | .[:10]'	チーム規模の上位10社

---

ステップ4：結果を提示する

JSONをそのまま出力するのではなく、要約します。各企業について、名前、概要、バッチ、チーム規模、ステータス、採用状況（成長の兆候）、ウェブサイトを示します。バッチについては規模と注目すべき企業を最初に示します。業界やタグについては件数と、上位または採用中の企業を示します。調査に関する質問では、件数、よく見られる業界、チーム規模の分布などの集計統計を示します。データセットは毎日更新されることも伝えます。

---

ステップ5：診断

リクエストに失敗した場合：

エラー	原因	対処方法
404 Not Found	無効なバッチ名、業界名、またはタグ名	meta.json で有効な名前を確認します
空の配列 []	クエリに一致する企業がありません	検索範囲を広げるか、スペルを確認します
curl: Could not resolve host	インターネットに接続されていません	ネットワーク接続を確認します
応答が大きい／遅い	companies/all.json（5,700件以上）を取得しています	より具体的なエンドポイントを使うか、jq フィルターを追加します

有効なバッチ名、業界名、タグ名を確認するには：

# List all batches
curl -s https://yc-oss.github.io/api/meta.json | jq '.batches[].name'

# List all industries
curl -s https://yc-oss.github.io/api/meta.json | jq '.industries[].name'

# List all tags (there are 333+)
curl -s https://yc-oss.github.io/api/meta.json | jq '.tags[].name'

---

参考ファイル

• references/api_reference.md — 企業のスキーマ、すべてのエンドポイント URL、調査ワークフローの例を含む、エンドポイントの完全なリファレンス

企業の正確なフィールドスキーマ、有効なバッチ名／業界名／タグ名、または詳細な調査ワークフローのパターンが必要な場合は、参考ファイルを読みます。