yc-reader

# Y Combinator Reader (Read-Only) Fetches Y Combinator company data from the [yc-oss/api](https://github.com/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. --- ## Step 1: Verify Prerequisites 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")` ``` If `JQ_MISSING`, install it: ```bash # 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. --- ## Step 2: Identify What the User Needs 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...