Appearance
Standard Operating Procedure (SOP) User Guide
Quick Summary
This SOP provides clear, actionable instructions for operating the LinkedIn Automation System in preview, live, and fully automated modes.
1. Operating Instructions
Procedure 1: Generating a Single Post Preview
- Open terminal and navigate to project root.
- Run preview command with your target topic:bash
python main.py --action post --topic "Future of Agentic AI" --preview - Inspect generated text and character counts output in terminal.
Procedure 2: Publishing a Live Post to LinkedIn
- Verify
LINKEDIN_ACCESS_TOKENis active in.env. - Execute live posting action:bash
python main.py --action post --topic "Future of Agentic AI" --live - Check returned URL in stdout and verify post appearance on LinkedIn.
Procedure 3: Running End-to-End Orchestration Workflow
- Execute full orchestration with deep research mode:bash
python main.py --action orchestrate --topic "AI 2026" --research-mode deep --live - The orchestrator will automatically:
- Query NotebookLM for insights
- Run deep web research
- Draft and validate post against
soul.py - Publish to LinkedIn
- Stream telemetry to OBS HUD
2. Troubleshooting & FAQ
Error: NLM Auth Invalid
Cause: Stale browser cookies or expired session tokens in NotebookLM MCP.
Resolution: Run nlm login in terminal to refresh cookies, then execute python main.py --action health.
Error: JudgeGuard WORK_LOG.md is stale
Cause: No active 🟡 Starting entry logged in WORK_LOG.md within the past 5 minutes.
Resolution: Append echo "🟡 Starting [YOUR_ACTION]" >> WORK_LOG.md before running your command.
Error: LinkedIn Access Token Invalid
Cause: Expired OAuth2 bearer token.
Resolution: Run python setup_linkedin_auth.py to refresh OAuth tokens.