@orchyn/mcp 1.1.2 → 1.2.0

package/dist/index.js

@@ -18,18 +18,7 @@ import { getBaseUrl, getPublicUrl, getPort, getCredentialsFile, getTransportMode
 import { AuthManager, OrchynAuthError, createHttpTokenProvider, createStdioTokenProvider } from "./auth.js";
 import { OrchynClient, OrchynError } from "./orchyn.js";
 import { OAuthManager } from "./oauth.js";
-import { formatPaywallError, runVideoAnalysis, validateVideoUrl } from "./video.js";
-const TOOL_NAME = "analyze_video";
-const TOOL_DESCRIPTION = "Start an AI analysis of a TikTok, Instagram, or YouTube video from its link. " +
-    "Requires a connected orchyn account; consumes orchyn credits (first analysis free). " +
-    "Returns the analysis result once finished.";
-const TOOL_INPUT_SCHEMA = z
-    .object({
-    url: z
-        .string()
-        .describe("Public video URL (tiktok.com, instagram.com, youtube.com, youtu.be, or common shortlinks)."),
-})
-    .strict();
+import { formatPaywallError, runVideoAnalysis, validatePostUrl } from "./video.js";
 function toToolResult(proxy) {
     const images = proxy.contentBlocks
         .filter((c) => c.type === "image")
@@ -48,19 +37,25 @@ function toolError(prefix, err) {
 export function createServer(opts) {
     const server = new McpServer({
         name: "orchyn-mcp",
-        version: "1.0.0",
+        version: "1.1.0",
     });
-    server.registerTool(TOOL_NAME, {
-        title: "Analyze Video",
-        description: TOOL_DESCRIPTION,
-        inputSchema: TOOL_INPUT_SCHEMA,
+    server.registerTool("analyze_post", {
+        title: "Analyze Post",
+        description: "Analyze a social post (video, image, carousel/slideshow) from its link — " +
+            "imports the media and runs AI analysis over the actual content (video frames, carousel images, caption). " +
+            "Supports TikTok, Instagram, YouTube and X/Twitter. Returns the full analysis once finished.",
+        inputSchema: z
+            .object({
+            url: z.string().describe("Public post URL (TikTok/Instagram/YouTube/X or shortlinks)."),
+        })
+            .strict(),
     }, async (args, extra) => {
         let session;
         if (extra.authInfo?.token && opts.resolveSession) {
             session = opts.resolveSession(extra.authInfo.token);
         }
         const client = opts.makeClient(session);
-        const validation = validateVideoUrl(args.url);
+        const validation = validatePostUrl(args.url);
         if (!validation.ok) {
             return {
                 content: [{ type: "text", text: `Invalid url: ${validation.error}` }],
@@ -69,33 +64,54 @@ export function createServer(opts) {
         }
         try {
             const result = await runVideoAnalysis(client, validation.url);
-            return {
-                content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
-            };
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
         }
         catch (err) {
             if (err instanceof OrchynError && err.paywall) {
                 return {
-                    content: [
-                        {
-                            type: "text",
-                            text: `Analysis blocked: ${formatPaywallError(err)}\n\nHTTP ${err.status}: ${err.message}`,
-                        },
-                    ],
+                    content: [{ type: "text", text: `Analysis blocked: ${formatPaywallError(err)}\n\nHTTP ${err.status}: ${err.message}` }],
                     isError: true,
                 };
             }
             const msg = err instanceof Error ? err.message : String(err);
+            return { content: [{ type: "text", text: `Analysis failed: ${msg}` }], isError: true };
+        }
+    });
+    server.registerTool("analyze_video", {
+        title: "Analyze Video",
+        description: "[Deprecated — use analyze_post] Alias of analyze_post — analyzes any post type.",
+        inputSchema: z
+            .object({
+            url: z.string().describe("Public post URL (TikTok/Instagram/YouTube/X or shortlinks)."),
+        })
+            .strict(),
+    }, async (args, extra) => {
+        let session;
+        if (extra.authInfo?.token && opts.resolveSession) {
+            session = opts.resolveSession(extra.authInfo.token);
+        }
+        const client = opts.makeClient(session);
+        const validation = validatePostUrl(args.url);
+        if (!validation.ok) {
             return {
-                content: [
-                    {
-                        type: "text",
-                        text: `Video analysis failed: ${msg}`,
-                    },
-                ],
+                content: [{ type: "text", text: `Invalid url: ${validation.error}` }],
                 isError: true,
             };
         }
+        try {
+            const result = await runVideoAnalysis(client, validation.url);
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (err) {
+            if (err instanceof OrchynError && err.paywall) {
+                return {
+                    content: [{ type: "text", text: `Analysis blocked: ${formatPaywallError(err)}\n\nHTTP ${err.status}: ${err.message}` }],
+                    isError: true,
+                };
+            }
+            const msg = err instanceof Error ? err.message : String(err);
+            return { content: [{ type: "text", text: `Analysis failed: ${msg}` }], isError: true };
+        }
     });
     server.registerTool("get_social_media", {
         title: "Get Social Media",

package/dist/video.js

@@ -4,7 +4,7 @@
  */
 export const POLL_INTERVAL_MS = 2000;
 export const POLL_TIMEOUT_MS = 300_000;
-const SUPPORTED_HOSTS = new Set([
+const SUPPORTED_HOSTS_VIDEO = new Set([
     "tiktok.com",
     "vm.tiktok.com",
     "instagram.com",
@@ -15,7 +15,13 @@ const SUPPORTED_HOSTS = new Set([
     "youtube-nocookie.com",
     "m.tiktok.com",
 ]);
-export function validateVideoUrl(rawUrl) {
+const SUPPORTED_HOSTS_POST = new Set([
+    ...SUPPORTED_HOSTS_VIDEO,
+    "x.com",
+    "twitter.com",
+    "mobile.twitter.com",
+]);
+function validateUrl(rawUrl, allowed) {
     if (typeof rawUrl !== "string" || rawUrl.trim() === "") {
         return { ok: false, error: "url must be a non-empty string." };
     }
@@ -36,7 +42,7 @@ export function validateVideoUrl(rawUrl) {
         // accept all youtube.com paths, incl. /shorts/<id>
         return { ok: true, url: parsed.toString() };
     }
-    if (SUPPORTED_HOSTS.has(host)) {
+    if (allowed.has(host)) {
         return { ok: true, url: parsed.toString() };
     }
     return {
@@ -44,6 +50,12 @@ export function validateVideoUrl(rawUrl) {
         error: "url host is not supported. Supported: tiktok.com, vm.tiktok.com, instagram.com, instagr.am, youtube.com, youtu.be, m.youtube.com (and /shorts).",
     };
 }
+export function validateVideoUrl(rawUrl) {
+    return validateUrl(rawUrl, SUPPORTED_HOSTS_VIDEO);
+}
+export function validatePostUrl(rawUrl) {
+    return validateUrl(rawUrl, SUPPORTED_HOSTS_POST);
+}
 export class JobTimeoutError extends Error {
     constructor(jobId, elapsedMs, lastStatus) {
         super(`Timed out after ${Math.round(elapsedMs / 1000)}s waiting for analysis job ${jobId} to finish.` +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orchyn/mcp",
-  "version": "1.1.2",
+  "version": "1.2.0",
   "description": "MCP server for orchyn - fetch, discover and understand TikTok/Instagram/YouTube/X posts with AI (media metadata, niche discovery, hook & viral analysis)",
   "type": "module",
   "main": "dist/index.js",