@opendirectory.dev/skills 0.1.65 → 0.1.67

package/skills/yc-intent-radar-skill/README.md

@@ -1,4 +1,4 @@
-# YC Intent Radar
+# YC Intent Radar
 
 <img width="1280" height="640" alt="yc-intent-radar-cover" src="https://github.com/user-attachments/assets/2328ae2b-1b5d-45ad-8604-b90721b8d398" />
 
@@ -27,3 +27,37 @@ https://github.com/user-attachments/assets/cea8b565-2002-4a87-8857-d902bfcfdc1c
 4. Choose the option to **Upload a skill**, and drag and drop the `.zip` file (or you can extract it and drop the folder, both work).
 
 > **Note:** For some skills (like `position-me`), the `SKILL.md` file might be located inside a subfolder. Always make sure you are uploading the specific folder that contains the `SKILL.md` file!
+
+## Features
+- **Deduplication:** Utilizes `better-sqlite3` to store state, ensuring you never scrape the same job twice.
+- **Robust Extraction:** Identifies hidden JSON payloads on YC pages to grab accurate backend `job_id` values.
+- **Filtered Exports:** Includes an export script (`export_radar_candidates.js`) that queries the SQLite database for intent-based hiring (e.g., GTM, DevRel, Growth, Content) and outputs it as a JSON payload for secondary research tools.
+
+## Setup
+1. Clone the repository.
+2. Navigate to the `scripts/` directory:
+   ```bash
+   cd scripts
+   npm install
+   npx playwright install
+   ```
+
+3. **Authenticate (First Time Only):**
+   Run the following script and log in to YC via the browser that opens. This creates a `state.json` file.
+   ```bash
+   node auth.js
+   ```
+
+4. **Run the Scraper:**
+   ```bash
+   node scraper.js
+   ```
+
+5. **Export Targeted Jobs:**
+   ```bash
+   node export_radar_candidates.js
+   ```
+   This will query the DB and produce `radar_candidates.json` containing the targeted companies and matching roles.
+
+## Note on Sensitive Files
+The `.gitignore` strictly protects your `state.json` (authentication cookies) and `jobs.db` (local history). Do not commit these files to a public repository.