Powrót do strony głównej

Konfiguracja automatycznych pinów Pinterest dla strony

Przewodnik po konfiguracji automatycznych pinów Pinterest dla statycznych stron. Weryfikacja domeny, metatagi artykułów, skrypt Node.js do generowania RSS z HTML. Podłączenie do Pinterest Business dla ruchu.

Autopiny Pinterest: generator RSS na Node.js
Advertisement 728x90

Automatyzacja pinów Pinterest dla stron statycznych za pomocą RSS i metatagów

Aby zintegrować stronę z Pinterest, zacznij od weryfikacji domeny. W Pinterest Business Hub wybierz metodę metatagu i wstaw go w <head> strony głównej:

<meta name="p:domain_verify" content="12ac6ff1eaa70a3386sg439fda58bbb6"/>

To pozwoli Pinterest indeksować strony z Rich Pins. Następnie dodaj do każdego artykułu metatagi w <head>:

<meta name="is_article" content="true">
<meta name="pinterest_description" content="Opis dla pina, 150–200 znaków">
<meta name="pinterest_image" content="https://example.com/image.webp">
<meta name="article_published_at" content="2026-04-03T12:00:00+03:00">

Obraz powinien być pionowy (1000×1500 px), przez HTTPS, do 2 MB. Bez pinterest_image Pinterest używa pierwszego <img> na stronie, często nieoptymalnego.

Google AdInline article slot

Generowanie kanału RSS skryptem Node.js

Pinterest parsuje RSS do automatycznego tworzenia pinów. Użyj skryptu do skanowania plików HTML, wyodrębniania metadanych i generowania rss.xml.

Utwórz generate-rss.js w folderze scripts:

import fs from 'node:fs/promises';
import path from 'node:path';
import * as cheerio from 'cheerio';

// ================== USTAWIENIA (WPISZ SWOJE) ==================

const BASE_URL = 'https://TWOJA_STRONA.pl';
const ROOT_DIR = path.resolve(process.cwd(), 'dist');
const OUTPUT_RSS_PATH = path.join(ROOT_DIR, 'rss.xml');
const CHANNEL_TITLE = 'Nazwa twojego bloga';
const CHANNEL_DESCRIPTION = 'Opis: artykuły o rozwoju, SEO, projektowaniu';

// ================== DALEJ KODU NIE ZMIENIAJ ==================

function escapeXml(value = '') {
  return value
    .replace(/&/g, '&amp;')
    .replace(/</g, '&lt;')
    .replace(/>/g, '&gt;')
    .replace(/"/g, '&quot;')
    .replace(/'/g, '&apos;');
}

function getMimeTypeByExt(urlOrPath = '') {
  const ext = urlOrPath.split('.').pop()?.toLowerCase();
  switch (ext) {
    case 'jpg': case 'jpeg': return 'image/jpeg';
    case 'png': return 'image/png';
    case 'webp': return 'image/webp';
    case 'gif': return 'image/gif';
    default: return 'image/*';
  }
}

function buildArticleUrl(filePath) {
  const relativePath = path.relative(ROOT_DIR, filePath).replace(/\\/g, '/');
  return `${BASE_URL}/${relativePath}`;
}

function buildImageUrl(src) {
  if (!src) return '';
  if (/^https?:\/\//i.test(src)) return src;
  if (src.startsWith('/')) return `${BASE_URL}${src}`;
  return `${BASE_URL}/${src}`;
}

async function collectHtmlFiles(dir) {
  const entries = await fs.readdir(dir, { withFileTypes: true });
  const files = [];
  for (const entry of entries) {
    const fullPath = path.join(dir, entry.name);
    if (entry.isDirectory()) {
      const nested = await collectHtmlFiles(fullPath);
      files.push(...nested);
    } else if (entry.isFile() && entry.name.endsWith('.html')) {
      files.push(fullPath);
    }
  }
  return files;
}

async function parseArticle(filePath) {
  const content = await fs.readFile(filePath, 'utf8');
  const $ = cheerio.load(content);

  const isArticle = $('meta[name="is_article"]').length > 0;
  if (!isArticle) return null;

  const title = $('h1').first().text().trim() || 'Bez tytułu';
  const pinterestDescription = $('meta[name="pinterest_description"]').attr('content')?.trim() || '';
  const pinterestImg = $('meta[name="pinterest_image"]').attr('content');
  let firstImgSrc = $('img').first().attr('src') || '';
  if (firstImgSrc.endsWith('.svg')) firstImgSrc = '';
  const imageUrl = buildImageUrl(pinterestImg || firstImgSrc);

  let pubDate;
  const articleDateMeta = $('meta[name="article_published_at"]').attr('content');
  if (articleDateMeta) {
    const parsed = new Date(articleDateMeta);
    if (!isNaN(parsed.getTime())) pubDate = parsed;
  }
  if (!pubDate) {
    const stat = await fs.stat(filePath);
    pubDate = stat.mtime;
  }

  return { title, pinterestDescription, url: buildArticleUrl(filePath), imageUrl, pubDate };
}

function buildRssXml(items) {
  const itemsXml = items.map(item => {
    const enclosure = item.imageUrl ? `\n        <enclosure url="${escapeXml(item.imageUrl)}" type="${getMimeTypeByExt(item.imageUrl)}" />` : '';
    return `\n    <item>\n        <title>${escapeXml(item.title)}</title>\n        <link>${escapeXml(item.url)}</link>\n        <description><![CDATA[${item.pinterestDescription}]]></description>\n        <pubDate>${item.pubDate.toUTCString()}</pubDate>${enclosure}\n    </item>`;
  }).join('\n');

  return `<?xml version="1.0" encoding="UTF-8"?>\n<rss version="2.0">\n<channel>\n    <title>${escapeXml(CHANNEL_TITLE)}</title>\n    <link>${escapeXml(BASE_URL)}</link>\n    <description>${escapeXml(CHANNEL_DESCRIPTION)}</description>${itemsXml}\n</channel>\n</rss>`;
}

async function main() {
  console.log('🔍 Wyszukiwanie HTML w:', ROOT_DIR);
  const htmlFiles = await collectHtmlFiles(ROOT_DIR);
  console.log(`📄 Znaleziono HTML: ${htmlFiles.length}`);

  const articles = [];
  for (const filePath of htmlFiles) {
    const article = await parseArticle(filePath);
    if (article) articles.push(article);
  }
  console.log(`📰 Artykułów z is_article: ${articles.length}`);

  if (!articles.length) {
    console.warn('⚠️ Brak artykułów. RSS nie został utworzony.');
    return;
  }

  articles.sort((a, b) => b.pubDate - a.pubDate);
  const rssXml = buildRssXml(articles);
  await fs.writeFile(OUTPUT_RSS_PATH, rssXml, 'utf8');
  console.log(`✅ RSS zapisany: ${OUTPUT_RSS_PATH}`);
}

main().catch(err => {
  console.error('❌ Błąd:', err);
  process.exit(1);
});

Uruchomienie:

Google AdInline article slot
  • npm install cheerio
  • Skonfiguruj BASE_URL, ROOT_DIR, kanał.
  • node generate-rss.js

Skrypt rekurencyjnie skanuje HTML, parsuje Cheerio, ekranuje XML, określa MIME po rozszerzeniu, buduje bezwzględne URL. Sortuje według pubDate.

Podłączenie RSS do Pinterest i automatyzacja

W Pinterest: „Utwórz” → „Rich Pins” → „Kanał RSS” → wstaw https://twoja-strona/rss.xml. Piny generują się w 6–24 godziny.

Proces:

Google AdInline article slot
  • Dodaj artykuł z metatagami.
  • node generate-rss.js.
  • Pinterest parsuje RSS, tworzy piny z <title>, <description>, <enclosure>.

Do pełnej automatyzacji zintegruj w CI/CD (GitHub Actions) lub cron: 0 0 * cd /ścieżka/do/projektu && node scripts/generate-rss.js.

Zalety podejścia:

  • Działa ze stronami statycznymi (Hugo, Eleventy, czysty HTML).
  • Nie wymaga CMS ani wtyczek.
  • Skaluje się na tysiące artykułów.
  • Pinterest buforuje RSS, aktualizacje w czasie rzeczywistym nie są potrzebne.

Co jest ważne

  • Zweryfikuj domenę metatagiem p:domain_verify do indeksacji.
  • Użyj pinterest_image do kontroli wizualnej pinów.
  • Skrypt obsługuje fallback na mtime pliku i pierwsze <img>.
  • RSS zawiera <enclosure> dla obrazów z typami MIME.
  • Automatyzuj przez cron lub CI dla produkcji.

— Editorial Team

Advertisement 728x90

Czytaj dalej