yc-reader

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Y Combinator Reader (Read-Only)

Y Combinator 阅读器（只读）

Fetches Y Combinator company data from the yc-oss/api, an unofficial open-source API that indexes all publicly launched YC companies. The data is sourced from YC's Algolia search index and updated daily via GitHub Actions.

This is a read-only data source. It provides company profiles, batch listings, industry/tag breakdowns, hiring status, and diversity data. No write operations exist — the API serves static JSON files.

No authentication required. The API is public and free. Just use

curl

to fetch JSON endpoints.

从yc-oss/api获取Y Combinator公司数据，这是一个非官方开源API，收录了所有公开上线的YC公司数据。数据来源于YC的Algolia搜索索引，通过GitHub Actions每日更新。

这是只读数据源，提供公司简介、批次列表、行业/标签分类、招聘状态和多元化数据，不支持写入操作，API仅提供静态JSON文件。

无需身份验证，API公开免费，直接使用

curl

即可请求JSON接口。

Step 1: Verify Prerequisites

步骤1：检查前置依赖

This skill only needs

curl

(to fetch data) and

jq

(to parse/filter JSON). Both are pre-installed on most systems.

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

JQ_MISSING

, install it:

bash

undefined

该技能仅需要

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

，请安装：

bash

undefined

macOS

brew install jq

Linux (Debian/Ubuntu)

sudo apt-get install jq


If `jq` is unavailable, you can still fetch raw JSON with `curl` and parse it inline with Python or other tools — but `jq` makes filtering much easier.

---

sudo apt-get install jq


如果无法安装`jq`，你仍然可以用`curl`拉取原始JSON，再通过Python或其他工具解析，但`jq`能大幅简化过滤操作。

---

Step 2: Identify What the User Needs

步骤2：明确用户需求

Match the user's request to the appropriate endpoint. See

references/api_reference.md

for full details.

User Request	Endpoint	Notes
Overall YC stats	`meta.json`	Company count, batch list, industry/tag lists
All companies	`companies/all.json`	Full dataset (~5,700 companies) — large response
Top companies	`companies/top.json`	~91 top-performing YC companies
Companies hiring	`companies/hiring.json`	~1,400 currently hiring
Non-profit companies	`companies/nonprofit.json`	YC-backed non-profits
Diversity data	`companies/black-founded.json` , `hispanic-latino-founded.json` , `women-founded.json`	Founder diversity
Specific batch	`batches/{batch-name}.json`	e.g., `winter-2025.json` , `summer-2024.json`
By industry	`industries/{industry}.json`	e.g., `fintech.json` , `healthcare.json`
By tag	`tags/{tag}.json`	e.g., `ai.json` , `developer-tools.json`

将用户请求匹配到对应接口，完整详情可查看

references/api_reference.md

。

用户请求	接口路径	说明
YC整体统计数据	`meta.json`	公司总数、批次列表、行业/标签列表
所有公司	`companies/all.json`	完整数据集（约5700家公司）- 响应体积较大
头部公司	`companies/top.json`	约91家表现优异的YC公司
正在招聘的公司	`companies/hiring.json`	约1400家当前开放招聘的公司
非营利公司	`companies/nonprofit.json`	YC投资的非营利组织
多元化数据	`companies/black-founded.json` , `hispanic-latino-founded.json` , `women-founded.json`	创始人群体多元化数据
特定批次	`batches/{batch-name}.json`	例如 `winter-2025.json` 、 `summer-2024.json`
按行业查询	`industries/{industry}.json`	例如 `fintech.json` 、 `healthcare.json`
按标签查询	`tags/{tag}.json`	例如 `ai.json` 、 `developer-tools.json`

Batch name format

批次命名格式

Batches use

{season}-{year}

format:

winter-2025

summer-2024

fall-2025

. Older batches use the same pattern back to

summer-2005

批次采用

{季节}-{年份}

格式：

winter-2025

、

summer-2024

、

fall-2025

，更早的批次也沿用相同格式，最早可到

summer-2005

。

Industry and tag name format

行业和标签命名格式

Use lowercase with hyphens for multi-word names:

real-estate

developer-tools

machine-learning

多词名称使用小写加连字符格式：

real-estate

、

developer-tools

、

machine-learning

。

Step 3: Execute the Request

步骤3：执行查询请求

Base URL

基础URL

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

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

General pattern

通用请求格式

bash

undefined

bash

undefined

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"))]'

undefined

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

undefined

Key rules

核心规则

Use
-s
flag with curl to suppress progress output
Pipe through
jq
for readable output and filtering
Avoid fetching
companies/all.json
unless necessary — it's a large response (~5,700 companies). Prefer more specific endpoints (batches, industries, tags) when possible
Use
jq
select/filter to narrow results client-side when the API doesn't have a specific endpoint for what the user wants
Batch names are lowercase with hyphens —
```
winter-2025
```
not
```
Winter 2025
```
or
```
W25
```
Tag and industry names are lowercase with hyphens —
```
developer-tools
```
not
```
Developer Tools
```

curl命令添加
```
-s
```
参数屏蔽进度输出
通过管道符传递给
```
jq
```
实现可读输出和过滤
除非必要，避免请求
```
companies/all.json
```
，它的响应体积很大（约5700家公司），优先使用更具体的接口（批次、行业、标签）
当API没有对应需求的专用接口时，使用
```
jq
```
的select/filter功能在客户端缩小结果范围
批次名称为小写加连字符格式，使用
```
winter-2025
```
而非
```
Winter 2025
```
或
```
W25
```
标签和行业名称为小写加连字符格式，使用
```
developer-tools
```
而非
```
Developer Tools
```

Common jq filters

常用jq过滤器

Filter	Purpose
`jq length`	Count results
`jq '.[0]'`	First company
`jq '.[:10]'`	First 10 companies
`jq '[.[] \| select(.isHiring == true)]'`	Only hiring companies
`jq '[.[] \| select(.status == "Active")]'`	Only active companies
`jq '[.[] \| select(.team_size > 100)]'`	Companies with 100+ employees
`jq '.[] \| {name, one_liner, batch, website}'`	Select specific fields
`jq '[.[] \| select(.name \| test("query"; "i"))]'`	Search by name
`jq 'sort_by(-.team_size) \| .[:10]'`	Top 10 by team size

过滤器	用途
`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

Step 4: Present the Results

步骤4：展示结果

After fetching data, present it clearly for startup/venture research:

Summarize key data — company name, one-liner, batch, team size, status, and website
Highlight hiring status — note which companies are actively hiring (growth signal)
Include website URLs when the user might want to visit the company
For batch listings, summarize the batch size and notable companies
For industry/tag queries, highlight trends (how many companies, which are top/hiring)
For research queries, provide aggregate stats (count, common industries, team size distribution)
Note the data freshness — the API updates daily, so data is near-real-time

拉取数据后，为创业/创投研究场景清晰呈现结果：

核心数据汇总：公司名称、一句话简介、所属批次、团队规模、状态、官网
突出招聘状态：标注哪些公司正在开放招聘（增长信号）
当用户可能需要访问公司官网时，包含网站URL
批次查询场景：汇总批次规模和知名公司
行业/标签查询场景：突出趋势（公司数量、头部/招聘公司占比）
研究类查询：提供聚合统计数据（数量、热门行业、团队规模分布）
标注数据新鲜度：API每日更新，数据接近实时

Step 5: Diagnostics

步骤5：问题排查

If a request fails:

Error	Cause	Fix
`404 Not Found`	Invalid batch, industry, or tag name	Check `meta.json` for valid names
Empty array `[]`	No companies match the query	Broaden the search or check spelling
`curl: Could not resolve host`	No internet connection	Check network connectivity
Large/slow response	Fetching `companies/all.json` (5,700+ entries)	Use a more specific endpoint or add `jq` filters

To discover valid batch, industry, and tag names:

bash

undefined

如果请求失败：

错误	原因	解决方案
`404 Not Found`	批次、行业或标签名称无效	查看 `meta.json` 获取有效名称
空数组 `[]`	没有匹配查询的公司	扩大搜索范围或检查拼写
`curl: Could not resolve host`	无网络连接	检查网络连通性
响应体积大/加载慢	请求了 `companies/all.json` （5700+条记录）	使用更具体的接口或添加 `jq` 过滤