hyperfx-ai/marketing-skills

linkedin

Publish and manage LinkedIn content via the Hyper MCP — text posts, article / link previews, document and PDF posts, organization (company page) posts, and AI-generated text-to-carousel posts.

Ver código fuente

Cómo usar

  1. Copia el comando y revisa el paquete antes de instalarlo en tu entorno de agente.
  2. Consulta las herramientas, credenciales y entornos necesarios en el documento original.
  3. Describe las entradas y el resultado deseado; contrasta la salida con las fuentes.
npx skills add https://github.com/hyperfx-ai/marketing-skills --skill linkedin

Antes de empezar

  • La instalación no incluye suscripción al modelo, cuota API ni permisos sobre tus archivos.
  • Las estrellas e instalaciones reflejan actividad, no una prueba independiente de calidad o seguridad.
Documento original del Skill

Contenido del repositorio de origen con títulos, ejemplos, código, tablas, enlaces e imágenes preservados.

LinkedIn

Skill for publishing to LinkedIn through the LinkedIn integration exposed by the Hyper MCP.

Out of scope — defer to other skills

RequestSend them to
Instagram post / Reel / Storyinstagram
TikTok organic postingtiktok
TikTok ad campaigntiktok-ads
Meta (Facebook / Instagram) adsmeta-ads
Google Ads campaigngoogle-ads
Amazon Sponsored Products campaignamazon-ads

Requirements

If linkedin_create_text_post is not in the tool list, stop and tell the user to enable Hyper MCP and connect LinkedIn.

Tool surface

ToolPurpose
linkedin_create_text_postStandard member or organization text post; also article / link posts via the article fields.
linkedin_create_organization_postPost explicitly as a company page (when you already know organization_id).
linkedin_create_document_postPDF / document post — LinkedIn renders pages as a swipeable document.
linkedin_create_carousel_from_textAI text-to-carousel pipeline — generates slides + assembles a PDF + publishes as a document post.

Posting Rules

  1. Use linkedin_create_text_post for standard member or organization posts.
  2. Use linkedin_create_organization_post when the user explicitly wants to post as a company page and you already know the organization_id.
  3. Use linkedin_create_document_post for PDF / document uploads. LinkedIn renders PDF pages as a swipeable document post.
  4. Use linkedin_create_carousel_from_text when the user wants a text-to-carousel workflow driven by AI-generated slides.

Article / Link Posts

Do not rely on LinkedIn to scrape Open Graph metadata for API-created posts.

For reliable article posts:

  • Provide article_url.
  • Prefer explicit article_title, article_description, and thumbnail_url.
  • If those fields are omitted, the backend may derive them from the shared page metadata, but explicit values are still more reliable.

Use this shape when editing or preparing a LinkedIn article post:

python
linkedin_create_text_post(
    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
)

Document and Carousel Posts

LinkedIn carousels are implemented as document posts backed by a PDF.

Native PDF flow

Use linkedin_create_document_post when you already have a PDF URL or stored file ID:

python
linkedin_create_document_post(
    text="Caption text",
    title="Deck title",
    document_url="https://example.com/deck.pdf",
    organization_id="123456789",  # optional
)

Text-to-carousel flow

Use linkedin_create_carousel_from_text when the user wants the system to build the carousel from a block of source text:

python
linkedin_create_carousel_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
)

The current implementation:

  • Parses the source text into slide content.
  • Generates a single grid image with an image model.
  • Splits the grid into individual slide images.
  • Assembles a PDF.
  • Publishes the PDF as a LinkedIn document post.
  • Returns the live post URL — present this to the user to confirm the carousel is live.

Supported slide counts are 4, 6, and 9.

Manual Slide Editing

The current LinkedIn carousel pipeline is PDF-based. It does not provide a first-class live canvas editing loop before publish.

If a user wants manual refinement:

  1. Generate the carousel assets first.
  2. Review or edit the generated slide images / PDF externally.
  3. Post the final PDF with linkedin_create_document_post.

Do not promise an in-product editable canvas workflow unless the tool is actually available in the current environment.

Organization Posting

When posting to a company page:

  • If you don't know the organization_id, call linkedin_get_my_managed_pages() first — it returns all company pages the connected account can post to, with their IDs.
  • Use linkedin_get_organization_posts_detailed(organization_id=...) to preview recent posts before publishing — avoids accidental duplicates.
  • Pass organization_id to whichever posting tool you're using.
  • Expect LinkedIn org posting permissions to matter.
  • If a post fails with a permissions error, verify that the authenticated account can post to that organization.

Failure Modes & Recovery

  • Article preview is empty / wrong. LinkedIn ignored the scraped metadata. Re-call linkedin_create_text_post with explicit article_title, article_description, and thumbnail_url.
  • Permission error on organization post. Confirm with the user that their LinkedIn account has page-posting permission for the target organization_id.
  • `linkedin_create_carousel_from_text` returned an unexpected slide count. Only num_slides of 4, 6, or 9 are supported.
  • Document post fails with an invalid URL. The document_url must be a directly-fetchable PDF (no auth, no HTML redirect page).

Relacionados por tarea

del mismo repositorio

Más Skills

Todos los Skills
hyperfx-ai
Comunidad

meta-ads-library

Research competitor Facebook and Instagram ads from the Meta Ads Library via the Hyper MCP — search by keyword, pull full ad creative and metadata, enrich with page contact info for lead generation, and surface structured ad-intelligence summaries in chat. Use when the user wants to scrape the Meta Ads Library, spy on competitor ads, monitor new ads in a category, build a lead list from advertisers, or surface creative trends across an industry.

Instalaciones / 1h
1
GitHub Stars
116
Actualizado
21 nov
hyperfx-ai
Comunidad

blog-generation

Generate one excellent, on-brand blog post per run for any business, built to rank on Google and get cited by AI search (ChatGPT, Claude, Perplexity, AI Overviews). A stateful engine: reads a brand strategy doc, picks a fresh topic (never repeats), researches, writes in the brand's voice, and logs the post back. Use when the user wants to write a blog post, run a daily or recurring blog task, or generate SEO / AEO / blog content. For keyword data and audits, defer to seo-research.

Instalaciones / 1h
1
GitHub Stars
91
Actualizado
26 sept
hyperfx-ai
Comunidad

reddit-ads

Plan and create Reddit Ads campaigns end-to-end via the Hyper MCP — campaign, ad group, ad build order with subreddit / interest / geo targeting, promoted posts, custom and saved audiences, Reddit pixel conversion tracking, and reporting, with micro-currency budgets. Use when the user wants to launch Reddit ads, promote a Reddit post, target subreddits, set up a Reddit pixel, or pull Reddit ad reports. Also triggers on reddit campaign, reddit ppc, or reddit ads manager.

Instalaciones / 1h
1
GitHub Stars
91
Actualizado
26 sept
hyperfx-ai
Comunidad

ad-creative-generation

Generate on-brand ad creatives — visuals + copy — for Google, Meta (Facebook / Instagram), and other paid platforms via the Hyper MCP. Extracts brand identity from a website, writes ad copy variants, and produces brand-consistent images using reference-based image generation. Use when the user asks for ad creative, ad copy variants, RSA headlines, Meta ad creative, display ads, carousel ads, or A/B test variants.

Instalaciones / 1h
1
GitHub Stars
83
Actualizado
25 ago