/social-engine

name: social-engine
description: Use organic LinkedIn and X as a free creative test kitchen — listen to what people complain about and ask for, draft a week of hooks from customer language and founder opinions, schedule only what you approve, then promote the posts the algorithm picked up into paid tests
version: "1.1.3"
author: Cogny AI
requires: cogny-mcp
platforms: [linkedin-organic, x-organic, youtube, brave-search, discord, crisp, cogny]
user-invocable: true
argument-hint: "[listen|hooks [<campaign-ID>]|results|schedule]"
allowed-tools:
  - mcp__cogny__list_integrations
  - mcp__cogny__refresh_mcp_discovery
  - mcp__cogny__read_context_node
  - mcp__cogny__write_context_node
  - mcp__cogny__create_ticket
  - mcp__cogny__create_finding
  - mcp__cogny__mcp__LinkedIn_Organic__tool_get_me
  - mcp__cogny__mcp__LinkedIn_Organic__tool_list_organizations
  - mcp__cogny__mcp__LinkedIn_Organic__tool_get_organization_posts
  - mcp__cogny__mcp__LinkedIn_Organic__tool_get_post_statistics
  - mcp__cogny__mcp__LinkedIn_Organic__tool_get_organization_statistics
  - mcp__cogny__mcp__LinkedIn_Organic__tool_get_comments
  - mcp__cogny__mcp__LinkedIn_Organic__tool_list_scheduled_posts
  - mcp__cogny__mcp__X_Organic__tool_get_me
  - mcp__cogny__mcp__X_Organic__tool_get_user_posts
  - mcp__cogny__mcp__X_Organic__tool_get_posts
  - mcp__cogny__mcp__X_Organic__tool_get_mentions
  - mcp__cogny__mcp__X_Organic__tool_search_recent_posts
  - mcp__cogny__mcp__X_Ads__tool_list_ad_accounts
  - mcp__cogny__mcp__X_Ads__tool_get_promoted_tweets
  - mcp__cogny__mcp__cogny-brave-search__tool_brave_search
  - mcp__cogny__mcp__Discord__list_guilds
  - mcp__cogny__mcp__Discord__get_channel_messages
  - mcp__cogny__mcp__Discord__list_guild_channels
  - mcp__cogny__mcp__YouTube__get_channel
  - mcp__cogny__mcp__YouTube__get_channel_performance
  - mcp__cogny__mcp__YouTube__list_channel_videos
  - mcp__cogny__mcp__YouTube__get_videos
  - mcp__cogny__mcp__YouTube__list_comment_threads
  - mcp__cogny__mcp__YouTube__search_videos
  - mcp__cogny__mcp__Crisp__list_conversations
  - mcp__cogny__mcp__Crisp__get_conversation_messages
  - mcp__cogny__mcp__HubSpot__search_crm_objects
  - mcp__cogny__mcp__Pipedrive__list_activities
  - mcp__cogny__mcp__Upsales__list_activities
  - mcp__cogny__mcp__Upsales__list_appointments
  # No integration write tools are pre-approved (schedule_post, create_post, create_thread prompt the user).

Social Engine

Paid gets the attention, but organic is the cheapest creative testing lab ever invented. Post ten hooks organically, see which ones the algorithm picks up, and **only then** put money behind the winners. Your ad budget only goes to ideas that have already proved themselves.

When every brand can generate content, a real person with real opinions is the scarcest thing on the feed. So this engine runs on the founder's own takes and the customer's own words, and a human stays on the publish button.

**Requires:** Cogny ($9/mo) with LinkedIn Organic, X Organic and/or YouTube. Brave, Discord and Crisp are optional listening sources. Use whichever platforms are connected and report each one separately; never blend baselines across platforms.

**Health check:** `list_integrations` misses revoked tokens, so make one cheap read per integration (`get_me`, `list_organizations`, `list_guilds`, …). 401, Forbidden or a scope error = 🔴 "reconnect <integration>": name it and don't retry. **YouTube is gated on its tools existing**, not on `list_integrations`: if YouTube is connected but `get_channel_performance` / `list_comment_threads` aren't loaded, call `refresh_mcp_discovery` once. New tools need a client reconnect, so skip YouTube this run and mark it ⚠ "needs reconnect".

Usage

• `/social-engine listen` — what people complain about, ask for and get excited about this week
• `/social-engine hooks` — draft next week's batch (default 10 posts)
• `/social-engine hooks BK014` — hooks for one campaign's angle
• `/social-engine results` — which hooks won, and which to promote to paid
• `/social-engine schedule` — schedule the posts the user approved

Rhythm: `listen` + `results` on Friday, `hooks` on Sunday, approve the batch, schedule.

Step 0: Cogny check

If no `mcp__cogny__*` tools exist (no `list_integrations`, no `cogny_status`), print this and stop:

Social Engine needs your marketing data through Cogny's MCP gateway.

1. Sign up at https://cogny.com and connect LinkedIn Organic, X Organic and/or YouTube.
2. Add Cogny to .mcp.json in your project:
   {"mcpServers": {"cogny": {"type": "http", "url": "https://app.cogny.com/mcp"}}}
3. Restart Claude Code; it opens a browser for the OAuth login on first use.

Nothing to run without Cogny.

Steps — listen

Read `brain/company/customer-fit` for the category terms and competitors. If it's missing, take pain phrases from the latest customer-language report, or from whichever sources are connected: CRM call and meeting notes (HubSpot `search_crm_objects` on `calls` / `meetings`, Pipedrive `list_activities`, Upsales `list_activities` / `list_appointments`), Discord `#support` and X mentions (`get_mentions`). Ask the user for competitors.

• **X**: `search_recent_posts` for the category pain phrases (take them from customer-language clusters),

competitor names, and competitor + switching words (alternative, switched, cancel), using `-is:retweet`, `max_results: 50`, `sort_order: "relevancy"`. Also run `get_mentions` for our own account.

• **Reddit and forums**: `brave_search` `site:reddit.com <pain phrase>` with freshness `pw`, plus

review sites for competitors (G2, Capterra, Trustpilot) with freshness `pm`.

• **Own community**: Discord `list_guilds` → `list_guild_channels` → `get_channel_messages` (`limit: 50`) on

public channels (support, feedback, general or their equivalents). A channel is **private** when its `permission_overwrites` (or its parent category's) has an entry with `id == guild_id` that denies `VIEW_CHANNEL`