Linkedin Post

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

1. Create account at publora.com/register (free)
2. Connect LinkedIn via OAuth in Publora Dashboard
3. Get API key at publora.com/settings/api
4. 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-XXXXXXXXXX"],
    "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-XXXXXXXXXX, linkedin-abc123xyz

📖 Full API documentation: docs.publora.com

Plan Limits

Platform Limits

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 to
• fileName: 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

1. No organic carousels: Swipeable multi-image carousels are NOT available via API (only for sponsored content). Multi-image posts appear as a grid layout.

2. No mixed media: Cannot combine images with videos or documents in the same post.

3. No rich text: LinkedIn API does not support bold, italic, or other formatting. Use plain text or Unicode characters for emphasis.

4. 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

1. First line matters: First 210 characters appear before "see more" - make them compelling
2. Optimal length: Posts under 1,300 characters tend to perform better
3. Posting times: Tuesday-Thursday, 8-10 AM in your audience's timezone
4. Hashtags: Use 3-5 relevant hashtags - they're supported as plain text
5. Engagement: End with a question to encourage comments

Troubleshooting

Comments, Replies & Reactions (REST)

Тот же PUBLORA_API_KEY покрывает не только посты, но и комменты с реакциями. URL-парсер и готовые Python-обёртки лежат в ~/.claude/skills/publora-post/scripts/lib/.

URL → URN parser

LinkedIn использует 3 типа URN: activity, share, ugcPost. URL-форматы тоже три. Парсер их нормализует:

# Один файл, без зависимостей кроме stdlib
python ~/.claude/skills/publora-post/scripts/lib/url_parser.py \
  "https://www.linkedin.com/posts/janedoe_activity-7448808898326654978-iW20"

# Output:
# {
#   "post_activity_id": "7448808898326654978",
#   "post_urn": "urn:li:activity:7448808898326654978",
#   "comment_id": null,
#   "comment_urn": null,
#   "url_type": "post"
# }

URL коммента (?commentUrn=urn%3Ali%3Acomment%3A%28activity%3APOST%2CCOMMENT%29) парсится в полный комплект post_urn + comment_id + comment_urn.

POST /linkedin-comments

curl -X POST "https://api.publora.com/api/v1/linkedin-comments" \
  -H "x-publora-key: $PUBLORA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "postedId": "urn:li:activity:7448808898326654978",
    "message": "Concrete take + a question that earns a reply.",
    "platformId": "linkedin-XXXXXXXXXX"
  }'

Лимит: 1,250 символов на коммент. Поддержка @mentions через @{urn:li:person:ID|Name}.

POST /linkedin-comments — reply на коммент

LinkedIn flattens thread to 2 уровня. Если отвечаешь на ответ — parentComment всё равно ссылается на top-level коммент, не на reply, иначе API ругнётся.

curl -X POST "https://api.publora.com/api/v1/linkedin-comments" \
  -H "x-publora-key: $PUBLORA_API_KEY" \
  -d '{
    "postedId": "urn:li:activity:7448808898326654978",
    "message": "Reply text",
    "platformId": "linkedin-XXXXXXXXXX",
    "parentComment": "urn:li:comment:(urn:li:activity:7448808898326654978,7449095071892672512)"
  }'

POST /linkedin-reactions

Валидные типы: LIKE, PRAISE, EMPATHY, INTEREST, APPRECIATION, ENTERTAINMENT.

⚠️ INSIGHTFUL НЕ валиден в Publora API — маппится в INTEREST автоматически в Python-клиенте, но если шлёшь curl напрямую — используй сразу INTEREST.

curl -X POST "https://api.publora.com/api/v1/linkedin-reactions" \
  -H "x-publora-key: $PUBLORA_API_KEY" \
  -d '{
    "postedId": "urn:li:activity:7448808898326654978",
    "platformId": "linkedin-XXXXXXXXXX",
    "reactionType": "INTEREST"
  }'

DELETE /linkedin-comments

curl -X DELETE "https://api.publora.com/api/v1/linkedin-comments" \
  -H "x-publora-key: $PUBLORA_API_KEY" \
  -d '{"postedId": "...", "commentId": "...", "platformId": "..."}'

Готовый Python wrapper

import sys
sys.path.insert(0, "~/.claude/skills/publora-post/scripts")
from lib import PubloraClient, parse_linkedin_url

parsed = parse_linkedin_url("https://www.linkedin.com/posts/janedoe_activity-7448808898326654978-iW20")
client = PubloraClient()  # берёт PUBLORA_API_KEY из env
client.create_reaction(
    post_urn=parsed["post_urn"],
    platform_id="linkedin-XXXXXXXXXX",
    reaction_type="INTEREST",
)
client.create_comment(
    post_urn=parsed["post_urn"],
    message="Sharp comment with a question.",
    platform_id="linkedin-XXXXXXXXXX",
)

Best practice — react before comment

Посты, которые сначала получают реакцию автора, а потом коммент — выше в feed автора. Pause 8-15 секунд между реакцией и комментом, чтобы это не выглядело как боттинг. Готовый CLI:

python ~/.claude/skills/publora-post/scripts/post_comment.py \
  "<POST_URL>" "<COMMENT_TEXT>" --reaction INTEREST

URN fallback при 404

Иногда url_parser возвращает urn:li:activity:..., а каноничный URN на бэке — urn:li:ugcPost:.... Если POST падает с 404:

1. Через HarvestAPI/ScrapeCreators дотянуть /linkedin/post-comments для этого поста.
2. Из любого существующего коммента взять поле postId — это и есть каноничный URN.
3. Повторить POST с правильным URN.

Связанные скиллы

• linkedin-comment-drafter — драфтит коммент с 7 проверенными паттернами и approval-картой
• linkedin-reply-handler — корректно обрабатывает 2-level flattening для replies
• linkedin-thread-engagement — мониторит твои комменты на ответ автора (окно ответа автора, 6-24 ч)