yc-reader

Y Combinator 阅读器（只读）

如果你的宿主尚未执行下面的 Shell 探测（例如在 Codex 中），请在选择配置路径之前，使用其 Shell 工具运行 ! 包裹的命令。请依据实际输出；如果无法访问 Shell，请说明这一限制。

从 yc-oss/api 获取 Y Combinator 公司数据。该非官方开源 API 会索引所有已公开推出的 YC 公司。数据来源于 YC 的 Algolia 搜索索引，并通过 GitHub Actions 每日更新。

这是一个只读数据源。 它提供公司简介、批次列表、行业／标签分类、招聘状态和多元化数据。没有写入操作——该 API 提供静态 JSON 文件。

无需身份验证。 该 API 公开且免费。只需使用 curl 获取 JSON 端点。

---

步骤 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/

通用模式

# 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. 使用 curl 的 -s 标志以隐藏进度输出
2. 通过管道传递给 jq，以便查看易读输出并进行筛选
3. 除非必要，否则避免获取 companies/all.json——其响应较大（约 5,700 家公司）。尽可能优先使用更具体的端点（批次、行业、标签）
4. 如果 API 没有提供用户所需内容的专用端点，请使用 jq 的 select/filter 在客户端缩小结果范围
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 步：呈现结果

请总结，而不是直接倾倒 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 和研究工作流示例

需要准确的公司字段架构、有效的批次／行业／标签名称或详细的研究工作流模式时，请阅读参考文件。