Exportar tus guardados de X (Twitter) a CSV o Markdown

// Responsive Muse · X (Twitter) Bookmarks Exporter · v1.1 · 2026-10-22
// Saves all your X bookmarks to CSV, Markdown or TXT: date, author, @handle, text and link.
// Also works on your Likes tab. Runs only on x.com/i/history (X's new home for bookmarks and
// likes; the old x.com/i/bookmarks redirects there). X only keeps on screen the posts you can
// see, so the script collects them while it scrolls. It makes no network requests of its own
// and never reads cookies, passwords or tokens.
(async () => {
  const TOOL = 'Exportar guardados de X';
  const FORMAT = 'csv';        // 'csv' (Excel, Sheets), 'md' (Notion, Obsidian) or 'txt' (links only)
  const DELAY = 1200;          // pause between scrolls, in milliseconds

  if (!/^(x|twitter)\.com$/.test(location.hostname) || !/^\/i\/(history|bookmarks)/.test(location.pathname)) {
    alert('Abre primero tus guardados (con tu sesión iniciada):\nhttps://x.com/i/bookmarks');
    return;
  }
  // A small box on the page shows progress and asks before changing anything,
  // so you never need to read or edit the console.
  const many = (n, word) => `${n} ${n === 1 ? word : ({ canal: 'canales', 'canción': 'canciones', 'publicación': 'publicaciones', 'elemento guardado': 'elementos guardados' })[word] || word + 's'}`;   // 1 vídeo, 2 vídeos
  const panel = (() => {
    const box = document.createElement('div');
    box.style.cssText = 'position:fixed;right:16px;bottom:16px;z-index:2147483647;width:340px;max-width:calc(100vw - 32px);' +
      'background:#111318;color:#e6e8ee;font:14px/1.5 system-ui,sans-serif;border-radius:12px;padding:16px;' +
      'box-shadow:0 8px 30px rgba(0,0,0,.4);text-align:left';
    const head = document.createElement('strong');
    head.textContent = TOOL;
    const msg = document.createElement('p');
    msg.style.cssText = 'margin:8px 0 12px;white-space:pre-line';
    const row = document.createElement('div');
    row.style.cssText = 'display:flex;flex-wrap:wrap;gap:8px;justify-content:flex-end';
    box.append(head, msg, row);
    document.body.append(box);
    const button = (label, primary, onClick) => {
      const b = document.createElement('button');
      b.textContent = label;
      b.style.cssText = 'font:600 14px system-ui,sans-serif;padding:8px 14px;border-radius:8px;cursor:pointer;' +
        (primary ? 'background:#0f766e;color:#fff;border:1px solid #0f766e' : 'background:none;color:#e6e8ee;border:1px solid #3a3f4b');
      b.onclick = onClick;
      row.append(b);
    };
    return {
      text(t) { msg.textContent = t; },
      ask(t, yes) {
        msg.textContent = t;
        row.replaceChildren();
        return new Promise(r => {
          button('Cancelar', false, () => { row.replaceChildren(); r(false); });
          button(yes, true, () => { row.replaceChildren(); r(true); });
        });
      },
      stoppable(onStop) { row.replaceChildren(); button('Parar', false, onStop); },
      actions(t, list) {
        msg.textContent = t;
        row.replaceChildren();
        list.forEach(([label, primary, run]) => button(label, primary, run));
      },
      finish(t) { this.actions(t, [['Cerrar', true, () => box.remove()]]); },
      close() { box.remove(); },
    };
  })();
  // Offer the result as a downloaded file or as clipboard text (a real click, so it always works)
  const deliver = (summary, body, file) => {
    const save = () => {
      const a = document.createElement('a');
      a.href = URL.createObjectURL(new Blob([/\.csv$/.test(file) ? '\ufeff' + body : body], { type: 'text/plain;charset=utf-8' }));
      a.download = file;
      a.click();
      setTimeout(() => URL.revokeObjectURL(a.href), 5000);
      panel.text(`${summary}\nGuardado como ${file} (mira tu carpeta de Descargas).`);
    };
    const copy = () => navigator.clipboard.writeText(body)
      .then(() => panel.text(`${summary}\nCopiado. Pégalo en una hoja de cálculo o en una nota.`))
      .catch(() => panel.text(`${summary}\nEl navegador ha bloqueado el portapapeles: usa Descargar.`));
    panel.actions(summary, [['Cerrar', false, () => panel.close()], ['Copiar', false, copy], ['Descargar', true, save]]);
  };
  const sleep = ms => new Promise(r => setTimeout(r, ms));
  const posts = new Map();

  // Read the posts currently on screen
  const collect = () => {
    for (const art of document.querySelectorAll('article[data-testid="tweet"]')) {
      const time = art.querySelector('a[href*="/status/"] time');
      const link = time?.closest('a')?.getAttribute('href') || '';
      const id = (link.match(/\/status\/(\d+)/) || [])[1];
      if (!id || posts.has(id)) continue;
      const names = [...art.querySelectorAll('[data-testid="User-Name"] span')].map(s => s.textContent.trim()).filter(Boolean);
      posts.set(id, {
        date: time.getAttribute('datetime') || '',
        author: names[0] || '',
        handle: names.find(n => n.startsWith('@')) || '@' + link.split('/')[1],
        text: (art.querySelector('[data-testid="tweetText"]')?.innerText || '').replace(/\s+\n/g, '\n').trim(),
        media: art.querySelectorAll('[data-testid="tweetPhoto"], [data-testid="videoPlayer"]').length,
        url: 'https://x.com' + link.replace(/\/(analytics|photo|video).*$/, ''),
      });
    }
  };

  // 1. Scroll to the end, collecting as we go, until nothing new appears four times in a row
  let stop = false;
  panel.stoppable(() => { stop = true; });
  window.scrollTo(0, 0);
  await sleep(DELAY);
  let idle = 0;
  while (idle < 4 && !stop) {
    const before = posts.size;
    collect();
    window.scrollBy(0, window.innerHeight * 0.8);
    await sleep(DELAY);
    idle = posts.size === before ? idle + 1 : 0;
    panel.text(`Recogiendo publicaciones… ${posts.size}`);
  }
  const list = [...posts.values()];
  if (!list.length) {
    panel.finish('No se han encontrado publicaciones. Puede que X haya cambiado su diseño: avísanos en responsive-muse.com.');
    return 0;
  }

  // 2. Build the file and offer it
  const cell = v => '"' + String(v).replace(/"/g, '""') + '"';
  const body = FORMAT === 'txt' ? list.map(p => p.url).join('\n')
    : FORMAT === 'md' ? list.map(p => `- **${p.author}** (${p.handle}) · ${p.date.slice(0, 10)} · [enlace](${p.url})\n  ${p.text.replace(/\n/g, '\n  ')}`).join('\n')
    : ['Fecha,Autor,Usuario,Texto,Multimedia,URL',
       ...list.map(p => [p.date, p.author, p.handle, p.text, p.media, p.url].map(cell).join(','))].join('\n');
  const kind = /likes/.test(location.pathname) ? 'likes' : 'bookmarks';
  deliver(`${stop ? 'Parado antes de terminar. ' : ''}Listo: ${many(list.length, 'publicación')}.`, body, `x-${kind}.${FORMAT}`);
  return list.length;
})();