Cài SnapVideo lên iPhone

Tải video, ảnh từ Instagram, TikTok, Facebook, Threads ngay trên iPhone. Không cần server hay Tailscale: iPhone tự lấy link bằng mạng của chính nó.

InstagramTikTokFacebookThreadsv1.1.0

Cài app Scriptable

App miễn phí để chạy JavaScript trên iPhone: Scriptable trên App Store. Cài xong mở app một lần để nó tạo thư mục Scriptable trong iCloud Drive.

Cần bật iCloud Drive (Cài đặt › tên bạn › iCloud › iCloud Drive) để phím tắt tự cài được script. Không dùng iCloud Drive thì làm theo mục "Cài thủ công" ở cuối trang.

Tạo phím tắt SnapVideo

Trong app Phím tắt, bấm +, đặt tên phím tắt là SnapVideo. Bấm ⓘ ở dưới cùng, bật Hiển thị trong Bảng chia sẻ. Rồi thêm các tác vụ theo thứ tự:

Nhận URL, Văn bản từ Bảng chia sẻ
   nếu không có đầu vào → Lấy bảng tạm

── tự cài script lần đầu ──
Lấy tệp từ thư mục
   Thư mục = iCloud Drive › Scriptable
   Đường dẫn = SnapVideo.js
   tắt "Báo lỗi nếu không tìm thấy"
Nếu [Tệp] không có giá trị
   Lấy nội dung của https://snapvideo-ezn.pages.dev/SnapVideo.js
   Đặt tên [Nội dung của URL] thành SnapVideo.js
   Lưu tệp [Mục đã đổi tên]
      tắt "Hỏi nơi lưu"
      Thư mục = iCloud Drive › Scriptable
      bật "Ghi đè nếu tệp tồn tại"
Kết thúc nếu

── tách link ──
Run Script  (Scriptable)
   Script = SnapVideo
   Parameter = Đầu vào phím tắt
   tắt "Run In App"
Đặt biến KetQua = Run Script
Lấy giá trị từ điển "referer" trong KetQua → Đặt biến Referer
Lấy giá trị từ điển "cookie"  trong KetQua → Đặt biến Cookie
Lấy giá trị từ điển "status"  trong KetQua
Văn bản [Giá trị từ điển]

Nếu Văn bản là error
   Lấy giá trị từ điển "error" trong KetQua
   Lấy giá trị từ điển "message" trong [Giá trị từ điển]
   Hiển thị cảnh báo [Giá trị từ điển]
   Dừng phím tắt này
Kết thúc nếu

── tải và lưu ──
Nếu Văn bản là picker
   Lấy giá trị từ điển "picker" trong KetQua
   Lặp lại với từng mục
      Lấy giá trị từ điển "url" trong Lặp lại mục
      URL [Giá trị từ điển]
      Lấy nội dung của [URL]   ← thêm 2 tiêu đề
      Lưu vào album Gần đây
   Kết thúc lặp lại
Nếu không
   Lấy giá trị từ điển "url" trong KetQua
   URL [Giá trị từ điển]
   Lấy nội dung của [URL]      ← thêm 2 tiêu đề
   Lưu vào album Gần đây
Kết thúc nếu
Hiển thị thông báo "Đã lưu vào Ảnh"

Tên tác vụ có thể hơi khác tùy phiên bản iOS. Tìm bằng tiếng Anh nếu cần: Get File from Folder, Set Name, Save File, Get Contents of URL. Ô Thư mục: chạm vào rồi chọn iCloud Drive › Scriptable.

2 tiêu đề cho 2 tác vụ Lấy nội dung của [URL] ở phần tải và lưu: mở Hiển thị thêm, giữ Phương thức: GET, thêm Tiêu đề:

Khóa	Văn bản
`Referer`	biến Referer
`Cookie`	biến Cookie

Bắt buộc với TikTok. Thiếu 2 tiêu đề này thì TikTok trả lỗi 403 và file lưu về bị hỏng.

Chạy thử

Mở một bài Instagram hoặc TikTok, bấm Chia sẻ, chọn phím tắt SnapVideo.
Lần chạy đầu, iPhone hỏi quyền truy cập snapvideo-ezn.pages.dev, thư mục Scriptable và quyền lưu ảnh: chọn Luôn cho phép.
Video/ảnh xuất hiện trong app Ảnh là xong. Từ lần sau phím tắt bỏ qua bước cài.

Script tự cập nhật: tối đa 6 giờ một lần, hoặc ngay khi gặp lỗi, nó lấy bản mới từ trang này. Không cần cài lại.

Chia sẻ cho người khác

Trong app Phím tắt, giữ vào phím tắt SnapVideo › Chia sẻ › Sao chép liên kết iCloud.
Gửi người nhận link đó kèm link trang này. Họ chỉ cần làm bước 1 (cài Scriptable, mở một lần) rồi bấm link iCloud để thêm phím tắt.

Đã có phím tắt cũ?

Đã dán script SnapVideo bản 1.0.x bằng tay: mở Scriptable, giữ vào SnapVideo › Delete. Bản cũ chưa có tự cập nhật, xóa đi để phím tắt cài bản mới.
Phím tắt bản cobalt + Tailscale: xóa Connect, Đợi 2 giây, Disconnect. Thay Lấy nội dung của http://…:9001 bằng khối "tự cài script" và Run Script như bước 2, thêm 2 tiêu đề Referer / Cookie. Ở nhánh error, đổi "code" thành "message".

Cài thủ công (không dùng iCloud Drive)

Mở Scriptable, bấm + ở góc trên bên phải, giữ vào vùng soạn thảo, chọn Dán.
Chạm vào tên Untitled Script ở trên cùng, đổi thành SnapVideo, bấm Done.
Trong phím tắt, bỏ khối "tự cài script lần đầu".

Xem code (17.829 ký tự). Nút sao chép không chạy thì giữ vào ô dưới, Chọn tất cả, Sao chép.

// Variables used by Scriptable.
// These must be at the very top of the file. Do not edit.
// icon-color: deep-blue; icon-glyph: download;

/*
 * SnapVideo - tách link video/ảnh ngay trên iPhone (không cần server)
 * Hỗ trợ: Instagram (reel, bài ảnh, carousel), TikTok (video, bài ảnh), Facebook (video/reel), Threads
 *
 * Cách dùng:
 *  - Từ Phím tắt: action "Run Script" (Scriptable), Script = SnapVideo, Parameter = link.
 *    Kết quả trả về (Từ điển), cùng dạng API cobalt:
 *      { status: "redirect", url, filename, type, referer, cookie }
 *      { status: "picker", picker: [{ type, url, filename }], referer, cookie }
 *      { status: "error", error: { code, message } }
 *    Khi tải file (Lấy nội dung của URL) phải gửi kèm header Referer = referer, Cookie = cookie (TikTok cần).
 *  - Chạy trực tiếp trong app Scriptable: lấy link trong bảng tạm, tải file và mở xem để thử.
 *  - Tự cập nhật: tối đa 6 giờ/lần (hoặc ngay khi lỗi) tải bản mới từ https://snapvideo-ezn.pages.dev/
 */

const VERSION = "1.1.0";

const UA_CHROME = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/138.0.0.0 Safari/537.36";
// TikTok WAF chặn UA giả Chrome, cho qua UA kiểu bot (giống cobalt)
const UA_BOT = "cobalt/11.7.1 (+https://github.com/imputnet/cobalt)";

const PAGE_HEADERS = {
  "User-Agent": UA_CHROME,
  "Accept": "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,*/*;q=0.8",
  "Accept-Language": "en-US,en;q=0.9",
  "Sec-Ch-Ua": '"Chromium";v="138", "Google Chrome";v="138", "Not-A.Brand";v="99"',
  "Sec-Ch-Ua-Mobile": "?0",
  "Sec-Ch-Ua-Platform": '"Windows"',
  "Sec-Fetch-Dest": "document",
  "Sec-Fetch-Mode": "navigate",
  "Sec-Fetch-Site": "none",
  "Sec-Fetch-User": "?1",
  "Upgrade-Insecure-Requests": "1",
};

const IG_EXTRA = { referer: "https://www.instagram.com/" };
const THREADS_EXTRA = { referer: "https://www.threads.com/" };
const FB_EXTRA = { referer: "https://www.facebook.com/" };

class SnapError extends Error {
  constructor(code, message) { super(message || code); this.code = code; }
}

// Scriptable (JavaScriptCore) KHÔNG có lớp URL -> tự tách link
function parseUrl(input, base) {
  let s = String(input || "").trim();
  if (base && !/^[a-z][a-z0-9+.-]*:\/\//i.test(s)) {
    const b = parseUrl(base);
    s = s.startsWith("//") ? b.protocol + s : s.startsWith("/") ? b.origin + s : b.origin + "/" + s;
  }
  const m = s.match(/^([a-z][a-z0-9+.-]*:)\/\/([^/?#]*)([^?#]*)(\?[^#]*)?(#.*)?$/i);
  if (!m) throw new SnapError("link.invalid", "Link không hợp lệ.");
  const protocol = m[1].toLowerCase();
  const hostname = m[2].replace(/^[^@]*@/, "").replace(/:\d+$/, "").toLowerCase();
  return { protocol, hostname, origin: protocol + "//" + hostname, pathname: m[3] || "/", search: m[4] || "", href: s };
}

// ---------------------------------------------------------------- HTTP

function header(headers, name) {
  if (!headers) return undefined;
  const key = Object.keys(headers).find(k => k.toLowerCase() === name.toLowerCase());
  return key ? headers[key] : undefined;
}

// follow = false -> không đi theo redirect, trả về location
async function http(url, { headers = {}, follow = true, timeout = 25 } = {}) {
  const req = new Request(url);
  req.headers = headers;
  req.timeoutInterval = timeout;
  let location;
  if (!follow) {
    req.onRedirect = (next) => { location = next.url; return null; };
  }
  let body = "";
  try {
    body = await req.loadString();
  } catch (e) {
    if (!location) throw new SnapError("fetch.fail", `Không kết nối được: ${String(e).slice(0, 120)}`);
  }
  const res = req.response || {};
  if (!location) location = header(res.headers, "location");
  const cookies = (res.cookies || []).filter(c => c && c.name).map(c => `${c.name}=${c.value}`);
  return { status: res.statusCode, url: res.url || url, body: body || "", location, cookies, headers: res.headers || {} };
}

// ---------------------------------------------------------------- tiện ích

function findMediaInHtml(html, code) {
  const re = /<script type="application\/json"[^>]*>([\s\S]*?)<\/script>/g;
  let m;
  while ((m = re.exec(html))) {
    if (!m[1].includes(`"code":"${code}"`)) continue;
    let json;
    try { json = JSON.parse(m[1]); } catch { continue; }
    const stack = [json];
    while (stack.length) {
      const o = stack.pop();
      if (!o || typeof o !== "object") continue;
      if (o.code === code && (o.image_versions2 || o.carousel_media || o.video_versions)) return o;
      for (const v of Object.values(o)) if (v && typeof v === "object") stack.push(v);
    }
  }
}

function bestVideo(list) {
  if (!list?.length) return;
  return list.reduce((a, b) => ((b.width || 0) * (b.height || 0) > (a.width || 0) * (a.height || 0) ? b : a)).url;
}

// object media dạng API mobile (Instagram / Threads)
function fromMediaObject(media, prefix, id, extra) {
  const items = [];
  const one = (o) => {
    const v = bestVideo(o.video_versions);
    if (v) return { type: "video", url: v };
    const img = o.image_versions2?.candidates?.[0]?.url;
    if (img) return { type: "photo", url: img };
  };
  if (media.carousel_media?.length) {
    media.carousel_media.forEach(c => { const it = one(c); if (it) items.push(it); });
  } else {
    const it = one(media);
    if (it) items.push(it);
  }
  return finish(items, `${prefix}_${id}`, extra);
}

function finish(items, base, extra = {}) {
  if (!items.length) throw new SnapError("fetch.empty", "Không tìm thấy video/ảnh trong bài viết.");
  items.forEach((it, i) => {
    const ext = it.type === "video" ? "mp4" : "jpg";
    it.filename = items.length > 1 ? `${base}_${i + 1}.${ext}` : `${base}.${ext}`;
  });
  const common = { referer: extra.referer || "", cookie: extra.cookie || "" };
  if (items.length === 1) {
    return { status: "redirect", url: items[0].url, filename: items[0].filename, type: items[0].type, ...common };
  }
  return { status: "picker", picker: items, ...common };
}

// ---------------------------------------------------------------- Instagram

async function instagram(url) {
  const u = parseUrl(url);
  let parts = u.pathname.split("/").filter(Boolean);

  if (parts[0] === "share") {
    const r = await http(`https://www.instagram.com${u.pathname.replace(/\/?$/, "/")}`, { headers: { "User-Agent": "curl/7.88.1" }, follow: false });
    if (!r.location) throw new SnapError("fetch.short_link", "Không mở được link chia sẻ Instagram.");
    parts = parseUrl(r.location, "https://www.instagram.com").pathname.split("/").filter(Boolean);
  }
  if (parts[0] === "stories") throw new SnapError("content.unsupported", "Story cần đăng nhập, chưa hỗ trợ.");

  const idx = parts.findIndex(p => ["p", "reel", "reels", "tv"].includes(p));
  const id = idx >= 0 ? parts[idx + 1] : undefined;
  if (!id) throw new SnapError("link.unsupported", "Link Instagram không phải bài viết/reel.");

  // 1) trang /p/<id>/ có nhúng sẵn object media
  const page = await http(`https://www.instagram.com/p/${id}/`, { headers: PAGE_HEADERS });
  const media = findMediaInHtml(page.body, id);
  if (media) return fromMediaObject(media, "instagram", id, IG_EXTRA);

  // 2) trang embed: contextJSON (reel, carousel)
  const embed = await http(`https://www.instagram.com/p/${id}/embed/captioned/`, { headers: PAGE_HEADERS });
  let ctx;
  try {
    const init = JSON.parse(embed.body.match(/"init",\[\],\[(.*?)\]\],/)[1]);
    if (init.contextJSON) ctx = JSON.parse(init.contextJSON);
  } catch {}
  const sm = ctx?.gql_data?.shortcode_media || ctx?.gql_data?.xdt_shortcode_media;
  if (sm) {
    const items = [];
    const edges = sm.edge_sidecar_to_children?.edges;
    if (edges?.length) {
      edges.forEach(e => {
        const n = e.node || {};
        if (n.is_video && n.video_url) items.push({ type: "video", url: n.video_url });
        else if (n.display_url) items.push({ type: "photo", url: n.display_url });
      });
    } else if (sm.video_url) items.push({ type: "video", url: sm.video_url });
    else if (sm.display_url) items.push({ type: "photo", url: sm.display_url });
    if (items.length) return finish(items, `instagram_${id}`, IG_EXTRA);
  }

  // 3) bài 1 ảnh: thẻ <img class="EmbeddedMediaImage">
  const tag = embed.body.match(/<img[^>]*class="EmbeddedMediaImage"[^>]*>/)?.[0];
  if (tag) {
    const decode = s => s.replace(/&amp;/g, "&");
    let img;
    const srcset = tag.match(/srcset="([^"]+)"/)?.[1];
    if (srcset) {
      img = decode(srcset).split(/,\s*(?=https:)/)
        .map(s => s.trim().split(/\s+/))
        .map(([src, w]) => ({ src, w: parseInt(w) || 0 }))
        .filter(e => e.src?.startsWith("https://"))
        .sort((a, b) => b.w - a.w)[0]?.src;
    }
    if (!img) img = decode(tag.match(/src="([^"]+)"/)?.[1] || "");
    if (img.startsWith("https://")) return finish([{ type: "photo", url: img }], `instagram_${id}`, IG_EXTRA);
  }

  if (/"is_private":true|login_required|LoginAndSignupPage/i.test(page.body))
    throw new SnapError("content.post.private", "Bài riêng tư hoặc cần đăng nhập.");
  throw new SnapError("fetch.empty", "Instagram không trả dữ liệu bài này (có thể riêng tư hoặc bị hạn chế).");
}

// ---------------------------------------------------------------- Threads

async function threads(url) {
  const u = parseUrl(url);
  const parts = u.pathname.split("/").filter(Boolean);
  let user, id;

  if (parts[0] === "share" || parts[0] === "t") {
    const r = await http(`https://www.threads.com/${parts[0]}/${parts[1]}${parts[0] === "share" ? "/" : ""}`, { headers: { "User-Agent": "curl/7.88.1" }, follow: false });
    const m = r.location?.match(/\/@([^/?#]+)\/post\/([A-Za-z0-9_-]+)/);
    if (!m) throw new SnapError("fetch.short_link", "Không mở được link chia sẻ Threads.");
    [, user, id] = m;
  } else if (parts[0]?.startsWith("@") && parts[1] === "post") {
    user = parts[0].slice(1);
    id = parts[2];
  }
  if (!id) throw new SnapError("link.unsupported", "Link Threads không phải bài viết.");

  const page = await http(`https://www.threads.com/@${user}/post/${id}`, { headers: PAGE_HEADERS });
  const media = findMediaInHtml(page.body, id);
  if (!media) throw new SnapError("fetch.empty", "Threads không trả dữ liệu bài này (hoặc bài chỉ có chữ).");
  return fromMediaObject(media, "threads", id, THREADS_EXTRA);
}

// ---------------------------------------------------------------- TikTok

async function tiktok(url) {
  let target = url;
  const host = parseUrl(url).hostname;
  if (host.startsWith("vt.") || host.startsWith("vm.") || /\/t\//.test(parseUrl(url).pathname)) {
    const r = await http(url, { headers: { "User-Agent": UA_BOT }, follow: false });
    target = r.location || r.body.split('<a href="')[1]?.split('"')[0];
    if (!target) throw new SnapError("fetch.short_link", "Không mở được link rút gọn TikTok.");
  }
  const id = target.match(/\/(?:video|photo|v)\/(\d+)/)?.[1];
  if (!id) throw new SnapError("link.unsupported", "Link TikTok không phải video/bài ảnh.");

  // luôn dùng /video/ kể cả bài ảnh
  const page = await http(`https://www.tiktok.com/@i/video/${id}`, { headers: { "User-Agent": UA_BOT } });
  let detail;
  try {
    const json = page.body.split('<script id="__UNIVERSAL_DATA_FOR_REHYDRATION__" type="application/json">')[1].split("</script>")[0];
    const vd = JSON.parse(json).__DEFAULT_SCOPE__["webapp.video-detail"];
    if (vd?.statusMsg) throw new SnapError("content.post.unavailable", "Video đã bị xoá hoặc không xem được.");
    detail = vd?.itemInfo?.itemStruct;
  } catch (e) {
    if (e instanceof SnapError) throw e;
    throw new SnapError("fetch.fail", "TikTok không trả dữ liệu (có thể bị chặn tạm thời).");
  }
  if (!detail?.author) throw new SnapError("fetch.empty", "Không có dữ liệu video.");
  if (detail.isContentClassified) throw new SnapError("content.post.age", "Video giới hạn độ tuổi, cần đăng nhập.");

  const extra = { referer: "https://www.tiktok.com/", cookie: page.cookies.join("; ") };
  const base = `tiktok_${detail.author.uniqueId}_${id}`;

  const images = detail.imagePost?.images;
  if (images?.length) {
    const items = images
      .map(i => i.imageURL?.urlList?.find(p => p.includes(".jpeg?")) || i.imageURL?.urlList?.[0])
      .filter(Boolean)
      .map(u => ({ type: "photo", url: u }));
    return finish(items, base, extra);
  }
  const play = detail.video?.playAddr || detail.video?.downloadAddr;
  if (!play) throw new SnapError("fetch.empty", "Video quảng cáo / TikTok Shop: TikTok không cho tải khi chưa đăng nhập.");
  return finish([{ type: "video", url: play }], base, extra);
}

// ---------------------------------------------------------------- Facebook

async function facebook(url) {
  const html = (await http(url, { headers: PAGE_HEADERS })).body;
  const pick = (key) => {
    const m = html.match(new RegExp(`"${key}":("(?:[^"\\\\]|\\\\.)*")`));
    try { return m ? JSON.parse(m[1]) : undefined; } catch {}
  };
  const video = pick("browser_native_hd_url") || pick("browser_native_sd_url");
  if (!video) throw new SnapError("fetch.empty", "Facebook không trả video (bài riêng tư, không phải video, hoặc cần đăng nhập).");
  const id = url.match(/\/(?:reel|videos|r|v)\/([A-Za-z0-9._-]+)/)?.[1] || url.match(/[?&]v=(\d+)/)?.[1] || "video";
  return finish([{ type: "video", url: video }], `facebook_${id}`, FB_EXTRA);
}

// ---------------------------------------------------------------- điều phối

function pickService(url) {
  const h = parseUrl(url).hostname.replace(/^www\.|^m\./, "");
  if (/(^|\.)instagram\.com$|(^|\.)ddinstagram\.com$/.test(h)) return instagram;
  if (/(^|\.)threads\.(com|net)$/.test(h)) return threads;
  if (/(^|\.)tiktok\.com$/.test(h)) return tiktok;
  if (/(^|\.)facebook\.com$|^fb\.watch$/.test(h)) return facebook;
}

async function extract(input) {
  const url = String(input || "").match(/https?:\/\/[^\s"'<>]+/)?.[0];
  if (!url) throw new SnapError("link.missing", "Không thấy link trong đầu vào.");
  const service = pickService(url);
  if (!service) throw new SnapError("link.invalid", "Chỉ hỗ trợ Instagram, TikTok, Facebook, Threads.");
  return service(url);
}

function readInput() {
  const p = args.shortcutParameter;
  const flat = (v) => Array.isArray(v) ? v.map(flat).join(" ") : (v && typeof v === "object" ? JSON.stringify(v) : String(v ?? ""));
  if (p !== undefined && p !== null && flat(p).trim()) return flat(p);
  if (args.urls?.length) return args.urls.join(" ");
  if (args.plainTexts?.length) return args.plainTexts.join(" ");
  return Pasteboard.paste() || "";
}

// ---------------------------------------------------------------- chạy thử trong app

async function previewInApp(result) {
  const items = result.status === "picker" ? result.picker : [result];
  const a = new Alert();
  a.title = `SnapVideo ${VERSION}`;
  a.message = `${items.length} file: ${items.map(i => i.type).join(", ")}\n${items[0].filename}`;
  a.addAction("Tải & xem file đầu tiên");
  a.addCancelAction("Đóng");
  if ((await a.presentAlert()) !== 0) return;
  const req = new Request(items[0].url);
  req.headers = { "Referer": result.referer || "", "Cookie": result.cookie || "", "User-Agent": UA_BOT };
  const data = await req.load();
  const fm = FileManager.local();
  const path = fm.joinPath(fm.temporaryDirectory(), items[0].filename);
  fm.write(path, data);
  await QuickLook.present(path, true);
}

// ---------------------------------------------------------------- tự cập nhật

const UPDATE_BASE = "https://snapvideo-ezn.pages.dev/";
const UPDATE_EVERY_MS = 6 * 60 * 60 * 1000; // tối đa 6 giờ kiểm tra 1 lần
const UPDATE_KEY = "snapvideo.lastUpdateCheck";

function newerVersion(a, b) {
  const pa = String(a).split(".").map(Number), pb = String(b).split(".").map(Number);
  for (let i = 0; i < Math.max(pa.length, pb.length); i++) {
    const x = pa[i] || 0, y = pb[i] || 0;
    if (x !== y) return x > y;
  }
  return false;
}

// Tải bản mới từ trang cài đặt và ghi đè chính file script. Bản mới có hiệu lực từ lần chạy sau.
async function selfUpdate(force = false) {
  try {
    const now = Date.now();
    const last = Keychain.contains(UPDATE_KEY) ? Number(Keychain.get(UPDATE_KEY)) : 0;
    if (!force && now - last < UPDATE_EVERY_MS) return;
    Keychain.set(UPDATE_KEY, String(now));

    const vReq = new Request(`${UPDATE_BASE}version.json?t=${now}`);
    vReq.timeoutInterval = 6;
    const latest = (await vReq.loadJSON())?.version;
    if (!latest || !newerVersion(latest, VERSION)) return;

    const cReq = new Request(`${UPDATE_BASE}SnapVideo.js?t=${now}`);
    cReq.timeoutInterval = 10;
    const code = await cReq.loadString();
    if (!code.includes(`const VERSION = "${latest}"`) || !code.includes("async function main()")) return;

    const path = module.filename;
    const fm = path.includes("/Mobile Documents/") ? FileManager.iCloud() : FileManager.local();
    fm.writeString(path, code);
    return latest;
  } catch {}
}

async function main() {
  let result;
  try {
    result = await extract(readInput());
  } catch (e) {
    result = { status: "error", error: { code: `error.snap.${e.code || "unknown"}`, message: e.message || String(e) } };
  }
  // lỗi tách link có thể do Instagram/TikTok đổi cấu trúc -> kiểm tra bản mới ngay
  const updated = await selfUpdate(result.status === "error");
  if (updated && result.status === "error") {
    result.error.message += ` Đã tự cập nhật SnapVideo lên ${updated}, hãy chạy lại.`;
  }
  if (config.runsInApp) {
    if (result.status === "error") {
      const a = new Alert();
      a.title = "Lỗi SnapVideo";
      a.message = `${result.error.message}\n(${result.error.code})`;
      a.addAction("OK");
      await a.presentAlert();
    } else {
      await previewInApp(result);
    }
  }
  Script.setShortcutOutput(result);
  Script.complete();
  return result;
}

await main();

Lỗi thường gặp

Thấy gì	Làm gì
Run Script báo không tìm thấy script SnapVideo	Mở app Scriptable một lần để nó nhận file mới. Vào app Tệp › iCloud Drive › Scriptable: tên file phải đúng `SnapVideo.js` (không phải `SnapVideo.js.txt`).
Không thấy link trong đầu vào	Bảng tạm trống: copy link rồi chạy lại, cho phép dán.
Video quảng cáo / TikTok Shop	TikTok không cho tải khi chưa đăng nhập. Dùng nút Lưu của TikTok hoặc quay màn hình.
Instagram không trả dữ liệu bài này	Bài riêng tư, story hoặc bị hạn chế. Bài công khai mà vẫn lỗi thì thử lại sau ít phút hoặc đổi Wi-Fi/4G.
File TikTok lưu về không mở được	Thiếu tiêu đề Referer / Cookie ở bước 2.
Báo "Đã tự cập nhật SnapVideo…, hãy chạy lại"	Script vừa tải bản sửa lỗi. Chạy lại phím tắt.