| name | linkedin-poster |
| description | Create and publish LinkedIn posts for business/sales content using the
official LinkedIn UGC Posts API. Use when asked to post on LinkedIn,
schedule a sales post, or process an approved LinkedIn post action from
vault/Approved/. Always draft first and require human approval before posting.
|
LinkedIn Poster
Publish posts to a LinkedIn personal profile using the official UGC Posts API (no browser required).
When to Use
- Processing an
APPROVAL_SEND_LINKEDIN_POST_*.md file from vault/Approved/
- Creating a new sales/business post when explicitly instructed by the user
- Drafting post content for human review (no approval needed for drafts)
Never post directly — always route through vault/Pending_Approval/ first.
One-Time Setup
1. Create a LinkedIn Developer App
- Go to https://www.linkedin.com/developers/ → Create App
- Select your LinkedIn Company Page as the associated company
- Under Products, request: Share on LinkedIn + Sign In with LinkedIn using OpenID Connect
- Under Auth tab → copy Client ID and Client Secret
- Add Redirect URL:
http://localhost:8765/callback
2. Add credentials to .env
LINKEDIN_API_CLIENT_ID=xxxxx
LINKEDIN_API_CLIENT_SECRET=xxxxx
3. Run the OAuth helper to get your access token
python watchers/auth_linkedin_api.py
This opens your browser, completes the OAuth flow, and prints the values to add to .env:
LINKEDIN_API_ACCESS_TOKEN=xxxxx
LINKEDIN_API_PERSON_URN=urn:li:person:xxxxx
Tokens last ~60 days. Re-run the auth helper when expired.
Approval File Format
---
type: approval_request
action: send_linkedin_post
status: approved
---
# What will happen after approval?
The following post will be published to LinkedIn.
## Message / Content
[Hook line here]
[Body paragraphs]
[CTA]
#hashtag1 #hashtag2 #hashtag3
Save to vault/Approved/APPROVAL_SEND_LINKEDIN_POST_<topic>_<YYYY-MM-DD>.md
Dry-Run Mode
python .claude/skills/linkedin-poster/scripts/create_post.py \
--content "Post text..." --dry-run
Expected output:
{"status": "dry_run", "content_len": 42, "preview": "Post text...", "timestamp": "..."}
Live Post
python .claude/skills/linkedin-poster/scripts/create_post.py \
--content "Post text..."
Expected output:
{"status": "posted", "post_id": "urn:li:share:...", "post_url": "https://www.linkedin.com/feed/update/...", "timestamp": "..."}
Post Strategy — Sales Content Framework
Every LinkedIn post should follow one of these proven frameworks:
| Type | When to Use | Hook Pattern |
|---|
| Problem → Solution | New service/offer | "Most [audience] struggle with X. Here's how we solve it:" |
| Story / Social Proof | After a win or client result | "We helped [client type] achieve X in Y days. Here's exactly how:" |
| Value List | Education + awareness | "5 things [audience] should know about [topic]:" |
| Direct Offer | Promotion or launch | "We're opening [N] spots for [service]. Here's what's included:" |
| Question / Poll | Engagement | "Quick question for [audience]: [specific question]?" |
Post Structure
[HOOK — 1-2 lines, no period at end, creates curiosity]
[BODY — 3-7 short paragraphs or bullet points, deliver value]
[CTA — 1 clear call to action: DM, comment, link in bio]
[HASHTAGS — 3-5 relevant hashtags on last line]
Max 3,000 characters. Script enforces this limit.
LinkedIn DM
LinkedIn DMs to arbitrary users are not supported by the API (requires special partner access).
The linkedin-dm skill continues to use Playwright for DMs.
Rules (non-negotiable)
- Never post without a file in
vault/Approved/
- Never post competitor mentions, pricing without approval, or personal information
- Max 1 post per day — LinkedIn penalises over-posting
- Always log every post attempt to
vault/Logs/
