Y Combinator Reader (読み取り専用)

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

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

認証は不要です。 API は公開かつ無料です。JSON エンドポイントを取得するには curl を使用するだけです。

---

ステップ 1: 前提条件の確認

このスキルには curl（データ取得用）と jq（JSON解析・フィルタリング用）のみが必要です。両方とも大多数のシステムにプリインストールされています。

!`(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	~91 のトップ YC 企業
採用中の企業	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/

一般的なパターン

# フェッチして見やすく表示
curl -s https://yc-oss.github.io/api/companies/top.json | jq .

# 結果の企業数をカウント
curl -s https://yc-oss.github.io/api/batches/winter-2025.json | jq length

# フィールドでフィルター (例: バッチ内の採用中の企業)
curl -s https://yc-oss.github.io/api/batches/winter-2025.json | jq '[.[] | select(.isHiring == true)]'

# 特定フィールドを抽出
curl -s https://yc-oss.github.io/api/companies/top.json | jq '.[] | {name, one_liner, batch, team_size, website}'

# 名前で検索 (大文字小文字不問)
curl -s https://yc-oss.github.io/api/companies/all.json | jq '[.[] | select(.name | test("stripe"; "i"))]'

主なルール

1. curl で -s フラグを使用 進捗出力を非表示にします
2. jq でパイプ 見やすい出力とフィルタリング用
3. companies/all.json の取得は必要な場合のみ — 大きなレスポンス (~5,700企業)。可能な限り、より詳細なエンドポイント (バッチ、業界、タグ) を優先してください
4. jq select/filter を使用 API が特定のエンドポイントを持たない場合、クライアント側で結果を絞る
5. バッチ名は小文字ハイフン — winter-2025 で Winter 2025 や W25 ではない
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: 結果を提示

データを取得した後、スタートアップ・ベンチャー調査向けに明確に提示します:

1. 主要データをサマライズ — 企業名、ワンライナー、バッチ、チームサイズ、ステータス、ウェブサイト
2. 採用状況をハイライト — 積極採用中の企業を記載 (成長シグナル)
3. ウェブサイト URL を含める ユーザーが企業を訪問したいときのため
4. バッチリスト向けに, バッチサイズと注目企業をサマライズ
5. 業界・タグクエリ向けに, トレンドをハイライト (企業数、トップ/採用中の企業)
6. 調査クエリ向けに, 集計統計を提供 (数、共通業界、チームサイズ分布)
7. データの鮮度を記載 — API は毎日更新されるため、データはほぼリアルタイムです

---

ステップ 5: 診断

リクエストが失敗した場合:

エラー	原因	対処
404 Not Found	無効なバッチ、業界、またはタグ名	meta.json で有効な名前を確認
空配列 []	クエリに一致する企業がない	検索を拡張するか、スペルを確認
curl: Could not resolve host	インターネット接続なし	ネットワーク接続を確認
大きい/遅いレスポンス	companies/all.json (5,700+ エントリ) を取得中	より詳細なエンドポイントを使用するか、jq フィルターを追加

有効なバッチ、業界、タグ名を検出:

# すべてのバッチをリスト
curl -s https://yc-oss.github.io/api/meta.json | jq '.batches[].name'

# すべての業界をリスト
curl -s https://yc-oss.github.io/api/meta.json | jq '.industries[].name'

# すべてのタグをリスト (333以上)
curl -s https://yc-oss.github.io/api/meta.json | jq '.tags[].name'

---

リファレンスファイル

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

企業フィールドスキーマの詳細、有効なバッチ・業界・タグ名、詳細な調査ワークフローパターンが必要な場合はリファレンスファイルをお読みください。