mcpField
L
linkedin

linkedin

github.com/hyperfx-aiマーケティング・グロース107189 回インストール4 日前に更新
リポジトリ

linkedin について

linkedinは、Hyper MCPが提供するLinkedIn連携を通じて投稿するスキルです。テキスト、記事、ドキュメント、企業ページ、テキストから作るカルーセルに対応し、権限や一般的なエラーへの対処も案内します。

主な機能

  1. 01テキスト投稿と記事投稿
  2. 02PDFをスワイプ式ドキュメントとして投稿
  3. 03テキストからPDFカルーセルを作成・投稿
  4. 04個人または企業ページから投稿
  5. 05企業ページの最近の投稿を確認

活用シーン

  1. 01LinkedInにテキストやリンクを投稿
  2. 02PDFをドキュメント投稿で共有
  3. 03元テキストからカルーセル投稿を作成
  4. 04権限のある企業ページで投稿

MCP 対応

Hyper MCPが提供するLinkedIn連携を利用します。Hyper MCPとLinkedIn連携の接続が必要で、MCPクライアントまたはHyper CLIからツールを実行します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/hyperfx-ai/marketing-skills --skill linkedin

インストール後、Claude Code で/linkedinを入力して読み込まれたか確認します。

詳細

LinkedIn

Hyper MCP が提供する LinkedIn 連携を通じて LinkedIn に投稿するためのスキルです。

対象外 — 該当する別のスキルに依頼してください

リクエスト依頼先
Instagram の投稿／リール／ストーリーinstagram
TikTok のオーガニック投稿tiktok
TikTok 広告キャンペーンtiktok-ads
Meta（Facebook／Instagram）広告meta-ads
Google Ads キャンペーンgoogle-ads
Amazon Sponsored Products キャンペーンamazon-ads

要件

  • Hyper MCP がインストールされ、接続されていること。 https://app.hyperfx.ai/mcp
  • https://app.hyperfx.ai/apps で LinkedIn 連携に接続していること。
  • 会社ページに投稿する場合、接続済みのメンバーアカウントに、その組織の代理で投稿する権限が必要です。

search("linkedin_text_posts_create") で linkedin_text_posts_create が見つからない場合は、処理を停止し、Hyper MCP を有効にして LinkedIn に接続するようユーザーに伝えてください。

このスキルのツールの実行方法

このスキルの各ツールには、正式なツール名が付いています。利用する環境に応じた呼び出し方法で実行してください。

環境ツールを探す実行する
MCP クライアント（Claude、Cursor、Codex、ChatGPT）search("<what you want to do>") を実行し、続けて describe("<name>")call("<name>", {...})
Hyper CLIhyperai search "<what you want to do>" を実行し、続けて hyperai describe <name>hyperai call <name> --json '{...}'

ツールが見つからない場合、その連携はワークスペースに接続されていないか、有効になっていません。処理を停止し、接続する連携をユーザーに伝えてください。

ツール一覧

ツール用途
linkedin_text_posts_createメンバーまたは組織としての標準的なテキスト投稿。記事フィールドを使った記事／リンク投稿にも対応します。
linkedin_organization_posts_create会社ページとして明示的に投稿します（organization_id がすでにわかっている場合）。
linkedin_document_posts_createPDF／ドキュメントの投稿です。LinkedIn ではページがスワイプ可能なドキュメントとして表示されます。
linkedin_carousels_create_from_textAI によるテキストからカルーセルへのパイプラインです。スライドを生成し、PDF を組み立てて、ドキュメント投稿として公開します。

投稿ルール

  1. メンバーまたは組織としての標準的な投稿には linkedin_text_posts_create を使います。
  2. ユーザーが会社ページとしての投稿を明示的に希望し、かつ organization_id がすでにわかっている場合は、linkedin_organization_posts_create を使います。
  3. PDF／ドキュメントをアップロードする場合は、linkedin_document_posts_create を使います。LinkedIn では PDF のページがスワイプ可能なドキュメント投稿として表示されます。
  4. ユーザーが AI 生成スライドによるテキストからカルーセルへのワークフローを希望する場合は、linkedin_carousels_create_from_text を使います。

記事／リンク投稿

API で作成した投稿について、LinkedIn が Open Graph メタデータを取得することを前提にしないでください。

記事を確実に投稿するには、次のようにします。

  • article_url を指定します。
  • article_title、article_description、thumbnail_url を明示的に指定することを推奨します。
  • これらのフィールドを省略した場合、バックエンドが共有ページのメタデータから値を取得することがありますが、明示的に指定したほうが確実です。

LinkedIn の記事投稿を編集または準備する場合は、次の形式を使います。

linkedin_text_posts_create(
    text="Caption text",
    article_url="https://example.com/article",
    article_title="Explicit preview title",
    article_description="Explicit preview description",
    thumbnail_url="https://example.com/thumbnail.jpg",
    organization_id="123456789",  # optional
)

ドキュメント投稿とカルーセル投稿

LinkedIn のカルーセルは、PDF を使ったドキュメント投稿として実装されています。

ネイティブ PDF フロー

PDF の URL または保存済みファイル ID がすでにある場合は、linkedin_document_posts_create を使います。

linkedin_document_posts_create(
    text="Caption text",
    title="Deck title",
    document_url="https://example.com/deck.pdf",
    organization_id="123456789",  # optional
)
テキストからカルーセルへのフロー

ユーザーがソーステキストのブロックからカルーセルを作成するようシステムに求めている場合は、linkedin_carousels_create_from_text を使います。

linkedin_carousels_create_from_text(
    text_content="Source content for the slides",
    title="Carousel title",
    caption="LinkedIn caption",
    num_slides=4,
    style="professional",
    color_scheme="blue",
    organization_id="123456789",  # optional
)

現在の実装では、次の処理を行います。

  • ソーステキストを解析してスライドの内容を作成します。
  • 画像モデルを使って、1 枚のグリッド画像を生成します。
  • グリッドを個々のスライド画像に分割します。
  • PDF を組み立てます。
  • PDF を LinkedIn のドキュメント投稿として公開します。
  • 投稿の公開 URL を返します。カルーセルが公開されたことを確認できるよう、ユーザーに提示してください。

対応するスライド数は 4、6、9 です。

スライドの手動編集

現在のLinkedInカルーセルのパイプラインはPDFベースです。公開前にキャンバス上でリアルタイムに編集する一連のワークフローは、標準機能として提供されていません。

ユーザーが手動で調整したい場合は、次の手順を実行してください。

  1. まずカルーセルのアセットを生成します。
  2. 生成されたスライド画像またはPDFを外部で確認、または編集します。
  3. 最終版のPDFをlinkedin_document_posts_createで投稿します。

現在の環境で実際にツールを利用できない限り、製品内で編集可能なキャンバスを使ったワークフローを約束しないでください。

組織への投稿

会社ページに投稿する場合：

  • organization_idがわからない場合は、まずlinkedin_managed_pages_list()を呼び出してください。接続アカウントから投稿できるすべての会社ページと、そのIDが返されます。
  • 公開前にlinkedin_organizations_posts_list_detailed(organization_id=...)を使用して最近の投稿を確認し、誤って重複投稿しないようにしてください。
  • 使用する投稿ツールにorganization_idを渡してください。
  • LinkedInの組織への投稿権限が影響することに留意してください。
  • 権限エラーで投稿に失敗した場合は、認証済みアカウントがその組織に投稿できることを確認してください。

失敗時の対応と復旧

  • 記事のプレビューが空、または正しくありません。 LinkedInがスクレイピングしたメタデータを無視しました。article_title、article_description、thumbnail_urlを明示してlinkedin_text_posts_createを再度呼び出してください。
  • 組織への投稿で権限エラーが発生します。 対象のorganization_idのページへの投稿権限を、ユーザーのLinkedInアカウントが持っていることを確認してください。
  • linkedin_carousels_create_from_textが予期しない枚数のスライドを返しました。 サポートされているnum_slidesは4、6、9のみです。
  • ドキュメント投稿が無効なURLで失敗します。 document_urlには、直接取得できるPDFを指定する必要があります（認証が必要なURLや、HTMLのリダイレクトページは使用できません）。

コメント

Markdown 対応