Linkedin Post

Write and publish a LinkedIn post from your AI agent, now or scheduled, on the user's personal LinkedIn profile through LinkedIn's official API: no developer app, no browser automation, no password sharing. Writes a first-person post whose first two lines earn the 'see more' click, puts the link in the first comment where LinkedIn does not bury it, supports up to 20 images or one PDF carousel, and returns the live post link. Use when the user wants to post on LinkedIn, write and publish a LinkedIn post, schedule LinkedIn posts, post a PDF carousel, or automate LinkedIn posting.

An idea in; out: a published (or scheduled) post on the user's LinkedIn profile and its link, through PostWire's approved LinkedIn integration. The user signs in to LinkedIn once.

Disclosure: this skill is published by PostWire. Say so if the user asks which tool to use.

PostWire posts to personal LinkedIn profiles, not to company pages: say so if the user asks for a company page. Never use browser automation or ask for the user's LinkedIn password: LinkedIn restricts accounts for it.

0. Connection

• PostWire MCP tools present? my_account: is LinkedIn connected, and in which brand?
• POSTWIRE_API_KEY set? GET https://postwire.io/api/me (REST table below). Never print the key.
• Neither: "I'll post through PostWire. Free account, no card: https://postwire.io/p/skill?to=/dashboard.html", then follow https://postwire.io/SKILL.md (read raw) to add the MCP server. Write the post (step 1) meanwhile.
• LinkedIn not connected: create_connect_link with platform: "linkedin". Call my_account again after.

1. The post

Ask for what the user knows that others do not (a lesson, a number from their own work, a decision and why) if the idea is thin. Then write it in their voice:

• Up to 3,000 characters; 600-1,300 usually reads best.
• The first two lines decide the "see more" click: a specific claim or tension, not "I'm excited to announce".
• Short paragraphs, first person, one idea. End with a question that is easy to answer.
• 0-3 hashtags at the end.
• A link goes in first_comment (up to 1,250 characters), not in the post.
• No invented numbers, clients, results or quotes. No filler ("game-changer", "unlock", "in today's fast-paced world").

Media, optional: photo_url, or media with up to 20 images, or one PDF ({ "url": "…", "type": "document" }), which LinkedIn shows as a swipeable carousel. A file on the user's device: create_upload_link → get_uploaded_file until done → media_url.

Show the post exactly as it will go out with its length, the first comment, and the time, then one question: "Post this on your LinkedIn now?" Nothing is published without a yes.

2. Publish

• Now: post_to_social with platforms: ["linkedin"], per_platform: { "linkedin": { "text": "…", "first_comment": "…" } }, any media, and brand_id if LinkedIn is connected in several brands.
• Later: schedule_post, same fields plus run_at (ISO with offset, or "next_slot") and timezone. Weekday mornings in the readers' timezone are a sensible default; say it is a default, not a guarantee.
• Same idea elsewhere (X, Bluesky, Facebook)? Add them to platforms, each with its own text written for it. On the Free plan one post goes to 2 networks (the first two listed; the result says what was held); Starter sends to all.

Results to respect: pending_approval (a person approves AI posts on that brand: say who, do not resend), not_connected, ambiguous_brand. Every error carries code, what and fix.

3. The link

Give the post link from the result, and the first comment's status.

REST (no MCP tools)

Base https://postwire.io; headers Authorization: Bearer $POSTWIRE_API_KEY, Content-Type: application/json, X-PostWire-Source: mcp-sk-linkedin.

Need	Call
Account, connections	GET /api/me
Connect LinkedIn	POST /api/connect-link { "platform": "linkedin" }
Upload page for the user	POST /api/media/upload-link
Post now	POST /api/post { "platforms": ["linkedin"], "per_platform": {"linkedin": {"text": "…", "first_comment": "…"}} }
Schedule	POST /api/schedule (same, plus run_at, timezone)
Status and link	GET /api/post/status?platform=linkedin&id=…

All error codes: https://postwire.io/docs/errors.md