Installation
$npx skills add publora/skills --skill linkedin-postSummary
Schedule LinkedIn posts with text, images, videos, and PDFs to specified times. This enables an agent to publish content programmatically, manage post scheduling workflows, and integrate LinkedIn distribution into larger content pipelines.
SKILL.MD
LinkedIn Post
Create and schedule LinkedIn posts using the Publora MCP server. Supports text posts, single images, multi-image posts (grid layout), videos, and PDF documents.
Prerequisites
Plans: Starter (free), Pro, Premium - LinkedIn is available on all plans including free.
Getting Started
- Create account at publora.com/register (free)
- Connect LinkedIn via OAuth in Publora Dashboard
- Get API key at publora.com/settings/api
- Configure MCP in Claude Desktop (
~/.claude/claude_desktop_config.json):
{
"mcpServers": {
"publora": {
"type": "http",
"url": "https://mcp.publora.com",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
REST API Fallback
If the MCP server is unavailable or returns errors, use the REST API directly:
Base URL: https://api.publora.com/api/v1
Authentication: Use x-publora-key header (NOT Authorization: Bearer):
# Get your connected platforms
curl -X GET "https://api.publora.com/api/v1/platform-connections" \
-H "x-publora-key: sk_your_api_key"
# Create a post
curl -X POST "https://api.publora.com/api/v1/create-post" \
-H "x-publora-key: sk_your_api_key" \
-H "Content-Type: application/json" \
-d '{
"platforms": ["linkedin-Tz9W5i6ZYG"],
"content": "Your post content here",
"scheduledTime": "2026-03-25T10:00:00Z"
}'
Platform ID Format: linkedin-{id} where {id} is from /platform-connections response.
Example IDs: linkedin-Tz9W5i6ZYG, linkedin-abc123xyz
📖 Full API documentation: docs.publora.com
Plan Limits
| Plan | Posts/month | Price |
|---|---|---|
| Starter | 15 | Free |
| Pro | 100/account | $2.99/account/month |
| Premium | 500/account | $9.99/account/month |
Platform Limits
| Feature | Limit |
|---|---|
| Characters | 3,000 max |
| Visible before "see more" | First 210 characters |
| Images | Up to 10 (grid layout, not swipeable carousel) |
| Image size | 5 MB max |
| Image formats | JPEG, PNG, GIF, WebP (WebP auto-converted) |
| Video duration | 30 minutes |
| Video size | 500 MB max |
| Video format | MP4 only |
Available Tools
create_post
Create a new LinkedIn post or schedule for later.
Parameters:
platforms: Array including your LinkedIn connection ID (e.g.,["linkedin-abc123"])content: Post text (up to 3,000 characters)scheduledTime: ISO 8601 datetime (required - for immediate posting, use current time + 1 minute)
get_upload_url
Get a presigned URL to upload media.
Parameters:
postGroupId: The post ID to attach media tofileName: File name (e.g., "chart.png")contentType: MIME type (e.g., "image/jpeg", "video/mp4", "application/pdf")type: "image" or "video"
list_posts / update_post / delete_post
Manage your scheduled and draft posts.
Mentioning People and Companies
LinkedIn posts support @mentions using URN syntax:
@{urn:li:person:MEMBER_ID|Display Name} # Mention a person
@{urn:li:organization:ORG_ID|Company Name} # Mention a company
Example:
Great insights from @{urn:li:person:4986615|Serge Bulaev} at @{urn:li:organization:107107343|Creative Content Crafts Inc}!
Important: The display name must exactly match the LinkedIn profile name (case-sensitive), including company suffixes like "Inc", "LLC", etc.
Important API Restrictions
-
No organic carousels: Swipeable multi-image carousels are NOT available via API (only for sponsored content). Multi-image posts appear as a grid layout.
-
No mixed media: Cannot combine images with videos or documents in the same post.
-
No rich text: LinkedIn API does not support bold, italic, or other formatting. Use plain text or Unicode characters for emphasis.
-
PDF alternative for carousels: To share multi-page swipeable content, upload a PDF document instead.
Examples
Simple Text Post
Schedule a LinkedIn post for tomorrow at 9 AM:
"We're thrilled to announce the release of our AI writing assistant. After 18 months of development, we're ready to help teams write better content faster."
Post with Mention
Create a LinkedIn post mentioning our CEO:
"Excited to share insights from @{urn:li:person:4986615|Serge Bulaev} on the future of AI in content creation."
Multi-Image Post
Create a LinkedIn post with 4 product screenshots showing our new dashboard features.
Note: Images will appear in a grid layout, not as a swipeable carousel.
PDF Document Post
Share our Q4 report as a PDF on LinkedIn with a summary caption.
This is the best way to share multi-page carousel-like content.
Best Practices
- First line matters: First 210 characters appear before "see more" - make them compelling
- Optimal length: Posts under 1,300 characters tend to perform better
- Posting times: Tuesday-Thursday, 8-10 AM in your audience's timezone
- Hashtags: Use 3-5 relevant hashtags - they're supported as plain text
- Engagement: End with a question to encourage comments
Troubleshooting
| Error | Cause | Solution |
|---|---|---|
| "Account not connected" | LinkedIn OAuth expired | Reconnect in Publora dashboard |
| "MEDIA_ASSET_PROCESSING_FAILED" | File too large or wrong format | Check: images < 5 MB, videos < 500 MB MP4 |
| "Rate limited" (429) | Too many API calls | Wait and retry with backoff |
| "Cannot mix media types" | Images + video in same post | Use only one media type per post |
| MCP unavailable | Server issue | Use REST API fallback (see above) |