clipbait 1.8.0 → 1.9.1

package/README.md

@@ -56,6 +56,9 @@ Seven tools are available to any agent:
 | `start_live_autoclip` | Auto-clip a **live** Twitch stream continuously (`channelUrl`, optional `cadenceMin`). Pro plan. |
 | `probe_video` | Get a video's duration before clipping (`url`). |
 | `download_clip` | Save a finished clip to your `~/Downloads/` folder and return the path (`jobId`, `clipIndex` 1-based). Max 500 MB. |
+| `list_social_accounts` | Show connected accounts. Posting is X/Twitter only today (TikTok, Facebook, Instagram coming soon). |
+| `schedule_post` | Schedule a clip to post on X at a future time (`clipUrl`, `platforms: ["x"]`, `scheduledTime`, `caption`). |
+| `list_scheduled_posts` / `cancel_scheduled_post` | Review or cancel scheduled posts. |
 
 ## Terminal usage
 

package/index.js

@@ -107,14 +107,18 @@ argument-hint: <video-url> [what you want]
 ---
 You have the \`clipbait\` MCP tools connected. The user's request: $ARGUMENTS
 
-Do this, conversationally and fast:
-1. If there is no video URL in the request, ask for one (YouTube, Twitch VOD, Rumble, or Ganjing World). Otherwise don't ask for confirmation, just go.
-2. Read the intent and set params for \`generate_clips\`:
-   - vertical / shorts / tiktok / reels, or nothing specified => aspectRatio "9:16". landscape / widescreen / youtube => "16:9".
-   - if they mention a number of clips, use it as maxClips (1 to 20), otherwise 9.
-3. Call \`generate_clips\`, then poll \`get_job\` with the returned jobId every 30 seconds until status is "complete". Report progress between polls.
-4. When complete, list each finished clip as a numbered list: its hook and its URL.
-5. Then offer follow-ups and act on them by calling the tools again: regenerate at a different aspect ratio, pull more clips, or probe another video with \`probe_video\`.
+Guide them like a friendly assistant, conversationally and fast:
+1. Need a video URL — if none was given, ask for one (YouTube, Twitch VOD, Rumble, or Ganjing World).
+2. Set params for \`generate_clips\` from their intent (offer the choice if unclear, don't over-ask):
+   - aspect ratio: 9:16 (vertical / TikTok / Reels) is the default; 16:9 for YouTube / landscape.
+   - number of clips: use a number if they mention one (1–20), otherwise 9.
+3. Call \`generate_clips\`, then poll \`get_job\` with the returned jobId every ~30 seconds until status is "complete". Report progress between polls.
+4. When complete, list each finished clip as a numbered list: hook and URL.
+5. Then offer next steps and act on them by calling the tools:
+   - \`download_clip\` — save a clip to ~/Downloads.
+   - Post to X (Twitter) — currently the only supported platform (TikTok, Facebook, Instagram coming soon). Call \`list_social_accounts\` to confirm X is connected, then ask when to post (offer Today / Tomorrow / This weekend / a specific time) and the caption (offer to draft one). Show the plan (clip · time · caption) and CONFIRM before calling \`schedule_post\` for each clip. Use \`list_scheduled_posts\` / \`cancel_scheduled_post\` to review or undo.
+   - Regenerate at a different aspect ratio, pull more clips, or \`probe_video\` another URL.
+Keep it snappy. Don't ask for confirmation to start clipping unless the URL is missing — but always confirm before posting to social.
 `;
 
 // Claude Desktop config path per-OS.
@@ -275,6 +279,19 @@ async function runMcpServer() {
       } catch (e) { return fail(e); }
     });
 
+  server.tool("list_social_accounts", "List connected social accounts. Posting is currently supported on X (Twitter) only — TikTok, Facebook, Instagram coming soon.", {},
+    async () => { try { const d = await api("GET", "/auth/social/status"); const x = d?.twitter?.connected; return ok(`X (Twitter): ${x ? `connected${d.twitter.username ? ` as @${d.twitter.username}` : ""}` : "not connected — connect at https://app.clipbait.ai/me"}.\nTikTok, Facebook, Instagram: coming soon.`); } catch (e) { return fail(e); } });
+
+  server.tool("schedule_post", "Schedule a finished clip to post on X (Twitter) at a future time. Get clip URLs from get_job first; confirm X is connected via list_social_accounts. NOTE: only X posting is live today — TikTok, Facebook, Instagram coming soon.",
+    { clipUrl: z.string(), platforms: z.array(z.enum(["x"])).min(1).describe("only \"x\" supported today"), scheduledTime: z.string().describe("Future ISO 8601 time"), caption: z.string().optional(), clipTitle: z.string().optional(), clipJobId: z.string().optional(), clipIndex: z.number().int().optional() },
+    async (a) => { try { const d = await api("POST", "/scheduled-posts", { clipUrl: a.clipUrl, platforms: a.platforms, scheduledTime: a.scheduledTime, caption: a.caption || "", clipTitle: a.clipTitle, clipJobId: a.clipJobId, clipIndex: a.clipIndex }); return ok(`Scheduled to ${a.platforms.join(", ")} for ${a.scheduledTime} (post ${d.scheduledPost?._id || "?"}).`); } catch (e) { return fail(e); } });
+
+  server.tool("list_scheduled_posts", "List the user's scheduled/posted social posts.", { status: z.enum(["pending", "posted", "failed", "cancelled"]).optional() },
+    async (a) => { try { const d = await api("GET", "/scheduled-posts" + (a.status ? `?status=${a.status}` : "")); const posts = (d.posts || []).slice(0, 20).map((p) => `${p._id} · ${p.status} · ${(p.platforms || []).map((x) => x.name).join(",")} · ${new Date(p.scheduledTime).toISOString()} · ${p.clipTitle || ""}`).join("\n"); return ok(posts || "No scheduled posts."); } catch (e) { return fail(e); } });
+
+  server.tool("cancel_scheduled_post", "Cancel a scheduled post before it goes live.", { postId: z.string() },
+    async (a) => { try { await api("DELETE", "/scheduled-posts/" + a.postId); return ok(`Cancelled scheduled post ${a.postId}.`); } catch (e) { return fail(e); } });
+
   await server.connect(new StdioServerTransport());
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clipbait",
-  "version": "1.8.0",
+  "version": "1.9.1",
   "description": "Clipbait CLI + MCP server — turn any video into viral clips, and auto-clip live streams, from your terminal or any AI agent.",
   "bin": { "clipbait": "index.js" },
   "type": "commonjs",