yt-transcript-strapi-plugin 0.0.18 → 0.0.19

package/dist/server/index.js

@@ -25,6 +25,7 @@ const FindTranscriptsSchema = zod.z.object({
   query: zod.z.string().optional(),
   videoId: zod.z.string().optional(),
   title: zod.z.string().optional(),
+  includeFullContent: zod.z.boolean().optional().default(false),
   page: zod.z.number().int().min(1).optional().default(1),
   pageSize: zod.z.number().int().min(1).max(100).optional().default(25),
   sort: zod.z.string().optional().default("createdAt:desc")
@@ -261,9 +262,10 @@ async function handleGetTranscript(strapi2, args) {
     ]
   };
 }
+const TRANSCRIPT_PREVIEW_LENGTH = 244;
 const findTranscriptsTool = {
   name: "find_transcripts",
-  description: "Search and filter transcripts based on query criteria. Returns multiple matching transcripts. Supports filtering by title, videoId, and full-text search in transcript content.",
+  description: "Search and filter transcripts based on query criteria. Returns multiple matching transcripts with truncated previews (244 chars). Use get_transcript for full content. Supports filtering by title, videoId, and full-text search.",
   inputSchema: {
     type: "object",
     properties: {
@@ -279,6 +281,10 @@ const findTranscriptsTool = {
         type: "string",
         description: "Filter by title (partial match, case-insensitive)"
       },
+      includeFullContent: {
+        type: "boolean",
+        description: "Set to true to include full transcript content. Default: false. Warning: may cause context overflow with multiple results."
+      },
       page: {
         type: "number",
         description: "Page number (starts at 1)",
@@ -298,9 +304,21 @@ const findTranscriptsTool = {
     required: []
   }
 };
+function truncateText(text, maxLength) {
+  if (!text) return null;
+  if (text.length <= maxLength) return text;
+  return text.substring(0, maxLength) + "...";
+}
+function truncateTranscripts(transcripts) {
+  return transcripts.map((transcript2) => ({
+    ...transcript2,
+    fullTranscript: truncateText(transcript2.fullTranscript, TRANSCRIPT_PREVIEW_LENGTH),
+    readableTranscript: truncateText(transcript2.readableTranscript, TRANSCRIPT_PREVIEW_LENGTH)
+  }));
+}
 async function handleFindTranscripts(strapi2, args) {
   const validatedArgs = validateToolInput("find_transcripts", args);
-  const { query, videoId, title, page, pageSize, sort } = validatedArgs;
+  const { query, videoId, title, includeFullContent, page, pageSize, sort } = validatedArgs;
   const start = (page - 1) * pageSize;
   const filters = {};
   if (videoId) {
@@ -327,13 +345,14 @@ async function handleFindTranscripts(strapi2, args) {
     filters
   });
   const total = allMatching.length;
+  const processedTranscripts = includeFullContent ? transcripts : truncateTranscripts(transcripts);
   return {
     content: [
       {
         type: "text",
         text: JSON.stringify(
           {
-            data: transcripts,
+            data: processedTranscripts,
             pagination: {
               page,
               pageSize,
@@ -344,7 +363,8 @@ async function handleFindTranscripts(strapi2, args) {
               query: query || null,
               videoId: videoId || null,
               title: title || null
-            }
+            },
+            ...!includeFullContent && { note: "Transcript content truncated to 244 chars. Use get_transcript for full content or set includeFullContent=true." }
           },
           null,
           2

package/dist/server/index.mjs

@@ -24,6 +24,7 @@ const FindTranscriptsSchema = z.object({
   query: z.string().optional(),
   videoId: z.string().optional(),
   title: z.string().optional(),
+  includeFullContent: z.boolean().optional().default(false),
   page: z.number().int().min(1).optional().default(1),
   pageSize: z.number().int().min(1).max(100).optional().default(25),
   sort: z.string().optional().default("createdAt:desc")
@@ -260,9 +261,10 @@ async function handleGetTranscript(strapi2, args) {
     ]
   };
 }
+const TRANSCRIPT_PREVIEW_LENGTH = 244;
 const findTranscriptsTool = {
   name: "find_transcripts",
-  description: "Search and filter transcripts based on query criteria. Returns multiple matching transcripts. Supports filtering by title, videoId, and full-text search in transcript content.",
+  description: "Search and filter transcripts based on query criteria. Returns multiple matching transcripts with truncated previews (244 chars). Use get_transcript for full content. Supports filtering by title, videoId, and full-text search.",
   inputSchema: {
     type: "object",
     properties: {
@@ -278,6 +280,10 @@ const findTranscriptsTool = {
         type: "string",
         description: "Filter by title (partial match, case-insensitive)"
       },
+      includeFullContent: {
+        type: "boolean",
+        description: "Set to true to include full transcript content. Default: false. Warning: may cause context overflow with multiple results."
+      },
       page: {
         type: "number",
         description: "Page number (starts at 1)",
@@ -297,9 +303,21 @@ const findTranscriptsTool = {
     required: []
   }
 };
+function truncateText(text, maxLength) {
+  if (!text) return null;
+  if (text.length <= maxLength) return text;
+  return text.substring(0, maxLength) + "...";
+}
+function truncateTranscripts(transcripts) {
+  return transcripts.map((transcript2) => ({
+    ...transcript2,
+    fullTranscript: truncateText(transcript2.fullTranscript, TRANSCRIPT_PREVIEW_LENGTH),
+    readableTranscript: truncateText(transcript2.readableTranscript, TRANSCRIPT_PREVIEW_LENGTH)
+  }));
+}
 async function handleFindTranscripts(strapi2, args) {
   const validatedArgs = validateToolInput("find_transcripts", args);
-  const { query, videoId, title, page, pageSize, sort } = validatedArgs;
+  const { query, videoId, title, includeFullContent, page, pageSize, sort } = validatedArgs;
   const start = (page - 1) * pageSize;
   const filters = {};
   if (videoId) {
@@ -326,13 +344,14 @@ async function handleFindTranscripts(strapi2, args) {
     filters
   });
   const total = allMatching.length;
+  const processedTranscripts = includeFullContent ? transcripts : truncateTranscripts(transcripts);
   return {
     content: [
       {
         type: "text",
         text: JSON.stringify(
           {
-            data: transcripts,
+            data: processedTranscripts,
             pagination: {
               page,
               pageSize,
@@ -343,7 +362,8 @@ async function handleFindTranscripts(strapi2, args) {
               query: query || null,
               videoId: videoId || null,
               title: title || null
-            }
+            },
+            ...!includeFullContent && { note: "Transcript content truncated to 244 chars. Use get_transcript for full content or set includeFullContent=true." }
           },
           null,
           2

package/dist/server/src/mcp/schemas/index.d.ts

@@ -33,6 +33,7 @@ export declare const FindTranscriptsSchema: z.ZodObject<{
     query: z.ZodOptional<z.ZodString>;
     videoId: z.ZodOptional<z.ZodString>;
     title: z.ZodOptional<z.ZodString>;
+    includeFullContent: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     pageSize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
     sort: z.ZodDefault<z.ZodOptional<z.ZodString>>;
@@ -43,6 +44,7 @@ export declare const FindTranscriptsSchema: z.ZodObject<{
     pageSize?: number;
     query?: string;
     title?: string;
+    includeFullContent?: boolean;
 }, {
     videoId?: string;
     sort?: string;
@@ -50,6 +52,7 @@ export declare const FindTranscriptsSchema: z.ZodObject<{
     pageSize?: number;
     query?: string;
     title?: string;
+    includeFullContent?: boolean;
 }>;
 export type FetchTranscriptInput = z.infer<typeof FetchTranscriptSchema>;
 export type ListTranscriptsInput = z.infer<typeof ListTranscriptsSchema>;
@@ -90,6 +93,7 @@ export declare const ToolSchemas: {
         query: z.ZodOptional<z.ZodString>;
         videoId: z.ZodOptional<z.ZodString>;
         title: z.ZodOptional<z.ZodString>;
+        includeFullContent: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
         page: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
         pageSize: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
         sort: z.ZodDefault<z.ZodOptional<z.ZodString>>;
@@ -100,6 +104,7 @@ export declare const ToolSchemas: {
         pageSize?: number;
         query?: string;
         title?: string;
+        includeFullContent?: boolean;
     }, {
         videoId?: string;
         sort?: string;
@@ -107,6 +112,7 @@ export declare const ToolSchemas: {
         pageSize?: number;
         query?: string;
         title?: string;
+        includeFullContent?: boolean;
     }>;
 };
 type ToolName = keyof typeof ToolSchemas;

package/dist/server/src/mcp/tools/find-transcripts.d.ts

@@ -17,6 +17,10 @@ export declare const findTranscriptsTool: {
                 type: string;
                 description: string;
             };
+            includeFullContent: {
+                type: string;
+                description: string;
+            };
             page: {
                 type: string;
                 description: string;

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.0.18",
+  "version": "0.0.19",
   "keywords": [
     "yt-transcript-strapi-plugin",
     "youtube",