n8n-nodes-pinterest 0.1.5 → 0.1.7

package/README.md

@@ -6,7 +6,7 @@ Supports:
 
 - Cookie-based authentication (session cookie)
 - List boards (current user)
-- Create a Pin with a binary image input
+- Create a Pin by uploading binary data or by letting Pinterest scrape a public image URL
 
 Notes:
 
@@ -37,14 +37,16 @@ Creates a pin using cookie-based authentication.
 Inputs:
 
 - Board (select from available boards)
-- Binary Property (e.g. `data`)
+- Image Source:
+  - **Upload Binary**: supply a binary property (e.g. `data`). The node uploads the file to Pinterest's S3 slot, builds the CDN URL from the returned `ETag`, and creates the pin with `method="uploaded"` (same as FS Poster).
+  - **Scraped Image URL**: supply a direct image URL. The node calls the same `/pin/find/?url=...` flow as wp-pinterest-automatic and creates the pin with `method="scraped"`—no binary data required.
 - Optional: Title, Description, Link, Alt Text
 
-Binary image comes from the input item's binary property. The node uploads the image to the `upload_url` from VIPResource, derives the final `image_url` from the `ETag`, then creates the Pin via `PinResource/create/`.
+Binary uploads follow the VIPResource → S3 → PinResource pipeline. Scraped mode just replays the legacy "pin finder" payload and works for images that are accessible over HTTPS.
 
 Additional behavior:
 
-- "Attach Link" (default true) inside Additional Fields controls whether the destination link is sent. If Pinterest returns an error like "This site doesn't allow you to save Pins.", the node automatically retries without the link.
+- "Attach Link" (default true) still controls whether the destination link is sent. If Pinterest responds with errors such as "This site doesn't allow you to save Pins" or "Please make sure the URL is correct", the node automatically retries without the link unless Strict Plugin Mode is enabled.
 
 ## Disclaimer
 

package/dist/nodes/PinterestCookie/PinterestCookie.node.js

@@ -23,6 +23,21 @@ function buildCookieHeader(sess, csrf) {
     return `_pinterest_sess=${sess}; csrftoken=${csrf};`;
 }
 const PINTEREST_BASE = 'https://www.pinterest.com';
+function sanitizePinterestText(value, limit) {
+    if (!value)
+        return '';
+    let sanitized = value.replace(/&/g, '&').replace(/&/g, '&');
+    sanitized = sanitized.replace(/\r\n|\r|\n/g, '\n');
+    sanitized = sanitized.replace(/\t/g, ' ').trim();
+    if (sanitized.length > limit) {
+        sanitized = sanitized.slice(0, limit - 3) + '...';
+    }
+    sanitized = sanitized.replace(/"/g, '\"');
+    return sanitized;
+}
+function doubleEncodeUrl(value) {
+    return encodeURIComponent(encodeURIComponent(value));
+}
 async function resolveBaseUrl(ctx, headers, proxy) {
     try {
         const resp = (await ctx.helpers.request({
@@ -96,15 +111,36 @@ class PinterestCookie {
                     required: true,
                     description: 'Board to pin to',
                 },
+                {
+                    displayName: 'Image Source',
+                    name: 'imageSource',
+                    type: 'options',
+                    options: [
+                        { name: 'Upload Binary', value: 'uploadBinary' },
+                        { name: 'Scraped Image URL', value: 'scrapedUrl' },
+                    ],
+                    default: 'uploadBinary',
+                    displayOptions: { show: { resource: ['pin'], operation: ['create'] } },
+                    description: 'Choose whether to upload a binary image or let Pinterest scrape an external URL',
+                },
                 {
                     displayName: 'Binary Property',
                     name: 'binaryProperty',
                     type: 'string',
                     default: 'data',
                     required: true,
-                    displayOptions: { show: { resource: ['pin'], operation: ['create'] } },
+                    displayOptions: { show: { resource: ['pin'], operation: ['create'], imageSource: ['uploadBinary'] } },
                     description: 'Name of the binary property containing the image',
                 },
+                {
+                    displayName: 'Image URL',
+                    name: 'imageUrl',
+                    type: 'string',
+                    default: '',
+                    required: true,
+                    displayOptions: { show: { resource: ['pin'], operation: ['create'], imageSource: ['scrapedUrl'] } },
+                    description: 'Direct URL of the image when using the scraped method',
+                },
                 {
                     displayName: 'Title',
                     name: 'title',
@@ -243,7 +279,7 @@ class PinterestCookie {
         };
     }
     async execute() {
-        var _a, _b, _c;
+        var _a, _b, _c, _d;
         const items = this.getInputData();
         const returnData = [];
         const creds = (await this.getCredentials('pinterestCookieApi'));
@@ -307,135 +343,37 @@ class PinterestCookie {
                     const operation = this.getNodeParameter('operation', i);
                     if (operation === 'create') {
                         const boardId = this.getNodeParameter('boardId', i);
-                        const binaryProperty = this.getNodeParameter('binaryProperty', i);
+                        const imageSource = this.getNodeParameter('imageSource', i, 'uploadBinary');
                         const title = this.getNodeParameter('title', i, '');
                         const description = this.getNodeParameter('description', i, '');
                         const additionalFields = this.getNodeParameter('additionalFields', i, {});
-                        const debugRaw = this.getNodeParameter('debugRaw', i, false);
                         const strictPluginMode = this.getNodeParameter('strictPluginMode', i, false);
-                        const binary = (_c = items[i].binary) === null || _c === void 0 ? void 0 : _c[binaryProperty];
-                        if (!binary)
-                            throw new Error(`Binary property "${binaryProperty}" is missing on item ${i}`);
-                        // Step 1: request upload slot
-                        const vipResp = (await this.helpers.request({
-                            method: 'POST',
-                            uri: `${base}/resource/VIPResource/create/`,
-                            form: {
-                                source_url: '/pin-builder/',
-                                data: '{"options":{"type":"pinimage"},"context":{}}',
-                            },
-                            headers: strictPluginMode
-                                ? { ...buildCommonHeaders(csrf, true), Cookie: cookieHeader }
-                                : {
-                                    ...baseHeaders,
-                                    Cookie: cookieHeader,
-                                    Referer: `${base}/pin-builder/`,
-                                    Origin: base,
-                                    'X-Pinterest-Source-Url': '/pin-builder/',
-                                    'Content-Type': 'application/x-www-form-urlencoded; charset=UTF-8',
-                                },
-                            proxy: proxy || undefined,
-                        }));
-                        const vip = JSON.parse(vipResp);
-                        const res = vip.resource_response || {};
-                        const data = res.data || {};
-                        const uploadUrl = String(data.upload_url || '');
-                        const uploadParams = data.upload_parameters || {};
-                        if (!uploadUrl)
-                            throw new Error('Failed to get upload URL');
-                        // Step 2: upload image
-                        const buffer = Buffer.from(binary.data, 'base64');
-                        const contentType = binary.mimeType || 'image/jpeg';
-                        const formData = {};
-                        for (const [k, v] of Object.entries(uploadParams))
-                            formData[k] = String(v);
-                        formData['file'] = {
-                            value: buffer,
-                            options: {
-                                filename: 'blob',
-                                contentType,
-                            },
-                        };
-                        const uploadResp = (await this.helpers.request({
-                            method: 'POST',
-                            uri: uploadUrl,
-                            headers: {
-                                Accept: '*/*',
-                                'Accept-Encoding': 'gzip',
-                                'User-Agent': strictPluginMode
-                                    ? 'Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36'
-                                    : baseHeaders['User-Agent'],
-                                Origin: strictPluginMode ? 'https://www.pinterest.com' : base,
-                                Referer: strictPluginMode ? 'https://www.pinterest.com' : `${base}/pin-builder/`,
-                                ...(strictPluginMode
-                                    ? {
-                                        'sec-ch-ua': '".Not/A)Brand";v="99", "Google Chrome";v="103", "Chromium";v="103"',
-                                        'sec-ch-ua-mobile': '?0',
-                                        'sec-ch-ua-full': '?1',
-                                        'sec-ch-ua-platform': '"Windows"',
-                                        'Sec-Fetch-Dest': 'empty',
-                                        'Sec-Fetch-Mode': 'cors',
-                                        'Sec-Fetch-Site': 'same-origin',
-                                        Connection: 'keep-alive',
-                                    }
-                                    : {}),
-                            },
-                            formData,
-                            proxy: proxy || undefined,
-                            // get full response to read headers
-                            resolveWithFullResponse: true,
-                            simple: false,
-                        }));
-                        const etagRaw = uploadResp.headers['etag'] || uploadResp.headers['ETag'] || '';
-                        const etag = String(etagRaw).replace(/"/g, '');
-                        if (!etag)
-                            throw new Error('Upload failed: missing ETag');
-                        // compute imageUrl like plugin
-                        const imageUrl = `https://i.pinimg.com/736x/${etag[0]}${etag[1]}/${etag[2]}${etag[3]}/${etag[4]}${etag[5]}/${etag}.jpg`;
-                        // Step 3: create pin
+                        const debugRaw = this.getNodeParameter('debugRaw', i, false);
                         const attachLink = (additionalFields.attachLink !== undefined) ? Boolean(additionalFields.attachLink) : true;
-                        // Build payload
-                        const sendData = {
-                            options: {
-                                board_id: String(boardId),
-                                field_set_key: 'create_success',
-                                skip_pin_create_log: true,
-                                description: String(description || ''),
-                                alt_text: String(additionalFields.alt_text || ''),
-                                // Strict mode: always include link key
-                                link: String(additionalFields.link || ''),
-                                // Non-strict: allow disabling link entirely
-                                ...(strictPluginMode ? {} : (!attachLink ? { link: '' } : {})),
-                                title: String(title || ''),
-                                image_url: String(imageUrl),
-                                method: 'uploaded',
-                                upload_metric: { source: 'pinner_upload_standalone' },
-                                user_mention_tags: [],
-                                no_fetch_context_on_resource: false,
-                            },
-                            context: {},
-                        };
-                        const attemptCreate = async (payload) => {
-                            var _a, _b;
+                        const attemptCreate = async (payload, createOptions) => {
+                            var _a, _b, _c, _d, _e;
+                            const form = {
+                                source_url: (_a = createOptions === null || createOptions === void 0 ? void 0 : createOptions.sourceUrl) !== null && _a !== void 0 ? _a : '/pin-builder/',
+                                data: JSON.stringify(payload),
+                            };
+                            if (createOptions === null || createOptions === void 0 ? void 0 : createOptions.modulePath) {
+                                form.module_path = createOptions.modulePath;
+                            }
                             const createResp = (await this.helpers.request({
                                 method: 'POST',
                                 uri: `${base}/resource/PinResource/create/`,
-                                form: {
-                                    source_url: '/pin-builder/',
-                                    data: JSON.stringify(payload),
-                                },
+                                form,
                                 headers: strictPluginMode
                                     ? { ...buildCommonHeaders(csrf, true), Cookie: cookieHeader }
                                     : {
                                         ...baseHeaders,
                                         Cookie: cookieHeader,
-                                        Referer: `${base}/pin-builder/`,
+                                        Referer: ((_b = createOptions === null || createOptions === void 0 ? void 0 : createOptions.sourceUrl) === null || _b === void 0 ? void 0 : _b.startsWith('/pin/find')) ? `${base}/pin/find/` : `${base}/pin-builder/`,
                                         Origin: base,
-                                        'X-Pinterest-Source-Url': '/pin-builder/',
+                                        'X-Pinterest-Source-Url': (_c = createOptions === null || createOptions === void 0 ? void 0 : createOptions.sourceUrl) !== null && _c !== void 0 ? _c : '/pin-builder/',
                                         'Content-Type': 'application/x-www-form-urlencoded; charset=UTF-8',
                                     },
                                 proxy: proxy || undefined,
-                                // Get body even on 4xx
                                 simple: false,
                                 resolveWithFullResponse: true,
                             }));
@@ -448,52 +386,184 @@ class PinterestCookie {
                             const createdRes = created.resource_response || {};
                             const pinData = createdRes.data || {};
                             const id = String(pinData.id || '');
-                            const msg = createdRes.message || ((_a = createdRes.error) === null || _a === void 0 ? void 0 : _a.message) || '';
-                            const msgDetail = ((_b = createdRes.error) === null || _b === void 0 ? void 0 : _b.message_detail) || '';
+                            const msg = createdRes.message || ((_d = createdRes.error) === null || _d === void 0 ? void 0 : _d.message) || '';
+                            const msgDetail = ((_e = createdRes.error) === null || _e === void 0 ? void 0 : _e.message_detail) || '';
                             return { ok: Boolean(id), id, msg: String(msg || msgDetail || ''), body, payload };
                         };
-                        let result = { ok: false };
-                        if (strictPluginMode) {
-                            result = await attemptCreate(sendData);
-                            if (!result.ok) {
-                                if (debugRaw && this.continueOnFail()) {
-                                    returnData.push({ json: { error: result.msg || 'Create failed', response: result.body, request: sendData } });
+                        const isLinkError = (msg) => /doesn['’]?t allow you to save Pins|does not allow you to save Pins|please make sure the url is correct/i.test(msg || '');
+                        const runStrategies = async (strategies) => {
+                            let lastResult = { ok: false };
+                            for (const strat of strategies) {
+                                lastResult = await attemptCreate(strat.payload, strat.options);
+                                if (lastResult.ok) {
+                                    return lastResult;
+                                }
+                                if (!strictPluginMode && isLinkError(lastResult.msg)) {
                                     continue;
                                 }
-                                throw new Error(result.msg || result.body || 'Create failed');
                             }
+                            return lastResult;
+                        };
+                        let result = { ok: false };
+                        if (imageSource === 'scrapedUrl') {
+                            const imageUrl = this.getNodeParameter('imageUrl', i, '');
+                            if (!imageUrl) {
+                                throw new Error('Image URL is required when using the scraped method.');
+                            }
+                            const sanitizedTitle = sanitizePinterestText(title, 100);
+                            const sanitizedDesc = sanitizePinterestText(description, 500);
+                            const linkValue = attachLink ? String((_c = additionalFields.link) !== null && _c !== void 0 ? _c : '') : '';
+                            const scrapedPayload = {
+                                options: {
+                                    method: 'scraped',
+                                    title: sanitizedTitle,
+                                    description: sanitizedDesc,
+                                    link: linkValue,
+                                    image_url: imageUrl,
+                                    share_facebook: false,
+                                    board_id: boardId,
+                                    scrape_metric: { source: 'www_url_scrape' },
+                                },
+                                context: {},
+                            };
+                            const scrapedOptions = {
+                                sourceUrl: `/pin/find/?url=${doubleEncodeUrl(imageUrl)}`,
+                                modulePath: 'App()%3EModalManager%3EModal%3EPinCreate%3EBoardPicker%3ESelectList(view_type%3DpinCreate%2C+selected_section_index%3Dundefined%2C+selected_item_index%3Dundefined%2C+highlight_matched_text%3Dtrue%2C+suppress_hover_events%3Dundefined%2C+scroll_selected_item_into_view%3Dtrue%2C+select_first_item_after_update%3Dfalse%2C+item_module%3D%5Bobject+Object%5D)',
+                            };
+                            const strategies = [
+                                { payload: scrapedPayload, options: scrapedOptions },
+                            ];
+                            if (!strictPluginMode && linkValue) {
+                                const withoutLink = JSON.parse(JSON.stringify(scrapedPayload));
+                                if (withoutLink.options) {
+                                    withoutLink.options.link = '';
+                                }
+                                strategies.push({ payload: withoutLink, options: scrapedOptions });
+                            }
+                            result = await runStrategies(strategies);
                         }
                         else {
-                            // Try strategies progressively to avoid generic errors
-                            const strategies = [];
-                            strategies.push(JSON.parse(JSON.stringify(sendData)));
-                            const s2 = JSON.parse(JSON.stringify(sendData));
-                            if (s2.options)
-                                delete s2.options.link;
-                            strategies.push(s2);
-                            strategies.push({
+                            const binaryProperty = this.getNodeParameter('binaryProperty', i);
+                            const binary = (_d = items[i].binary) === null || _d === void 0 ? void 0 : _d[binaryProperty];
+                            if (!binary)
+                                throw new Error(`Binary property "${binaryProperty}" is missing on item ${i}`);
+                            const vipResp = (await this.helpers.request({
+                                method: 'POST',
+                                uri: `${base}/resource/VIPResource/create/`,
+                                form: {
+                                    source_url: '/pin-builder/',
+                                    data: '{"options":{"type":"pinimage"},"context":{}}',
+                                },
+                                headers: strictPluginMode
+                                    ? { ...buildCommonHeaders(csrf, true), Cookie: cookieHeader }
+                                    : {
+                                        ...baseHeaders,
+                                        Cookie: cookieHeader,
+                                        Referer: `${base}/pin-builder/`,
+                                        Origin: base,
+                                        'X-Pinterest-Source-Url': '/pin-builder/',
+                                        'Content-Type': 'application/x-www-form-urlencoded; charset=UTF-8',
+                                    },
+                                proxy: proxy || undefined,
+                            }));
+                            const vip = JSON.parse(vipResp);
+                            const res = vip.resource_response || {};
+                            const data = res.data || {};
+                            const uploadUrl = String(data.upload_url || '');
+                            const uploadParams = data.upload_parameters || {};
+                            if (!uploadUrl)
+                                throw new Error('Failed to get upload URL');
+                            const buffer = Buffer.from(binary.data, 'base64');
+                            const contentType = binary.mimeType || 'image/jpeg';
+                            const formData = {};
+                            for (const [k, v] of Object.entries(uploadParams))
+                                formData[k] = String(v);
+                            formData['file'] = {
+                                value: buffer,
                                 options: {
-                                    board_id: boardId,
+                                    filename: 'blob',
+                                    contentType,
+                                },
+                            };
+                            const uploadResp = (await this.helpers.request({
+                                method: 'POST',
+                                uri: uploadUrl,
+                                headers: {
+                                    Accept: '*/*',
+                                    'Accept-Encoding': 'gzip',
+                                    'User-Agent': strictPluginMode
+                                        ? 'Mozilla/5.0 (Windows NT 10.0; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/103.0.0.0 Safari/537.36'
+                                        : baseHeaders['User-Agent'],
+                                    Origin: strictPluginMode ? 'https://www.pinterest.com' : base,
+                                    Referer: strictPluginMode ? 'https://www.pinterest.com' : `${base}/pin-builder/`,
+                                    ...(strictPluginMode
+                                        ? {
+                                            'sec-ch-ua': '".Not/A)Brand";v="99", "Google Chrome";v="103", "Chromium";v="103"',
+                                            'sec-ch-ua-mobile': '?0',
+                                            'sec-ch-ua-full': '?1',
+                                            'sec-ch-ua-platform': '"Windows"',
+                                            'Sec-Fetch-Dest': 'empty',
+                                            'Sec-Fetch-Mode': 'cors',
+                                            'Sec-Fetch-Site': 'same-origin',
+                                            Connection: 'keep-alive',
+                                        }
+                                        : {}),
+                                },
+                                formData,
+                                proxy: proxy || undefined,
+                                resolveWithFullResponse: true,
+                                simple: false,
+                            }));
+                            const etagRaw = uploadResp.headers['etag'] || uploadResp.headers['ETag'] || '';
+                            const etag = String(etagRaw).replace(/"/g, '');
+                            if (!etag)
+                                throw new Error('Upload failed: missing ETag');
+                            const imageUrl = `https://i.pinimg.com/736x/${etag[0]}${etag[1]}/${etag[2]}${etag[3]}/${etag[4]}${etag[5]}/${etag}.jpg`;
+                            const sendData = {
+                                options: {
+                                    board_id: String(boardId),
                                     field_set_key: 'create_success',
-                                    image_url: imageUrl,
+                                    skip_pin_create_log: true,
+                                    description: String(description || ''),
+                                    alt_text: String(additionalFields.alt_text || ''),
+                                    link: attachLink && additionalFields.link ? String(additionalFields.link) : '',
+                                    title: String(title || ''),
+                                    image_url: String(imageUrl),
                                     method: 'uploaded',
+                                    upload_metric: { source: 'pinner_upload_standalone' },
+                                    user_mention_tags: [],
+                                    no_fetch_context_on_resource: false,
                                 },
                                 context: {},
-                            });
-                            for (const strat of strategies) {
-                                result = await attemptCreate(strat);
-                                if (result.ok)
-                                    break;
-                                if (/doesn\'t allow you to save Pins|does not allow you to save Pins/i.test(result.msg || ''))
-                                    continue;
+                            };
+                            const strategies = [
+                                { payload: JSON.parse(JSON.stringify(sendData)) },
+                            ];
+                            if (!strictPluginMode) {
+                                const withoutLink = JSON.parse(JSON.stringify(sendData));
+                                if (withoutLink.options)
+                                    delete withoutLink.options.link;
+                                strategies.push({ payload: withoutLink });
+                                strategies.push({
+                                    payload: {
+                                        options: {
+                                            board_id: boardId,
+                                            field_set_key: 'create_success',
+                                            image_url: imageUrl,
+                                            method: 'uploaded',
+                                        },
+                                        context: {},
+                                    },
+                                });
                             }
-                            if (!result.ok) {
-                                if (debugRaw && this.continueOnFail()) {
-                                    returnData.push({ json: { error: result.msg || 'Create failed', response: result.body, request: strategies[strategies.length - 1] } });
-                                    continue;
-                                }
-                                throw new Error(result.msg || result.body || 'Create failed');
+                            result = await runStrategies(strategies);
+                        }
+                        if (!result.ok) {
+                            if (debugRaw && this.continueOnFail()) {
+                                returnData.push({ json: { error: result.msg || 'Create failed', response: result.body, request: result.payload } });
+                                continue;
                             }
+                            throw new Error(result.msg || result.body || 'Create failed');
                         }
                         returnData.push({ json: { id: result.id, link: `https://www.pinterest.com/pin/${result.id}` } });
                     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "n8n-nodes-pinterest",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "n8n community nodes for Pinterest v5 API (list boards, create pins)",
   "keywords": [
     "n8n-community-node-package",