@ferchy/n8n-nodes-aimc-toolkit 0.1.16 → 0.1.18

package/README.md

@@ -193,6 +193,8 @@ Use **Input Mode = File Path** to avoid loading big files into memory.
 
 ### AIMC Social Scraper
 
+> **💡 Tip**: You can also use TikTok scraper programmatically in the **AIMC Code** node using `tiktokScraper` or `TikTokScraper` global variables. This UI node provides a simpler interface for common scraping tasks.
+
 > **⚠️ Important Legal Notice**: This node uses web scraping techniques, not official APIs. It is provided for educational and personal use only. Users are responsible for complying with:
 > - TikTok's Terms of Service
 > - Applicable laws and regulations in their jurisdiction
@@ -215,8 +217,11 @@ Use **Input Mode = File Path** to avoid loading big files into memory.
 
 **Key Options**
 - **Number of Posts**: How many posts to scrape (1-1000)
-- **Session Cookie**: TikTok session cookie (`sid_tt`) to avoid rate limits
-  - Get from browser DevTools > Application > Cookies > tiktok.com
+- **Options** (collapsible section):
+  - **No Watermark**: Download videos without TikTok watermark
+  - **HD Video**: Download in HD quality
+  - **By User ID**: Treat username as user ID (for large IDs)
+  - **Session Cookie** (Advanced): Only needed if you encounter rate limits - see instructions below
 - **No Watermark**: Download videos without TikTok watermark
 - **HD Video**: Download in HD quality
 - **By User ID**: Treat username as user ID (for large IDs)
@@ -227,9 +232,9 @@ Platform: TikTok
 Scrape Type: User Posts
 Username: username
 Number of Posts: 50
-Session Cookie: sid_tt=abc123...
-Options:
+Options (expand if needed):
   - No Watermark: true
+  - Session Cookie: (only if you hit rate limits)
 ```
 
 **Example: Scrape Hashtag**
@@ -247,13 +252,23 @@ Scrape Type: Trending
 Number of Posts: 30
 ```
 
-**Session Cookie Setup**
-1. Open TikTok in your browser
-2. Open DevTools (F12)
-3. Go to Application > Cookies > `https://www.tiktok.com`
-4. Find `sid_tt` cookie
-5. Copy the value (e.g., `sid_tt=abc123def456...`)
-6. Paste into the Session Cookie field
+**Session Cookie (Advanced - Optional)**
+The scraper works **without cookies by default**. Session cookies are only needed if you encounter rate limits. They're hidden in the **Options** section - you don't need to worry about them unless you have issues.
+
+**When you might need a session cookie:**
+- You're scraping many posts and getting rate limited
+- You're seeing captcha challenges
+- You need to scrape large amounts of data regularly
+
+**To get a session cookie (only if needed):**
+1. Open TikTok in your browser and log in
+2. Open DevTools (F12 or Right-click > Inspect)
+3. Go to **Application** tab > **Cookies** > `https://www.tiktok.com`
+4. Find the `sid_tt` cookie
+5. Copy the entire value (e.g., `sid_tt=abc123def456...`)
+6. Expand **Options** in the node and paste into the Session Cookie field
+
+**Tip**: Start without a cookie. Most users won't need it. Only add one if you hit rate limits.
 
 **Note**: Session cookies help avoid rate limits and captchas. They're optional but recommended for production use.
 

package/dist/nodes/AimcSocial/AimcSocial.node.js

@@ -107,8 +107,8 @@ class AimcSocial {
                             scrapeType: ['user'],
                         },
                     },
-                    placeholder: 'username',
-                    description: 'TikTok username (without @)',
+                    placeholder: 'username or @username',
+                    description: 'TikTok username (with or without @ symbol - will be automatically removed)',
                 },
                 {
                     displayName: 'Hashtag',
@@ -122,8 +122,8 @@ class AimcSocial {
                             scrapeType: ['hashtag'],
                         },
                     },
-                    placeholder: 'fyp',
-                    description: 'Hashtag to scrape (without #)',
+                    placeholder: 'fyp or #fyp',
+                    description: 'Hashtag to scrape (with or without # symbol - will be automatically removed)',
                 },
                 {
                     displayName: 'Video URL',
@@ -157,22 +157,6 @@ class AimcSocial {
                     },
                     description: 'Number of posts to scrape',
                 },
-                {
-                    displayName: 'Session Cookie',
-                    name: 'sessionCookie',
-                    type: 'string',
-                    typeOptions: {
-                        password: true,
-                    },
-                    default: '',
-                    displayOptions: {
-                        show: {
-                            platform: ['tiktok'],
-                        },
-                    },
-                    placeholder: 'sid_tt=abc123...',
-                    description: 'TikTok session cookie (sid_tt) to avoid rate limits. Get from browser DevTools > Application > Cookies',
-                },
                 {
                     displayName: 'Options',
                     name: 'options',
@@ -204,12 +188,18 @@ class AimcSocial {
                             name: 'byUserId',
                             type: 'boolean',
                             default: false,
-                            displayOptions: {
-                                show: {
-                                    scrapeType: ['user'],
-                                },
+                            description: 'If true, interpret the username as a user ID (only applies to User Posts scrape type)',
+                        },
+                        {
+                            displayName: 'Session Cookie',
+                            name: 'sessionCookie',
+                            type: 'string',
+                            typeOptions: {
+                                password: true,
                             },
-                            description: 'If true, interpret the username as a user ID',
+                            default: '',
+                            placeholder: 'sid_tt=abc123...',
+                            description: '[Advanced] TikTok session cookie to reduce rate limits. Only needed if you encounter rate limits. Leave empty to use without. Format: "sid_tt=abc123def456..."',
                         },
                     ],
                 },
@@ -223,13 +213,19 @@ class AimcSocial {
             try {
                 const platform = this.getNodeParameter('platform', i);
                 const scrapeType = this.getNodeParameter('scrapeType', i);
-                const sessionCookie = this.getNodeParameter('sessionCookie', i, '');
                 const options = this.getNodeParameter('options', i, {});
                 let result;
                 if (platform === 'tiktok') {
+                    // Get session cookie from options if provided
+                    const sessionCookie = options.sessionCookie || '';
                     const sessionList = sessionCookie ? [sessionCookie] : [];
                     if (scrapeType === 'user') {
-                        const username = this.getNodeParameter('username', i);
+                        const usernameRaw = this.getNodeParameter('username', i);
+                        if (!usernameRaw || !usernameRaw.trim()) {
+                            throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Username is required. Please enter a TikTok username (without @ symbol).');
+                        }
+                        // Remove @ symbol if present and trim whitespace
+                        const username = usernameRaw.trim().replace(/^@/, '');
                         const number = this.getNodeParameter('number', i, 20);
                         result = await scrapeTikTokUser.call(this, username, {
                             number,
@@ -240,7 +236,12 @@ class AimcSocial {
                         });
                     }
                     else if (scrapeType === 'hashtag') {
-                        const hashtag = this.getNodeParameter('hashtag', i);
+                        const hashtagRaw = this.getNodeParameter('hashtag', i);
+                        if (!hashtagRaw || !hashtagRaw.trim()) {
+                            throw new n8n_workflow_1.NodeOperationError(this.getNode(), 'Hashtag is required. Please enter a TikTok hashtag (without # symbol).');
+                        }
+                        // Remove # symbol if present and trim whitespace
+                        const hashtag = hashtagRaw.trim().replace(/^#/, '');
                         const number = this.getNodeParameter('number', i, 20);
                         result = await scrapeTikTokHashtag.call(this, hashtag, {
                             number,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ferchy/n8n-nodes-aimc-toolkit",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "description": "AIMC Toolkit nodes for n8n: code execution and media operations.",
   "license": "MIT",
   "author": "Ferchy",