70 lines
2.5 KiB
Markdown
70 lines
2.5 KiB
Markdown
# 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
|