2.5 KiB

Raw Blame History

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):

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:

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

2.5 KiB Raw Blame History