n8n-nodes-chatads 0.1.3 → 0.1.4

package/README.md

@@ -44,9 +44,9 @@ The node accepts the following fields (via parameters or `Extra Fields (JSON)`):
 | Field | Type | Description |
 |-------|------|-------------|
 | `message` | string (required) | Message to analyze (1-5000 chars) |
-| `ip` | string | Client IP address for geo-detection |
-| `country` | string | ISO 3166-1 alpha-2 country code for geo-targeting |
-| `message_analysis` | string | Extraction method: `"fast"`, `"balanced"` (default), `"thorough"` |
-| `fill_priority` | string | URL resolution: `"speed"` or `"coverage"` (default) |
-| `min_intent` | string | Intent filter: `"any"`, `"low"` (default), `"medium"`, `"high"` |
-| `skip_message_analysis` | boolean | Skip NLP/LLM and use message directly as search query |
+| `ip` | string | IPv4 address for country detection (max 64 characters) |
+| `country` | string | Country code (e.g., 'US'). If provided, skips IP-based country detection |
+| `message_analysis` | string | Controls keyword extraction method. Use 'fast' to optimize for speed, 'thorough' (default) to optimize for best keyword selection |
+| `fill_priority` | string | Controls affiliate link discovery. Use 'speed' to optimize for speed, 'coverage' (default) to ping multiple sources for the right affiliate link |
+| `min_intent` | string | Minimum purchase intent level required for affiliate resolution. 'any' = no filtering, 'low' (default) = filter garbage, 'medium' = balanced quality/fill, 'high' = high-intent keywords only |
+| `skip_message_analysis` | boolean | Treat exact message as product keyword. When true, goes straight to affiliate link discovery without keyword extraction |

package/dist/nodes/ChatAds/ChatAds.node.js

@@ -220,14 +220,14 @@ class ChatAds {
                             name: 'ip',
                             type: 'string',
                             default: '',
-                            description: 'Client IP address for geo-detection',
+                            description: 'IPv4 address for country detection (max 64 characters)',
                         },
                         {
                             displayName: 'Country',
                             name: 'country',
                             type: 'string',
                             default: '',
-                            description: 'ISO 3166-1 alpha-2 country code for geo-targeting',
+                            description: "Country code (e.g., 'US'). If provided, skips IP-based country detection",
                         },
                         {
                             displayName: 'Message Analysis',
@@ -235,11 +235,10 @@ class ChatAds {
                             type: 'options',
                             options: [
                                 { name: 'Fast', value: 'fast' },
-                                { name: 'Balanced', value: 'balanced' },
                                 { name: 'Thorough', value: 'thorough' },
                             ],
-                            default: 'balanced',
-                            description: 'Keyword extraction method. Fast uses NLP only (~50ms), others use LLM.',
+                            default: 'thorough',
+                            description: 'Controls keyword extraction method. Use fast to optimize for speed, thorough to optimize for best keyword selection.',
                         },
                         {
                             displayName: 'Fill Priority',
@@ -250,7 +249,7 @@ class ChatAds {
                                 { name: 'Coverage', value: 'coverage' },
                             ],
                             default: 'coverage',
-                            description: 'URL resolution fallback strategy',
+                            description: 'Controls affiliate link discovery. Use speed to optimize for speed, coverage to ping multiple sources for the right affiliate link',
                         },
                         {
                             displayName: 'Min Intent',
@@ -263,14 +262,14 @@ class ChatAds {
                                 { name: 'High', value: 'high' },
                             ],
                             default: 'low',
-                            description: 'Minimum purchase intent level for affiliate resolution',
+                            description: "Minimum purchase intent level required for affiliate resolution. 'any' = no filtering, 'low' = filter garbage, 'medium' = balanced quality/fill, 'high' = high-intent keywords only",
                         },
                         {
                             displayName: 'Skip Message Analysis',
                             name: 'skip_message_analysis',
                             type: 'boolean',
                             default: false,
-                            description: 'Skip NLP/LLM extraction and use message directly as search query. Overrides message_analysis, min_intent, and fill_priority.',
+                            description: 'Treat exact message as product keyword. When true, goes straight to affiliate link discovery without keyword extraction',
                         },
                         {
                             displayName: 'Extra Fields (JSON)',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-nodes-chatads",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "n8n wrapper around the ChatAds FastAPI backend (affiliate/chatads_backend.py)",
   "license": "MIT",
   "main": "dist/index.js",