n8n-nodes-captapi 0.1.0

package/README.md

@@ -0,0 +1,57 @@
+# n8n-nodes-captapi
+
+This is an [n8n](https://n8n.io) community node. It lets you use **[Captapi](https://captapi.com)** in your n8n workflows.
+
+Captapi turns YouTube, TikTok, Instagram and Facebook URLs into clean, structured JSON — transcripts, AI summaries, comments, video/post details, profile & channel stats, search, hashtag/music lookups and downloads. One API key, **62 operations**.
+
+[Installation](#installation) · [Credentials](#credentials) · [Operations](#operations) · [Usage](#usage) · [Resources](#resources)
+
+## Installation
+
+Follow the [community nodes installation guide](https://docs.n8n.io/integrations/community-nodes/installation/) in the n8n docs.
+
+In your n8n instance:
+
+1. Go to **Settings → Community Nodes**.
+2. Select **Install**.
+3. Enter `n8n-nodes-captapi` as the npm package name.
+4. Agree to the risks and select **Install**.
+
+The **Captapi** node and **Captapi API** credential will then be available.
+
+## Credentials
+
+You need a Captapi API key:
+
+1. Create a free account at [captapi.com](https://captapi.com).
+2. Open **Dashboard → API Keys** and copy a key.
+3. In n8n, create a new **Captapi API** credential and paste the key.
+
+The credential test calls `/v1/account/limits` to confirm the key works. `Base URL` defaults to `https://api.captapi.com` and rarely needs changing.
+
+## Operations
+
+Pick a **Platform** (YouTube, TikTok, Instagram, Facebook), then an **Operation**. Highlights per platform:
+
+- **YouTube** — Transcript, Summarizer, Video/Channel Details, Comments, Search, Channel Videos/Shorts/Streams/Playlists, Community Posts, Comment Replies, Downloads.
+- **TikTok** — Transcript, Summarizer, Video/Channel Details, Comments, Search, Channel Posts, Followers/Followings, Music Posts, Song Details, Trending Feed, Popular Hashtags, Downloads.
+- **Instagram** — Transcript, Summarizer, Post/Reel Details, Comments, Channel Posts/Reels, Reels/Hashtag/Profile Search, Story Highlights, Tagged & Music Posts, Embed, Downloads.
+- **Facebook** — Details, Transcript, Summarizer, Comments, Page Details, Profile Posts/Reels, Group Posts, Comment Replies.
+
+Each operation maps 1:1 to a Captapi REST endpoint and exposes exactly the inputs that endpoint accepts (e.g. `URL`, `Query`, `Limit`, `Language`, `Comment ID`).
+
+## Usage
+
+A minimal flow: **Manual Trigger → Captapi**.
+
+1. Add the **Captapi** node.
+2. Platform: `YouTube`, Operation: `YouTube Transcript`.
+3. URL: `https://youtube.com/watch?v=dQw4w9WgXcQ`.
+4. Execute — the node returns the transcript JSON.
+
+Pricing is credit-based and per result; cached responses are free and failed requests are never charged. See [captapi.com/pricing](https://captapi.com/pricing).
+
+## Resources
+
+- [Captapi documentation](https://captapi.com/docs)
+- [n8n community nodes docs](https://docs.n8n.io/integrations/community-nodes/)

package/dist/catalog.js

@@ -0,0 +1,131 @@
+"use strict";
+// Auto-maintained catalog of every Captapi endpoint exposed as an MCP tool.
+// Each endpoint declares its EXACT input parameters (matching the REST API),
+// so agents know precisely what to pass. Mirrors the backend routers.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ENDPOINTS = void 0;
+exports.describe = describe;
+// --- Param builders (keep declarations terse + consistent) -----------------
+const url = (description) => ({
+    name: "url",
+    type: "string",
+    required: true,
+    description,
+});
+const q = (description = "Search query or keywords (min 2 chars).") => ({
+    name: "q",
+    type: "string",
+    required: true,
+    description,
+});
+const limit = (def, max) => ({
+    name: "limit",
+    type: "number",
+    required: false,
+    description: `Max items to return. Default ${def}, max ${max}. Billed per result.`,
+});
+const language = () => ({
+    name: "language",
+    type: "string",
+    required: false,
+    description: 'Preferred caption language as an ISO code, e.g. "en". Defaults to auto-detect.',
+});
+const commentId = () => ({
+    name: "comment_id",
+    type: "string",
+    required: true,
+    description: "ID of the parent comment to fetch replies for (from the comments endpoint).",
+});
+const YT_VIDEO = "Public YouTube video URL, e.g. https://youtube.com/watch?v=ID.";
+const YT_SHORTS = "Public YouTube Shorts URL, e.g. https://youtube.com/shorts/ID.";
+const YT_CHANNEL = "YouTube channel URL, e.g. https://youtube.com/@handle or /channel/UC...";
+const TT_VIDEO = "Public TikTok video URL, e.g. https://tiktok.com/@user/video/ID.";
+const TT_PROFILE = "TikTok profile URL, e.g. https://tiktok.com/@username.";
+const TT_MUSIC = "TikTok music/sound URL, e.g. https://tiktok.com/music/name-ID.";
+const IG_POST = "Instagram post or reel URL, e.g. https://instagram.com/reel/ID/.";
+const IG_REEL = "Instagram Reel URL, e.g. https://instagram.com/reel/ID/.";
+const IG_PROFILE = "Instagram profile URL, e.g. https://instagram.com/username/.";
+const FB_VIDEO = "Public Facebook video or post URL.";
+const YOUTUBE = [
+    { tool: "youtube_transcript", name: "YouTube Transcript", path: "/v1/youtube/transcript", credits: 2, summary: "Extract the full timestamped transcript of a YouTube video.", params: [url(YT_VIDEO), language()] },
+    { tool: "youtube_summarize", name: "YouTube Summarizer", path: "/v1/youtube/summarize", credits: 4, summary: "AI summary (key points, topics, sentiment) of a YouTube video.", params: [url(YT_VIDEO), language()] },
+    { tool: "youtube_video_details", name: "YouTube Video Details", path: "/v1/youtube/video-details", credits: 1, summary: "Metadata + engagement stats for a YouTube video.", params: [url(YT_VIDEO)] },
+    { tool: "youtube_comments", name: "YouTube Comments", path: "/v1/youtube/comments", credits: 20, summary: "Comments on a YouTube video.", params: [url(YT_VIDEO), limit(50, 500)] },
+    { tool: "youtube_channel_details", name: "YouTube Channel Details", path: "/v1/youtube/channel-details", credits: 1, summary: "Channel info & subscriber/stats for a YouTube channel.", params: [url(YT_CHANNEL)] },
+    { tool: "youtube_search", name: "YouTube Search", path: "/v1/youtube/search", credits: 20, summary: "Search YouTube videos by keyword.", params: [q(), limit(20, 200)] },
+    { tool: "youtube_channel_videos", name: "YouTube Channel Videos", path: "/v1/youtube/channel-videos", credits: 20, summary: "List a channel's uploaded videos.", params: [url(YT_CHANNEL), limit(20, 200)] },
+    { tool: "youtube_playlist_videos", name: "YouTube Playlist Videos", path: "/v1/youtube/playlist-videos", credits: 50, summary: "List videos in a YouTube playlist.", params: [url("YouTube playlist URL, e.g. https://youtube.com/playlist?list=ID."), limit(50, 500)] },
+    { tool: "youtube_video_download", name: "YouTube Video Download", path: "/v1/youtube/video-download", credits: 3, summary: "Direct download URLs for a YouTube video.", params: [url(YT_VIDEO)] },
+    { tool: "youtube_shorts_transcript", name: "YouTube Shorts Transcript", path: "/v1/youtube/shorts/transcript", credits: 2, summary: "Transcript of a YouTube Short.", params: [url(YT_SHORTS), language()] },
+    { tool: "youtube_shorts_summarize", name: "YouTube Shorts Summarizer", path: "/v1/youtube/shorts/summarize", credits: 4, summary: "AI summary of a YouTube Short.", params: [url(YT_SHORTS), language()] },
+    { tool: "youtube_shorts_details", name: "YouTube Shorts Stats", path: "/v1/youtube/shorts/video-details", credits: 1, summary: "Metadata + stats for a YouTube Short.", params: [url(YT_SHORTS)] },
+    { tool: "youtube_shorts_comments", name: "YouTube Shorts Comments", path: "/v1/youtube/shorts/comments", credits: 20, summary: "Comments on a YouTube Short.", params: [url(YT_SHORTS), limit(50, 500)] },
+    { tool: "youtube_channel_shorts", name: "YouTube Channel Shorts", path: "/v1/youtube/channel-shorts", credits: 20, summary: "List a channel's Shorts.", params: [url(YT_CHANNEL), limit(20, 200)] },
+    { tool: "youtube_channel_streams", name: "YouTube Channel Streams", path: "/v1/youtube/channel-streams", credits: 20, summary: "List a channel's live/past streams.", params: [url(YT_CHANNEL), limit(20, 200)] },
+    { tool: "youtube_hashtag_search", name: "YouTube Hashtag Search", path: "/v1/youtube/hashtag-search", credits: 20, summary: "Search YouTube videos by hashtag.", params: [q("Hashtag with or without the # (min 2 chars)."), limit(20, 200)] },
+    { tool: "youtube_comment_replies", name: "YouTube Comment Replies", path: "/v1/youtube/comment-replies", credits: 20, summary: "Replies to a specific YouTube comment.", params: [url(YT_VIDEO), commentId(), limit(50, 500)] },
+    { tool: "youtube_channel_playlists", name: "YouTube Channel Playlists", path: "/v1/youtube/channel-playlists", credits: 20, summary: "List a channel's playlists.", params: [url(YT_CHANNEL), limit(20, 200)] },
+    { tool: "youtube_community_posts", name: "YouTube Community Posts", path: "/v1/youtube/community-posts", credits: 10, summary: "List a channel's community (posts) tab.", params: [url(YT_CHANNEL), limit(20, 200)] },
+];
+const TIKTOK = [
+    { tool: "tiktok_transcript", name: "TikTok Transcript", path: "/v1/tiktok/transcript", credits: 2, summary: "Transcript of a TikTok video (via captions).", params: [url(TT_VIDEO)] },
+    { tool: "tiktok_summarize", name: "TikTok Summarizer", path: "/v1/tiktok/summarize", credits: 4, summary: "AI summary of a TikTok video.", params: [url(TT_VIDEO)] },
+    { tool: "tiktok_video_details", name: "TikTok Video Details", path: "/v1/tiktok/video-details", credits: 1, summary: "Metadata + stats for a TikTok video.", params: [url(TT_VIDEO)] },
+    { tool: "tiktok_comments", name: "TikTok Comments", path: "/v1/tiktok/comments", credits: 10, summary: "Comments on a TikTok video.", params: [url(TT_VIDEO), limit(50, 500)] },
+    { tool: "tiktok_channel_details", name: "TikTok Channel Details", path: "/v1/tiktok/channel-details", credits: 1, summary: "Profile info & stats for a TikTok user.", params: [url(TT_PROFILE)] },
+    { tool: "tiktok_search", name: "TikTok Search", path: "/v1/tiktok/search", credits: 14, summary: "Search TikTok videos by keyword/hashtag.", params: [q(), limit(20, 200)] },
+    { tool: "tiktok_video_download", name: "TikTok Video Download", path: "/v1/tiktok/video-download", credits: 3, summary: "No-watermark download URL for a TikTok video.", params: [url(TT_VIDEO)] },
+    { tool: "tiktok_channel_posts", name: "TikTok Channel Posts", path: "/v1/tiktok/channel-posts", credits: 14, summary: "Latest posts from a TikTok profile.", params: [url(TT_PROFILE), limit(20, 200)] },
+    { tool: "tiktok_comment_replies", name: "TikTok Comment Replies", path: "/v1/tiktok/comment-replies", credits: 50, summary: "Replies to a specific TikTok comment.", params: [url(TT_VIDEO), commentId(), limit(50, 500)] },
+    { tool: "tiktok_user_followers", name: "TikTok User Followers", path: "/v1/tiktok/user-followers", credits: 20, summary: "List a TikTok user's followers.", params: [url(TT_PROFILE), limit(50, 500)] },
+    { tool: "tiktok_user_followings", name: "TikTok User Followings", path: "/v1/tiktok/user-followings", credits: 20, summary: "List who a TikTok user follows.", params: [url(TT_PROFILE), limit(50, 500)] },
+    { tool: "tiktok_music_posts", name: "TikTok Music Posts", path: "/v1/tiktok/music-posts", credits: 32, summary: "Posts using a specific TikTok sound/music.", params: [url(TT_MUSIC), limit(20, 200)] },
+    { tool: "tiktok_hashtag_search", name: "TikTok Hashtag Search", path: "/v1/tiktok/hashtag-search", credits: 14, summary: "Search TikTok videos by hashtag.", params: [q("Hashtag with or without the # (min 2 chars)."), limit(20, 200)] },
+    { tool: "tiktok_top_search", name: "TikTok Top Search", path: "/v1/tiktok/top-search", credits: 14, summary: "Top mixed TikTok results for a keyword.", params: [q(), limit(20, 200)] },
+    { tool: "tiktok_user_search", name: "TikTok User Search", path: "/v1/tiktok/user-search", credits: 8, summary: "Search TikTok users/creators by keyword.", params: [q(), limit(20, 100)] },
+    { tool: "tiktok_song_details", name: "TikTok Song Details", path: "/v1/tiktok/song-details", credits: 2, summary: "Details of a TikTok sound/song.", params: [url(TT_MUSIC)] },
+    { tool: "tiktok_trending_feed", name: "TikTok Trending Feed", path: "/v1/tiktok/trending-feed", credits: 14, summary: "TikTok trending (For You) videos by region.", params: [{ name: "country", type: "string", required: false, description: "Two-letter ISO country code, e.g. US, GB, TR. Default US." }, limit(20, 200)] },
+    { tool: "tiktok_popular_hashtags", name: "TikTok Popular Hashtags", path: "/v1/tiktok/popular-hashtags", credits: 14, summary: "Trending TikTok hashtags for a topic/keyword.", params: [{ name: "query", type: "string", required: false, description: 'Topic or keyword to discover trending hashtags for. Default "trending".' }, limit(20, 100)] },
+];
+const INSTAGRAM = [
+    { tool: "instagram_transcript", name: "Instagram Transcript", path: "/v1/instagram/transcript", credits: 2, summary: "Transcript of an Instagram Reel.", params: [url(IG_REEL)] },
+    { tool: "instagram_summarize", name: "Instagram Summarizer", path: "/v1/instagram/summarize", credits: 4, summary: "AI summary of an Instagram Reel.", params: [url(IG_REEL)] },
+    { tool: "instagram_details", name: "Instagram Details", path: "/v1/instagram/details", credits: 1, summary: "Details for an Instagram post or reel.", params: [url(IG_POST)] },
+    { tool: "instagram_comments", name: "Instagram Comments", path: "/v1/instagram/comments", credits: 45, summary: "Comments on an Instagram post or reel.", params: [url(IG_POST), limit(50, 500)] },
+    { tool: "instagram_channel_details", name: "Instagram Channel Details", path: "/v1/instagram/channel-details", credits: 1, summary: "Profile info & stats for an Instagram account.", params: [url(IG_PROFILE)] },
+    { tool: "instagram_channel_posts", name: "Instagram Channel Posts", path: "/v1/instagram/channel-posts", credits: 12, summary: "Latest posts from an Instagram profile.", params: [url(IG_PROFILE), limit(20, 200)] },
+    { tool: "instagram_channel_reels", name: "Instagram Channel Reels", path: "/v1/instagram/channel-reels", credits: 12, summary: "Latest Reels from an Instagram profile.", params: [url(IG_PROFILE), limit(20, 200)] },
+    { tool: "instagram_reels_search", name: "Instagram Reels Search", path: "/v1/instagram/reels-search", credits: 12, summary: "Search Instagram Reels by hashtag/keyword.", params: [q("Hashtag (without #) or keyword (min 2 chars)."), limit(20, 200)] },
+    { tool: "instagram_video_download", name: "Instagram Video Download", path: "/v1/instagram/video-download", credits: 3, summary: "Direct video URL for an Instagram Reel.", params: [url(IG_REEL)] },
+    { tool: "instagram_tagged_posts", name: "Instagram Tagged Posts", path: "/v1/instagram/tagged-posts", credits: 18, summary: "Posts an Instagram user is tagged in.", params: [url(IG_PROFILE), limit(20, 200)] },
+    { tool: "instagram_music_posts", name: "Instagram Music Posts", path: "/v1/instagram/music-posts", credits: 18, summary: "Posts/Reels using an Instagram audio.", params: [url("Instagram audio/music page URL."), limit(20, 200)] },
+    { tool: "instagram_hashtag_search", name: "Instagram Hashtag Search", path: "/v1/instagram/hashtag-search", credits: 12, summary: "Search Instagram posts by hashtag.", params: [q("Hashtag without the # (min 2 chars)."), limit(20, 200)] },
+    { tool: "instagram_profile_search", name: "Instagram Profile Search", path: "/v1/instagram/profile-search", credits: 12, summary: "Search Instagram profiles by keyword.", params: [q(), limit(20, 100)] },
+    { tool: "instagram_story_highlights", name: "Instagram Story Highlights", path: "/v1/instagram/story-highlights", credits: 5, summary: "List a profile's story highlight covers.", params: [url(IG_PROFILE)] },
+    { tool: "instagram_highlights_details", name: "Instagram Highlights Details", path: "/v1/instagram/highlights-details", credits: 9, summary: "Items inside a profile's story highlights.", params: [url(IG_PROFILE), { name: "limit", type: "number", required: false, description: "Max highlights to expand. Default 10, max 50." }] },
+    { tool: "instagram_embed", name: "Instagram Embed", path: "/v1/instagram/embed", credits: 1, summary: "Embed HTML for an Instagram post/reel.", params: [url(IG_POST)] },
+];
+const FACEBOOK = [
+    { tool: "facebook_details", name: "Facebook Details", path: "/v1/facebook/details", credits: 1, summary: "Details for a Facebook video or post.", params: [url(FB_VIDEO)] },
+    { tool: "facebook_transcript", name: "Facebook Transcript", path: "/v1/facebook/transcript", credits: 2, summary: "Transcript of a Facebook video.", params: [url(FB_VIDEO)] },
+    { tool: "facebook_summarize", name: "Facebook Summarizer", path: "/v1/facebook/summarize", credits: 4, summary: "AI summary of a Facebook video or post.", params: [url(FB_VIDEO)] },
+    { tool: "facebook_comments", name: "Facebook Comments", path: "/v1/facebook/comments", credits: 30, summary: "Comments on a Facebook post.", params: [url(FB_VIDEO), limit(50, 500)] },
+    { tool: "facebook_page_details", name: "Facebook Page Details", path: "/v1/facebook/page-details", credits: 1, summary: "Info & stats for a Facebook page.", params: [url("Facebook page URL, e.g. https://facebook.com/PageName.")] },
+    { tool: "facebook_profile_posts", name: "Facebook Profile Posts", path: "/v1/facebook/profile-posts", credits: 12, summary: "Latest posts from a Facebook profile/page.", params: [url("Facebook profile or page URL."), limit(20, 200)] },
+    { tool: "facebook_profile_reels", name: "Facebook Profile Reels", path: "/v1/facebook/profile-reels", credits: 36, summary: "Latest Reels from a Facebook profile/page.", params: [url("Facebook profile or page URL."), limit(20, 200)] },
+    { tool: "facebook_group_posts", name: "Facebook Group Posts", path: "/v1/facebook/group-posts", credits: 12, summary: "Posts from a public Facebook group.", params: [url("Public Facebook group URL, e.g. https://facebook.com/groups/ID."), limit(20, 200)] },
+    { tool: "facebook_comment_replies", name: "Facebook Comment Replies", path: "/v1/facebook/comment-replies", credits: 30, summary: "Replies to a specific Facebook comment.", params: [url("Facebook post URL the comment belongs to."), commentId(), limit(50, 500)] },
+];
+function withPlatform(list, platform) {
+    return list.map((e) => ({ ...e, platform }));
+}
+exports.ENDPOINTS = [
+    ...withPlatform(YOUTUBE, "youtube"),
+    ...withPlatform(TIKTOK, "tiktok"),
+    ...withPlatform(INSTAGRAM, "instagram"),
+    ...withPlatform(FACEBOOK, "facebook"),
+];
+/** A concise, agent-facing description (summary + cost) for an endpoint. */
+function describe(e) {
+    return `${e.summary} Costs ~${e.credits} credit${e.credits === 1 ? "" : "s"}; cached results are free, failures are never charged.`;
+}

package/dist/credentials/CaptapiApi.credentials.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CaptapiApi = void 0;
+class CaptapiApi {
+    constructor() {
+        this.name = 'captapiApi';
+        this.displayName = 'Captapi API';
+        this.documentationUrl = 'https://captapi.com/docs';
+        this.properties = [
+            {
+                displayName: 'API Key',
+                name: 'apiKey',
+                type: 'string',
+                typeOptions: { password: true },
+                default: '',
+                required: true,
+                description: 'Your Captapi API key. Create one at https://captapi.com/dashboard/api-keys',
+            },
+            {
+                displayName: 'Base URL',
+                name: 'baseUrl',
+                type: 'string',
+                default: 'https://api.captapi.com',
+                description: 'Captapi API base URL. Only change this if you use a custom or self-hosted gateway.',
+            },
+        ];
+        this.authenticate = {
+            type: 'generic',
+            properties: {
+                headers: {
+                    Authorization: '=Bearer {{$credentials.apiKey}}',
+                },
+            },
+        };
+        this.test = {
+            request: {
+                baseURL: '={{$credentials.baseUrl}}',
+                url: '/v1/account/limits',
+            },
+        };
+    }
+}
+exports.CaptapiApi = CaptapiApi;

package/dist/nodes/Captapi/Captapi.node.js

@@ -0,0 +1,164 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Captapi = void 0;
+const n8n_workflow_1 = require("n8n-workflow");
+const catalog_1 = require("../../catalog");
+const VERSION = '0.1.0';
+const PLATFORMS = [
+    { value: 'youtube', name: 'YouTube' },
+    { value: 'tiktok', name: 'TikTok' },
+    { value: 'instagram', name: 'Instagram' },
+    { value: 'facebook', name: 'Facebook' },
+];
+// Friendly field labels for the known parameter names in the catalog.
+const PARAM_LABELS = {
+    url: 'URL',
+    q: 'Query',
+    query: 'Query',
+    limit: 'Limit',
+    language: 'Language',
+    comment_id: 'Comment ID',
+    country: 'Country',
+};
+function labelFor(name) {
+    if (PARAM_LABELS[name])
+        return PARAM_LABELS[name];
+    return name
+        .split('_')
+        .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+        .join(' ');
+}
+// Build the full property list (resource + per-platform operations + per-endpoint
+// fields) directly from the shared catalog, so the node always matches the API.
+function buildProperties() {
+    const props = [];
+    props.push({
+        displayName: 'Platform',
+        name: 'resource',
+        type: 'options',
+        noDataExpression: true,
+        options: PLATFORMS.map((p) => ({ name: p.name, value: p.value })),
+        default: 'youtube',
+    });
+    for (const p of PLATFORMS) {
+        const eps = catalog_1.ENDPOINTS.filter((e) => e.platform === p.value);
+        props.push({
+            displayName: 'Operation',
+            name: 'operation',
+            type: 'options',
+            noDataExpression: true,
+            displayOptions: { show: { resource: [p.value] } },
+            options: eps.map((e) => ({
+                name: e.name,
+                value: e.tool,
+                description: e.summary,
+                action: e.name,
+            })),
+            default: eps.length ? eps[0].tool : '',
+        });
+    }
+    for (const e of catalog_1.ENDPOINTS) {
+        for (const param of e.params) {
+            props.push({
+                displayName: labelFor(param.name),
+                name: param.name,
+                type: param.type === 'number' ? 'number' : 'string',
+                required: param.required,
+                default: param.type === 'number' ? 0 : '',
+                description: param.description,
+                displayOptions: {
+                    show: {
+                        resource: [e.platform],
+                        operation: [e.tool],
+                    },
+                },
+            });
+        }
+    }
+    return props;
+}
+class Captapi {
+    constructor() {
+        this.description = {
+            displayName: 'Captapi',
+            name: 'captapi',
+            icon: 'fa:photo-video',
+            iconColor: 'purple',
+            group: ['transform'],
+            version: 1,
+            subtitle: '={{$parameter["operation"]}}',
+            description: 'Structured social media data from YouTube, TikTok, Instagram & Facebook — transcripts, AI summaries, comments, stats, search and downloads.',
+            defaults: {
+                name: 'Captapi',
+            },
+            inputs: ['main'],
+            outputs: ['main'],
+            credentials: [
+                {
+                    name: 'captapiApi',
+                    required: true,
+                },
+            ],
+            requestDefaults: {
+                baseURL: '={{$credentials.baseUrl}}',
+            },
+            properties: buildProperties(),
+        };
+    }
+    async execute() {
+        const items = this.getInputData();
+        const returnData = [];
+        const credentials = await this.getCredentials('captapiApi');
+        const baseUrl = String(credentials.baseUrl || 'https://api.captapi.com').replace(/\/+$/, '');
+        const byTool = new Map(catalog_1.ENDPOINTS.map((e) => [e.tool, e]));
+        for (let i = 0; i < items.length; i++) {
+            try {
+                const operation = this.getNodeParameter('operation', i);
+                const endpoint = byTool.get(operation);
+                if (!endpoint) {
+                    throw new n8n_workflow_1.NodeOperationError(this.getNode(), `Unknown operation: ${operation}`, {
+                        itemIndex: i,
+                    });
+                }
+                const qs = {};
+                for (const param of endpoint.params) {
+                    const value = this.getNodeParameter(param.name, i, '');
+                    const isEmpty = value === '' ||
+                        value === undefined ||
+                        value === null ||
+                        (param.type === 'number' && Number(value) === 0);
+                    if (!isEmpty)
+                        qs[param.name] = value;
+                }
+                const responseData = await this.helpers.httpRequestWithAuthentication.call(this, 'captapiApi', {
+                    method: 'GET',
+                    baseURL: baseUrl,
+                    url: endpoint.path,
+                    qs,
+                    json: true,
+                    headers: {
+                        'User-Agent': `n8n-nodes-captapi/${VERSION}`,
+                    },
+                });
+                returnData.push({
+                    json: (responseData !== null && responseData !== void 0 ? responseData : {}),
+                    pairedItem: { item: i },
+                });
+            }
+            catch (error) {
+                if (this.continueOnFail()) {
+                    returnData.push({
+                        json: { error: error.message },
+                        pairedItem: { item: i },
+                    });
+                    continue;
+                }
+                if (error instanceof n8n_workflow_1.NodeOperationError)
+                    throw error;
+                throw new n8n_workflow_1.NodeApiError(this.getNode(), error, { itemIndex: i });
+            }
+        }
+        return [returnData];
+    }
+}
+exports.Captapi = Captapi;

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "n8n-nodes-captapi",
+  "version": "0.1.0",
+  "description": "n8n community node for Captapi — structured social media data from YouTube, TikTok, Instagram & Facebook (transcripts, AI summaries, comments, stats, search, downloads). 62 operations, one API key.",
+  "keywords": [
+    "n8n-community-node-package",
+    "n8n",
+    "captapi",
+    "youtube",
+    "tiktok",
+    "instagram",
+    "facebook",
+    "social-media",
+    "transcript",
+    "scraper"
+  ],
+  "license": "MIT",
+  "homepage": "https://captapi.com",
+  "author": {
+    "name": "Captapi",
+    "email": "support@captapi.com"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/CDCStream/captapi.git",
+    "directory": "packages/captapi-n8n"
+  },
+  "engines": {
+    "node": ">=18.10"
+  },
+  "main": "index.js",
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist"
+  ],
+  "n8n": {
+    "n8nNodesApiVersion": 1,
+    "credentials": [
+      "dist/credentials/CaptapiApi.credentials.js"
+    ],
+    "nodes": [
+      "dist/nodes/Captapi/Captapi.node.js"
+    ]
+  },
+  "peerDependencies": {
+    "n8n-workflow": "*"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "n8n-workflow": "^1.66.0",
+    "typescript": "^5.6.0"
+  }
+}