# Link Building -- Build Stage

Run the Big-Link-Man (BLM) CLI to ingest a Cora report and generate tiered backlink content.

## What You Have

- A Cora `.xlsx` report on the NAS at `//PennQnap1/SHARE1/Cora72-for-macro/`
- The task's keyword, target URL, and optional CLI flags in the Task Context below

## Steps

### 1. Find the Cora .xlsx File

Search `//PennQnap1/SHARE1/Cora72-for-macro/` for a file matching the task keyword. The filename is a slugified version of the keyword (e.g., "gearbox oil sight glass" -> `gearbox_oil_sight_glass.xlsx`). Use glob/ls to find it. If multiple matches exist, pick the most recent.

### 2. Run ingest-cora

Run the BLM CLI using its own venv Python (NOT the system Python or CheddahBot's venv):

```bash
E:/dev/Big-Link-Man/.venv/Scripts/python.exe main.py ingest-cora \
  -f "<path_to_xlsx>" \
  -n "<keyword>" \
  -m "<target_url>" \
  <additional_cli_flags>
```

- Working directory: `E:/dev/Big-Link-Man`
- Always pass `-m` with the target URL (prevents interactive prompts)
- If BrandedPlusRatio is provided and not 0.7, add `-bp <value>`
- If CustomAnchors is provided, add `-a "<anchors>"`
- If CLIFlags is provided, append them as-is (e.g. `--tier1-count 6`)
- BLM credentials are in env vars `BLM_USERNAME` and `BLM_PASSWORD` -- pass them as `-u` and `-p`

**Expected output:** Look for lines like:
- `Success: Project 'name' created (ID: 42)`
- `Job file created: jobs/some-file.json`

If exit code is non-zero, stop and report the error including stdout and stderr.

### 3. Run generate-batch

Using the job file path from step 2:

```bash
E:/dev/Big-Link-Man/.venv/Scripts/python.exe main.py generate-batch \
  -j "<job_file_path>" \
  --continue-on-error
```

- Working directory: `E:/dev/Big-Link-Man`
- Always include `--continue-on-error`
- Pass `-u` and `-p` credentials from env vars
- This step can take several minutes

If exit code is non-zero, stop and report the error.

### 4. Collect Output

After generate-batch completes, the generated content files are in Big-Link-Man's output directory. Copy the relevant output files to the current working directory so they get uploaded to ClickUp.

Look in `E:/dev/Big-Link-Man/output/` for the project folder matching the keyword. Copy all `.md`, `.txt`, and `.html` files from there to the current working directory.

## Important

- NEVER use `uv run` or CheddahBot's Python -- always use BLM's venv at `E:/dev/Big-Link-Man/.venv/Scripts/python.exe`
- If the venv doesn't exist, stop and report the error
- Do not modify any BLM source code
- Do not create subdirectories in the working directory