n8n-nodes-transcriptfetch 0.1.0

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 TranscriptFetch
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,44 @@
+# n8n-nodes-transcriptfetch
+
+This is an n8n community node for [TranscriptFetch](https://transcriptfetch.com) - the video & web data API for AI.
+
+Fetch transcripts from **YouTube, TikTok, Instagram, X (Twitter) & Facebook**, and convert **any web page to clean Markdown** - directly inside your n8n workflows. Structured JSON output with per-segment timestamps, built for RAG, agents, and LLM pipelines.
+
+[n8n](https://n8n.io/) is a [fair-code licensed](https://docs.n8n.io/reference/license/) workflow automation platform.
+
+## Installation
+
+Follow the [installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n community nodes documentation. Search for `n8n-nodes-transcriptfetch`.
+
+## Credentials
+
+Sign up at [transcriptfetch.com](https://transcriptfetch.com) and create an API key in the [dashboard](https://transcriptfetch.com/app). Add it as a **TranscriptFetch API** credential in n8n.
+
+Billing is usage-based: 1 credit per successful response. Failed, blocked, or no-transcript fetches are never charged.
+
+## Operations
+
+### Transcript
+
+- **Get Video Transcript** - transcript for a YouTube, TikTok, Instagram, X, or Facebook video (text + timestamped segments). When no captions exist, audio is transcribed automatically.
+- **Get Transcripts (Batch)** - up to 50 video transcripts in one call.
+- **List Channel Videos** - resolve a channel into a list of videos.
+- **List Playlist Videos** - resolve a playlist into a list of videos.
+- **Search Videos** - resolve a keyword search into a list of videos.
+
+### Web
+
+- **Scrape Page to Markdown** - any http(s) URL as clean Markdown (navigation, ads, and boilerplate removed).
+- **Map Site Links** - list the same-site links reachable from a URL.
+- **Crawl Site to Markdown** - breadth-first crawl returning Markdown for every readable page.
+
+The node is also marked **usable as a tool**, so n8n AI Agent nodes can call it directly.
+
+## Resources
+
+- [TranscriptFetch API documentation](https://transcriptfetch.com/docs)
+- [n8n community nodes documentation](https://docs.n8n.io/integrations/community-nodes/)
+
+## License
+
+[MIT](LICENSE.md)

package/dist/credentials/TranscriptFetchApi.credentials.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TranscriptFetchApi = void 0;
+class TranscriptFetchApi {
+    constructor() {
+        this.name = 'transcriptFetchApi';
+        this.displayName = 'TranscriptFetch API';
+        this.documentationUrl = 'https://transcriptfetch.com/docs';
+        this.properties = [
+            {
+                displayName: 'API Key',
+                name: 'apiKey',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                description: 'Your TranscriptFetch API key. Create one in the dashboard at https://transcriptfetch.com/app.',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    Authorization: '=Bearer {{$credentials.apiKey}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: 'https://transcriptfetch.com',
+                url: '/api/v1/health',
+            },
+        };
+    }
+}
+exports.TranscriptFetchApi = TranscriptFetchApi;

package/dist/nodes/TranscriptFetch/TranscriptFetch.node.js

@@ -0,0 +1,223 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TranscriptFetch = void 0;
+class TranscriptFetch {
+    constructor() {
+        this.description = {
+            displayName: 'TranscriptFetch',
+            name: 'transcriptFetch',
+            icon: 'file:transcriptfetch.svg',
+            group: ['transform'],
+            version: 1,
+            subtitle: '={{ $parameter["operation"] + ": " + $parameter["resource"] }}',
+            description: 'Video transcripts from YouTube, TikTok, Instagram, X & Facebook, plus any web page as clean Markdown',
+            defaults: {
+                name: 'TranscriptFetch',
+            },
+            usableAsTool: true,
+            inputs: ['main'],
+            outputs: ['main'],
+            credentials: [
+                {
+                    name: 'transcriptFetchApi',
+                    required: true,
+                },
+            ],
+            requestDefaults: {
+                baseURL: 'https://transcriptfetch.com',
+                headers: {
+                    Accept: 'application/json',
+                    'Content-Type': 'application/json',
+                },
+            },
+            properties: [
+                {
+                    displayName: 'Resource',
+                    name: 'resource',
+                    type: 'options',
+                    noDataExpression: true,
+                    options: [
+                        { name: 'Transcript', value: 'transcript' },
+                        { name: 'Web', value: 'web' },
+                    ],
+                    default: 'transcript',
+                },
+                // ── Transcript operations ─────────────────────────────────────────
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    displayOptions: { show: { resource: ['transcript'] } },
+                    options: [
+                        {
+                            name: 'Get Video Transcript',
+                            value: 'getVideo',
+                            action: 'Get a video transcript',
+                            description: 'Fetch the transcript for a YouTube, TikTok, Instagram, X (Twitter), or Facebook video (text + timestamped segments)',
+                            routing: { request: { method: 'POST', url: '/api/v1/transcripts/video' } },
+                        },
+                        {
+                            name: 'Get Transcripts (Batch)',
+                            value: 'batch',
+                            action: 'Get up to 50 transcripts in one call',
+                            description: 'Fetch transcripts for up to 50 YouTube video IDs or URLs concurrently',
+                            routing: { request: { method: 'POST', url: '/api/v1/transcripts/batch' } },
+                        },
+                        {
+                            name: 'List Channel Videos',
+                            value: 'channel',
+                            action: 'List a channel s videos',
+                            description: 'Resolve a YouTube channel into a list of videos (metadata only)',
+                            routing: { request: { method: 'POST', url: '/api/v1/transcripts/channel' } },
+                        },
+                        {
+                            name: 'List Playlist Videos',
+                            value: 'playlist',
+                            action: 'List a playlist s videos',
+                            description: 'Resolve a YouTube playlist into a list of videos (metadata only)',
+                            routing: { request: { method: 'POST', url: '/api/v1/transcripts/playlist' } },
+                        },
+                        {
+                            name: 'Search Videos',
+                            value: 'search',
+                            action: 'Search you tube for videos',
+                            description: 'Resolve a keyword search into a list of videos (metadata only)',
+                            routing: { request: { method: 'POST', url: '/api/v1/transcripts/search' } },
+                        },
+                    ],
+                    default: 'getVideo',
+                },
+                // ── Web operations ────────────────────────────────────────────────
+                {
+                    displayName: 'Operation',
+                    name: 'operation',
+                    type: 'options',
+                    noDataExpression: true,
+                    displayOptions: { show: { resource: ['web'] } },
+                    options: [
+                        {
+                            name: 'Scrape Page to Markdown',
+                            value: 'scrape',
+                            action: 'Scrape a web page to markdown',
+                            description: 'Fetch any http(s) URL and return the main readable content as clean Markdown',
+                            routing: { request: { method: 'POST', url: '/api/v1/web' } },
+                        },
+                        {
+                            name: 'Map Site Links',
+                            value: 'map',
+                            action: 'Map a site s links',
+                            description: 'List the same-site links reachable from a URL',
+                            routing: { request: { method: 'POST', url: '/api/v1/web/map' } },
+                        },
+                        {
+                            name: 'Crawl Site to Markdown',
+                            value: 'crawl',
+                            action: 'Crawl a site to markdown',
+                            description: 'Breadth-first crawl from a start URL, returning clean Markdown for every readable page (up to 25 per call)',
+                            routing: { request: { method: 'POST', url: '/api/v1/web/crawl' } },
+                        },
+                    ],
+                    default: 'scrape',
+                },
+                // ── Transcript fields ─────────────────────────────────────────────
+                {
+                    displayName: 'Video URL or ID',
+                    name: 'video',
+                    type: 'string',
+                    required: true,
+                    default: '',
+                    placeholder: 'https://www.youtube.com/watch?v=dQw4w9WgXcQ',
+                    description: 'YouTube, TikTok, Instagram, X (Twitter), or Facebook video URL - or a bare YouTube video ID',
+                    displayOptions: { show: { resource: ['transcript'], operation: ['getVideo'] } },
+                    routing: { send: { type: 'body', property: 'video' } },
+                },
+                {
+                    displayName: 'Video IDs or URLs',
+                    name: 'videoIds',
+                    type: 'string',
+                    required: true,
+                    default: '',
+                    placeholder: 'dQw4w9WgXcQ, 9bZkp7q19f0',
+                    description: 'Comma-separated list of up to 50 YouTube video IDs or URLs',
+                    displayOptions: { show: { resource: ['transcript'], operation: ['batch'] } },
+                    routing: {
+                        send: {
+                            type: 'body',
+                            property: 'videoIds',
+                            value: '={{ $parameter["videoIds"].split(",").map(v => v.trim()).filter(v => v.length > 0) }}',
+                        },
+                    },
+                },
+                {
+                    displayName: 'Channel',
+                    name: 'channel',
+                    type: 'string',
+                    required: true,
+                    default: '',
+                    placeholder: '@lexfridman',
+                    description: 'Channel @handle, /channel/UC… URL, or UC… ID',
+                    displayOptions: { show: { resource: ['transcript'], operation: ['channel'] } },
+                    routing: { send: { type: 'body', property: 'channel' } },
+                },
+                {
+                    displayName: 'Playlist',
+                    name: 'playlist',
+                    type: 'string',
+                    required: true,
+                    default: '',
+                    placeholder: 'PLrAXtmRdnEQy6nuLMt9H1aZIuhcGOcZQ4',
+                    description: 'Playlist URL or playlist ID',
+                    displayOptions: { show: { resource: ['transcript'], operation: ['playlist'] } },
+                    routing: { send: { type: 'body', property: 'playlist' } },
+                },
+                {
+                    displayName: 'Query',
+                    name: 'query',
+                    type: 'string',
+                    required: true,
+                    default: '',
+                    placeholder: 'how transformers work',
+                    description: 'Keyword search query',
+                    displayOptions: { show: { resource: ['transcript'], operation: ['search'] } },
+                    routing: { send: { type: 'body', property: 'query' } },
+                },
+                {
+                    displayName: 'Limit',
+                    name: 'limit',
+                    type: 'number',
+                    typeOptions: { minValue: 1 },
+                    default: 10,
+                    description: 'Max number of results to return',
+                    displayOptions: {
+                        show: { resource: ['transcript'], operation: ['channel', 'playlist', 'search'] },
+                    },
+                    routing: { send: { type: 'body', property: 'limit' } },
+                },
+                // ── Web fields ────────────────────────────────────────────────────
+                {
+                    displayName: 'URL',
+                    name: 'url',
+                    type: 'string',
+                    required: true,
+                    default: '',
+                    placeholder: 'https://example.com/article',
+                    description: 'The http(s) URL to fetch',
+                    displayOptions: { show: { resource: ['web'] } },
+                    routing: { send: { type: 'body', property: 'url' } },
+                },
+                {
+                    displayName: 'Limit',
+                    name: 'limit',
+                    type: 'number',
+                    typeOptions: { minValue: 1 },
+                    default: 10,
+                    description: 'Max number of links (map) or pages (crawl) to return',
+                    displayOptions: { show: { resource: ['web'], operation: ['map', 'crawl'] } },
+                    routing: { send: { type: 'body', property: 'limit' } },
+                },
+            ],
+        };
+    }
+}
+exports.TranscriptFetch = TranscriptFetch;

package/dist/nodes/TranscriptFetch/transcriptfetch.svg

@@ -0,0 +1,9 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 80 80">
+  <rect width="80" height="80" rx="18" fill="#0f172a" />
+  <g fill="#f5f5f4">
+    <rect x="30" y="16" width="20" height="7" rx="3.5" />
+    <rect x="23" y="30" width="34" height="7" rx="3.5" />
+    <rect x="16" y="44" width="48" height="7" rx="3.5" />
+    <rect x="24" y="58" width="32" height="7" rx="3.5" />
+  </g>
+</svg>

package/index.js

@@ -0,0 +1,3 @@
+// Entry point is unused by n8n (nodes/credentials are loaded from the paths in
+// package.json's "n8n" block) but npm requires main to resolve.
+module.exports = {};

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "n8n-nodes-transcriptfetch",
+  "version": "0.1.0",
+  "description": "n8n community node for TranscriptFetch - video transcripts from YouTube, TikTok, Instagram, X & Facebook, plus any web page as clean Markdown.",
+  "keywords": [
+    "n8n-community-node-package",
+    "transcript",
+    "youtube",
+    "tiktok",
+    "instagram",
+    "captions",
+    "markdown",
+    "scraping",
+    "transcriptfetch"
+  ],
+  "license": "MIT",
+  "homepage": "https://transcriptfetch.com",
+  "author": {
+    "name": "TranscriptFetch",
+    "email": "support@transcriptfetch.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/TranscriptFetch/n8n-nodes-transcriptfetch.git"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "main": "index.js",
+  "scripts": {
+    "build": "tsc && node -e \"require('fs').cpSync('nodes/TranscriptFetch/transcriptfetch.svg','dist/nodes/TranscriptFetch/transcriptfetch.svg')\"",
+    "dev": "tsc --watch",
+    "lint": "npx @n8n/scan-community-package ."
+  },
+  "files": [
+    "dist"
+  ],
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "credentials": [
+      "dist/credentials/TranscriptFetchApi.credentials.js"
+    ],
+    "nodes": [
+      "dist/nodes/TranscriptFetch/TranscriptFetch.node.js"
+    ]
+  },
+  "devDependencies": {
+    "n8n-workflow": "*",
+    "typescript": "^5.5.0"
+  },
+  "peerDependencies": {
+    "n8n-workflow": "*"
+  }
+}