---
name: apify-collect
description: Collect fresh job-posting URLs into ~/.dear-hiring-manager/urls.txt by running an Apify job scraper — the discovery source for /batch. Runs a configured Apify actor via the Apify API (Bearer-header auth) with a search built from the profile's desired titles + level + location, extracts the direct application URL per job, and de-dupes against already-submitted jobs. Use for /apify-collect.
---

# Apify collect

Gather fresh job URLs into `~/.dear-hiring-manager/urls.txt` (the single input to `/dear-hiring-manager:batch`)
by running an **Apify** job scraper — purpose-built, far fresher and more complete than web search.

## Config
- **`APIFY_TOKEN`** — your Apify API token. Read from `~/.dear-hiring-manager/.env` (`APIFY_TOKEN=...`) or
  the `APIFY_TOKEN` env var. **Never** put it in the repo, in a URL, in command output, or in any log
  (`.env` is gitignored).
- **`APIFY_ACTOR`** — the Apify job-scraper actor to run (a LinkedIn / Indeed / ATS-board actor of your
  choice). Set it in the same `.env`, or ask the user which actor to use.
- **`APIFY_INPUT`** (optional) — a JSON template for that actor's input, using **its own field names**
  (actor input schemas differ — there is no universal `search`/`location` contract). Put it in
  `~/.dear-hiring-manager/apify.json` (or point to a file). If it's absent, **fetch the actor's input
  schema first** (`GET https://api.apify.com/v2/acts/$APIFY_ACTOR` with the Bearer header) and build the
  input from the schema + the profile targets, then confirm with the user before running.

## Procedure
1. **Load the token without echoing it**, e.g.
   `APIFY_TOKEN=$(grep -m1 '^APIFY_TOKEN=' ~/.dear-hiring-manager/.env | cut -d= -f2-)` (fall back to the
   env var); same for `APIFY_ACTOR`. If the token is missing, stop and tell the user to put it in
   `~/.dear-hiring-manager/.env`. Never print the token or a command with it expanded.
2. **Build the search** from the profile: `Desired job title(s)` + `Target experience level` + preferred
   locations / remote. Only ask the user if those profile fields are blank.
3. **Build the actor input** from `APIFY_INPUT` (the actor's own field names) or, if unset, from the
   fetched input schema + profile targets (step above). **Run the actor** synchronously with **header
   auth, never the URL:**
   ```
   curl -sS -X POST \
     -H "Authorization: Bearer $APIFY_TOKEN" \
     -H "Content-Type: application/json" \
     -d "$APIFY_INPUT" \
     "https://api.apify.com/v2/acts/$APIFY_ACTOR/run-sync-get-dataset-items"
   ```
   No `?token=` in the URL; do not echo the token or the expanded command.
4. **Extract the application URL** per returned item. **Do NOT assume a field name** — actor outputs
   differ. Scan each item for URL-valued fields and pick the **direct company/ATS apply link** (a field
   like `applyUrl` / `externalApplyUrl` / `companyApplyUrl`, or any Greenhouse/Lever/Ashby/Workday URL),
   preferring it over the aggregator `jobUrl` (linkedin.com / indeed.com). Skip items with only an
   Easy-Apply / no external URL. If no item yields a usable URL, tell the user the actor's output shape
   doesn't expose one.

## Write urls.txt
- Prefer **direct ATS URLs** (Greenhouse / Lever / Ashby / Workday); note when only an aggregator URL exists.
- **De-dupe within this batch, and skip jobs already applied or done** — a URL in `applications.md` whose
  status is `submitted`, `rejected`, `interview`, `offer`, or **`filled`**. (`filled` = form filled and
  **parked awaiting the user's Submit** — a success, not a failure; re-queuing it would duplicate the
  application and add a second tracker row.) **Only `blocked` and `in-progress` re-queue** — a CAPTCHA /
  login block or a crashed run deserves a retry. `skipped` stays out unless the user lowers the fit
  threshold; re-queuing a `filled` job requires an explicit retry request from the user.
- Append to `~/.dear-hiring-manager/urls.txt` in the template format (a `# Company — Role` comment above
  each URL). Show the user the list + count; append or replace on their confirmation, never clobber silently.
- Tell them to run `/dear-hiring-manager:batch`.

## Rules
- Public postings only. The Apify token lives in `.env` / env — **never** in the repo, a URL, output, or a log.
- Authenticate with the `Authorization: Bearer` header, not a `?token=` query param.
- Prefer the direct application URL; an aggregator page (LinkedIn / Indeed) is a weak fallback that `apply`
  handles less well.
- Human-readable `urls.txt`; `/batch` needs nothing but that file.