publishport-opencli 1.0.0

package/clis/instagram/_shared/protocol-capture.js

@@ -0,0 +1,180 @@
+import*as U from"node:fs";import{resolveInstagramRuntimeInfo as W}from"./runtime-info.js";const L="__opencli_ig_protocol_capture",M="__opencli_ig_protocol_capture_errors",X="/tmp/instagram_post_protocol_trace.json",Y=["/rupload_igphoto/","/rupload_igvideo/","/api/v1/","/media/configure/","/media/configure_sidecar/","/media/configure_to_story/","/api/graphql/"].join("|");export function buildInstallInstagramProtocolCaptureJs(v=L,j=M){return`
+    (() => {
+      const CAPTURE_VAR = ${JSON.stringify(v)};
+      const CAPTURE_ERRORS_VAR = ${JSON.stringify(j)};
+      const PATCH_GUARD = CAPTURE_VAR + '_patched';
+      const FILTERS = [
+        '/rupload_igphoto/',
+        '/rupload_igvideo/',
+        '/api/v1/',
+        '/media/configure/',
+        '/media/configure_sidecar/',
+        '/media/configure_to_story/',
+        '/api/graphql/',
+      ];
+
+      const shouldCapture = (url) => {
+        const value = String(url || '');
+        return FILTERS.some((filter) => value.includes(filter));
+      };
+
+      const normalizeHeaders = (headersLike) => {
+        const out = {};
+        try {
+          if (!headersLike) return out;
+          if (headersLike instanceof Headers) {
+            headersLike.forEach((value, key) => { out[key] = value; });
+            return out;
+          }
+          if (Array.isArray(headersLike)) {
+            for (const pair of headersLike) {
+              if (Array.isArray(pair) && pair.length >= 2) out[String(pair[0])] = String(pair[1]);
+            }
+            return out;
+          }
+          if (typeof headersLike === 'object') {
+            for (const [key, value] of Object.entries(headersLike)) out[key] = String(value);
+          }
+        } catch {}
+        return out;
+      };
+
+      const summarizeBody = async (body) => {
+        if (body == null) return { kind: 'empty', preview: '' };
+        try {
+          if (typeof body === 'string') {
+            return { kind: 'string', preview: body.slice(0, 1000) };
+          }
+          if (body instanceof URLSearchParams) {
+            return { kind: 'urlencoded', preview: body.toString().slice(0, 1000) };
+          }
+          if (body instanceof FormData) {
+            const parts = [];
+            for (const [key, value] of body.entries()) {
+              if (value instanceof File) {
+                parts.push(key + '=File(' + value.name + ',' + value.type + ',' + value.size + ')');
+              } else {
+                parts.push(key + '=' + String(value));
+              }
+            }
+            return { kind: 'formdata', preview: parts.join('&').slice(0, 2000) };
+          }
+          if (body instanceof Blob) {
+            return { kind: 'blob', preview: 'Blob(' + body.type + ',' + body.size + ')' };
+          }
+          if (body instanceof ArrayBuffer) {
+            return { kind: 'arraybuffer', preview: 'ArrayBuffer(' + body.byteLength + ')' };
+          }
+          if (ArrayBuffer.isView(body)) {
+            return { kind: 'typed-array', preview: body.constructor.name + '(' + body.byteLength + ')' };
+          }
+          return { kind: typeof body, preview: String(body).slice(0, 1000) };
+        } catch (error) {
+          return { kind: 'unknown', preview: 'body-preview-error:' + String(error) };
+        }
+      };
+
+      const capture = async (kind, url, method, headers, body, response) => {
+        if (!shouldCapture(url)) return;
+        try {
+          const bodyInfo = await summarizeBody(body);
+          const contentType = response?.headers?.get?.('content-type') || '';
+          let responsePreview = '';
+          try {
+            if (response && typeof response.clone === 'function') {
+              const clone = response.clone();
+              responsePreview = (await clone.text()).slice(0, 4000);
+            }
+          } catch (error) {
+            responsePreview = 'response-preview-error:' + String(error);
+          }
+          window[CAPTURE_VAR].push({
+            kind,
+            url: String(url || ''),
+            method: String(method || 'GET').toUpperCase(),
+            requestHeaders: normalizeHeaders(headers),
+            requestBodyKind: bodyInfo.kind,
+            requestBodyPreview: bodyInfo.preview,
+            responseStatus: response?.status,
+            responseContentType: contentType,
+            responsePreview,
+            timestamp: Date.now(),
+          });
+        } catch (error) {
+          window[CAPTURE_ERRORS_VAR].push(String(error));
+        }
+      };
+
+      if (!Array.isArray(window[CAPTURE_VAR])) window[CAPTURE_VAR] = [];
+      if (!Array.isArray(window[CAPTURE_ERRORS_VAR])) window[CAPTURE_ERRORS_VAR] = [];
+      if (window[PATCH_GUARD]) return { ok: true };
+
+      const origFetch = window.fetch;
+      window.fetch = async function(...args) {
+        const input = args[0];
+        const init = args[1] || {};
+        const url = typeof input === 'string'
+          ? input
+          : input instanceof Request
+            ? input.url
+            : String(input || '');
+        const method = init.method || (input instanceof Request ? input.method : 'GET');
+        const headers = init.headers || (input instanceof Request ? input.headers : undefined);
+        const body = init.body || (input instanceof Request ? input.body : undefined);
+        const response = await origFetch.apply(this, args);
+        capture('fetch', url, method, headers, body, response);
+        return response;
+      };
+
+      const origOpen = XMLHttpRequest.prototype.open;
+      const origSend = XMLHttpRequest.prototype.send;
+      const origSetRequestHeader = XMLHttpRequest.prototype.setRequestHeader;
+
+      XMLHttpRequest.prototype.open = function(method, url) {
+        this.__opencli_method = method;
+        this.__opencli_url = url;
+        this.__opencli_headers = {};
+        return origOpen.apply(this, arguments);
+      };
+      XMLHttpRequest.prototype.setRequestHeader = function(name, value) {
+        try {
+          this.__opencli_headers = this.__opencli_headers || {};
+          this.__opencli_headers[String(name)] = String(value);
+        } catch {}
+        return origSetRequestHeader.apply(this, arguments);
+      };
+      XMLHttpRequest.prototype.send = function(body) {
+        this.addEventListener('load', () => {
+          if (!shouldCapture(this.__opencli_url)) return;
+          try {
+            window[CAPTURE_VAR].push({
+              kind: 'xhr',
+              url: String(this.__opencli_url || ''),
+              method: String(this.__opencli_method || 'GET').toUpperCase(),
+              requestHeaders: this.__opencli_headers || {},
+              requestBodyKind: body == null ? 'empty' : (body instanceof FormData ? 'formdata' : typeof body),
+              requestBodyPreview: body == null ? '' : (body instanceof FormData ? '[formdata]' : String(body).slice(0, 2000)),
+              responseStatus: this.status,
+              responseContentType: this.getResponseHeader('content-type') || '',
+              responsePreview: String(this.responseText || '').slice(0, 4000),
+              timestamp: Date.now(),
+            });
+          } catch (error) {
+            window[CAPTURE_ERRORS_VAR].push(String(error));
+          }
+        });
+        return origSend.apply(this, arguments);
+      };
+
+      window[PATCH_GUARD] = true;
+      return { ok: true };
+    })()
+  `}export function buildReadInstagramProtocolCaptureJs(v=L,j=M){return`
+    (() => {
+      const data = Array.isArray(window[${JSON.stringify(v)}]) ? window[${JSON.stringify(v)}] : [];
+      const errors = Array.isArray(window[${JSON.stringify(j)}]) ? window[${JSON.stringify(j)}] : [];
+      window[${JSON.stringify(v)}] = [];
+      window[${JSON.stringify(j)}] = [];
+      return { data, errors };
+    })()
+  `}export async function installInstagramProtocolCapture(v){if(typeof v.startNetworkCapture==="function")try{await v.startNetworkCapture(Y);return}catch(j){const w=j instanceof Error?j.message:String(j);if(!w.includes("Unknown action")&&!w.includes("network-capture"))throw j}await v.evaluate(buildInstallInstagramProtocolCaptureJs())}export async function readInstagramProtocolCapture(v){if(typeof v.readNetworkCapture==="function")try{const w=await v.readNetworkCapture();return{data:Array.isArray(w)?w:[],errors:[]}}catch(w){const z=w instanceof Error?w.message:String(w);if(!z.includes("Unknown action")&&!z.includes("network-capture"))throw w}const j=await v.evaluate(buildReadInstagramProtocolCaptureJs());return{data:Array.isArray(j?.data)?j.data:[],errors:Array.isArray(j?.errors)?j.errors:[]}}export async function dumpInstagramProtocolCaptureIfEnabled(v){if(process.env.OPENCLI_INSTAGRAM_CAPTURE!=="1")return;const j=await readInstagramProtocolCapture(v);U.writeFileSync(X,JSON.stringify(j,null,2))}function Z(v){return v.filter((j)=>j?.name&&j?.value).map((j)=>`${j.name}=${j.value}`).join("; ")}export async function instagramPrivateApiFetch(v,j,w={}){const z=String(j),[N,O]=await Promise.all([v.getCookies({url:z}),v.getCookies({domain:"instagram.com"})]),B=new Map;for(const x of O)B.set(x.name,x);for(const x of N)B.set(x.name,x);const D=Z(Array.from(B.values())),Q=B.get("csrftoken")?.value||"",F=w.headers??{},G=Object.entries(F).find(([x])=>x.toLowerCase()==="x-ig-app-id")?.[1]||"",R=G?null:await W(v),K=G||R?.appId||"",S=Object.keys(w.headers??{}).some((x)=>x.toLowerCase()==="content-type");return fetch(z,{method:w.method??"GET",headers:{Accept:"application/json, text/plain, */*","X-CSRFToken":Q,"X-Requested-With":"XMLHttpRequest",Origin:"https://www.instagram.com",Referer:"https://www.instagram.com/",...K?{"X-IG-App-ID":K}:{},...D?{Cookie:D}:{},...typeof w.body==="string"&&!S?{"Content-Type":"application/x-www-form-urlencoded; charset=UTF-8"}:{},...F},...w.body!==void 0?{body:w.body}:{}})}

package/clis/instagram/_shared/runtime-info.js

@@ -0,0 +1,33 @@
+function o(t,n){for(const a of n){const e=t.match(a);if(!e)continue;for(let r=1;r<e.length;r+=1)if(e[r])return e[r];return e[0]||""}return""}export function extractInstagramRuntimeInfo(t){return{appId:o(t,[/"X-IG-App-ID":"(\d+)"/,/"appId":"(\d+)"/,/"app_id":"(\d+)"/,/"instagramWebAppId":"(\d+)"/]),csrfToken:o(t,[/"csrf_token":"([^"]+)"/,/"csrfToken":"([^"]+)"/]),instagramAjax:o(t,[/"rollout_hash":"([^"]+)"/,/"X-Instagram-AJAX":"([^"]+)"/,/"Instagram-AJAX":"([^"]+)"/])}}export function buildReadInstagramRuntimeInfoJs(){return`
+    (() => {
+      const html = document.documentElement?.outerHTML || '';
+      const pick = (patterns) => {
+        for (const pattern of patterns) {
+          const match = html.match(new RegExp(pattern, 'i'));
+          if (!match) continue;
+          for (let index = 1; index < match.length; index += 1) {
+            if (match[index]) return match[index];
+          }
+          return match[0] || '';
+        }
+        return '';
+      };
+      return {
+        appId: pick([
+          '"X-IG-App-ID":"(\\\\d+)"',
+          '"appId":"(\\\\d+)"',
+          '"app_id":"(\\\\d+)"',
+          '"instagramWebAppId":"(\\\\d+)"',
+        ]),
+        csrfToken: pick([
+          '"csrf_token":"([^"]+)"',
+          '"csrfToken":"([^"]+)"',
+        ]),
+        instagramAjax: pick([
+          '"rollout_hash":"([^"]+)"',
+          '"X-Instagram-AJAX":"([^"]+)"',
+          '"Instagram-AJAX":"([^"]+)"',
+        ]),
+      };
+    })()
+  `}function c(t,n){return t.find((a)=>a.name===n)?.value||""}export async function resolveInstagramRuntimeInfo(t){const[n,a]=await Promise.all([t.evaluate(buildReadInstagramRuntimeInfoJs()),t.getCookies({domain:"instagram.com"})]);return{appId:n?.appId||"",csrfToken:n?.csrfToken||c(a,"csrftoken")||"",instagramAjax:n?.instagramAjax||""}}

package/clis/instagram/auth.js

@@ -0,0 +1,22 @@
+import{AuthRequiredError as e,CommandExecutionError as s}from"@jackwener/opencli/errors";import{registerSiteAuthCommands as o}from"../_shared/site-auth.js";async function r(i){return(await i.getCookies({url:"https://www.instagram.com"})).some((n)=>n.name==="sessionid"&&n.value)}async function a(i){if(!await r(i))throw new e("www.instagram.com","Instagram sessionid cookie missing");await i.goto("https://www.instagram.com/");await i.wait(2);const t=await i.evaluate(`(async () => {
+    try {
+      const uid = (document.cookie.split('; ').find(c => c.startsWith('ds_user_id=')) || '').split('=')[1] || '';
+      if (!uid) return { kind: 'auth', detail: 'Instagram ds_user_id cookie missing' };
+      const r = await fetch('/api/v1/users/' + uid + '/info/', {
+        credentials: 'include',
+        headers: { 'X-IG-App-ID': '936619743392459', 'Accept': 'application/json' },
+      });
+      if (r.status === 401 || r.status === 403) {
+        return { kind: 'auth', detail: 'Instagram /users/info HTTP ' + r.status };
+      }
+      if (!r.ok) return { kind: 'http', httpStatus: r.status };
+      const d = await r.json();
+      const user = d?.user;
+      if (!user || !user.pk) {
+        return { kind: 'auth', detail: 'Instagram /users/info returned no pk — session likely expired' };
+      }
+      return { ok: true, user_id: String(user.pk), username: String(user.username || ''), full_name: String(user.full_name || '') };
+    } catch (e) {
+      return { kind: 'exception', detail: String(e && e.message || e) };
+    }
+  })()`);if(t?.kind==="auth")throw new e("www.instagram.com",t.detail);if(t?.kind==="http")throw new s(`HTTP ${t.httpStatus} from Instagram /users/info`);if(t?.kind==="exception")throw new s(`Instagram whoami failed: ${t.detail}`);if(!t?.ok)throw new s(`Unexpected Instagram probe: ${JSON.stringify(t)}`);return{user_id:t.user_id,username:t.username,full_name:t.full_name}}o({site:"instagram",domain:"instagram.com",loginUrl:"https://www.instagram.com/accounts/login/",columns:["user_id","username","full_name"],quickCheck:r,verify:a,poll:async(i)=>{if(!await r(i))throw new e("www.instagram.com","Waiting for Instagram sessionid cookie");return a(i)}});

package/clis/instagram/collection-create.js

@@ -0,0 +1,38 @@
+import{cli as e}from"@jackwener/opencli/registry";e({site:"instagram",name:"collection-create",access:"write",description:"Create a new Instagram saved-posts collection (folder)",domain:"www.instagram.com",args:[{name:"name",required:!0,positional:!0,help:"Name of the collection to create"}],columns:["status","collectionId","collectionName","mediaCount"],pipeline:[{navigate:"https://www.instagram.com"},{evaluate:`(async () => {
+  const name = \${{ args.name | json }};
+  if (!name || !String(name).trim()) {
+    throw new Error('Collection name cannot be empty');
+  }
+  const trimmed = String(name).trim();
+  const csrf = document.cookie.match(/csrftoken=([^;]+)/)?.[1] || '';
+  if (!csrf) {
+    throw new Error('csrftoken cookie missing - make sure you are logged in to Instagram');
+  }
+  const fd = new FormData();
+  fd.append('name', trimmed);
+  fd.append('module_name', 'collection_create');
+  const res = await fetch('https://www.instagram.com/api/v1/collections/create/', {
+    method: 'POST',
+    credentials: 'include',
+    headers: {
+      'X-IG-App-ID': '936619743392459',
+      'X-CSRFToken': csrf,
+    },
+    body: fd,
+  });
+  if (!res.ok) {
+    const body = await res.text().catch(() => '');
+    throw new Error('Failed to create collection: HTTP ' + res.status + (body ? ' - ' + body.slice(0, 200) : ''));
+  }
+  const d = await res.json();
+  if (d?.status && d.status !== 'ok') {
+    throw new Error('Instagram returned non-ok status: ' + JSON.stringify(d).slice(0, 300));
+  }
+  return [{
+    status: 'Created',
+    collectionId: String(d?.collection_id ?? ''),
+    collectionName: String(d?.collection_name ?? trimmed),
+    mediaCount: d?.collection_media_count ?? 0,
+  }];
+})()
+`}]});

package/clis/instagram/collection-delete.js

@@ -0,0 +1,72 @@
+import{cli as e}from"@jackwener/opencli/registry";e({site:"instagram",name:"collection-delete",access:"write",description:"Delete an Instagram saved-posts collection (folder) by name or id",domain:"www.instagram.com",args:[{name:"target",required:!0,positional:!0,help:"Collection name (case-insensitive) or numeric collection_id"}],columns:["status","collectionId","collectionName"],pipeline:[{navigate:"https://www.instagram.com"},{evaluate:`(async () => {
+  const target = \${{ args.target | json }};
+  if (!target || !String(target).trim()) {
+    throw new Error('Collection target (name or id) cannot be empty');
+  }
+  const raw = String(target).trim();
+  const csrf = document.cookie.match(/csrftoken=([^;]+)/)?.[1] || '';
+  if (!csrf) {
+    throw new Error('csrftoken cookie missing - make sure you are logged in to Instagram');
+  }
+  const headers = { 'X-IG-App-ID': '936619743392459' };
+
+  // Resolve name -> id via /collections/list/. Always go through this path so we can
+  // surface an explicit error on duplicate names or unknown names instead of relying
+  // on a 404.
+  const listRes = await fetch('https://www.instagram.com/api/v1/collections/list/?collection_types=%5B%22MEDIA%22%5D', {
+    credentials: 'include',
+    headers,
+  });
+  if (!listRes.ok) {
+    throw new Error('Failed to list collections: HTTP ' + listRes.status + ' - make sure you are logged in to Instagram');
+  }
+  const listData = await listRes.json();
+  const collections = listData?.items || [];
+  const isNumericId = /^\\d{6,}$/.test(raw);
+  let id = '';
+  let resolvedName = '';
+  if (isNumericId) {
+    const hit = collections.find((c) => String(c?.collection_id) === raw);
+    if (!hit) {
+      throw new Error('Collection id not found in your account: ' + raw);
+    }
+    id = String(hit.collection_id);
+    resolvedName = String(hit.collection_name || '');
+  } else {
+    const wanted = raw.toLowerCase();
+    const matches = collections.filter((c) => String(c?.collection_name || '').trim().toLowerCase() === wanted);
+    if (matches.length === 0) {
+      const names = collections.map((c) => c?.collection_name).filter(Boolean);
+      throw new Error('Collection not found: ' + raw + '. Available: ' + (names.length ? names.join(', ') : '(none)'));
+    }
+    if (matches.length > 1) {
+      const ids = matches.map((c) => c.collection_id).join(', ');
+      throw new Error('Multiple collections share the name "' + raw + '" (ids: ' + ids + '). Pass the numeric collection_id explicitly to disambiguate.');
+    }
+    id = String(matches[0].collection_id);
+    resolvedName = String(matches[0].collection_name || raw);
+  }
+
+  const fd = new FormData();
+  fd.append('module_name', 'collection_settings');
+  const res = await fetch('https://www.instagram.com/api/v1/collections/' + encodeURIComponent(id) + '/delete/', {
+    method: 'POST',
+    credentials: 'include',
+    headers: { ...headers, 'X-CSRFToken': csrf },
+    body: fd,
+  });
+  if (!res.ok) {
+    const body = await res.text().catch(() => '');
+    throw new Error('Failed to delete collection: HTTP ' + res.status + (body ? ' - ' + body.slice(0, 200) : ''));
+  }
+  const d = await res.json().catch(() => ({}));
+  if (d?.status && d.status !== 'ok') {
+    throw new Error('Instagram returned non-ok status: ' + JSON.stringify(d).slice(0, 300));
+  }
+  return [{
+    status: 'Deleted',
+    collectionId: id,
+    collectionName: resolvedName,
+  }];
+})()
+`}]});

package/clis/instagram/comment.js

@@ -0,0 +1,26 @@
+import{cli as e}from"@jackwener/opencli/registry";e({site:"instagram",name:"comment",access:"write",description:"Comment on an Instagram post",domain:"www.instagram.com",args:[{name:"username",required:!0,positional:!0,help:"Username of the post author"},{name:"text",required:!0,positional:!0,help:"Comment text"},{name:"index",type:"int",default:1,help:"Post index (1 = most recent)"}],columns:["status","user","text"],pipeline:[{navigate:"https://www.instagram.com"},{evaluate:`(async () => {
+  const username = \${{ args.username | json }};
+  const commentText = \${{ args.text | json }};
+  const idx = \${{ args.index }} - 1;
+  const headers = { 'X-IG-App-ID': '936619743392459' };
+  const opts = { credentials: 'include', headers };
+
+  const r1 = await fetch('https://www.instagram.com/api/v1/users/web_profile_info/?username=' + encodeURIComponent(username), opts);
+  if (!r1.ok) throw new Error('User not found: ' + username);
+  const userId = (await r1.json())?.data?.user?.id;
+
+  const r2 = await fetch('https://www.instagram.com/api/v1/feed/user/' + userId + '/?count=' + (idx + 1), opts);
+  const posts = (await r2.json())?.items || [];
+  if (idx >= posts.length) throw new Error('Post index ' + (idx + 1) + ' not found');
+  const pk = posts[idx].pk;
+
+  const csrf = document.cookie.match(/csrftoken=([^;]+)/)?.[1] || '';
+  const r3 = await fetch('https://www.instagram.com/api/v1/web/comments/' + pk + '/add/', {
+    method: 'POST', credentials: 'include',
+    headers: { ...headers, 'X-CSRFToken': csrf, 'Content-Type': 'application/x-www-form-urlencoded' },
+    body: 'comment_text=' + encodeURIComponent(commentText),
+  });
+  if (!r3.ok) throw new Error('Failed to comment: HTTP ' + r3.status);
+  return [{ status: 'Commented', user: username, text: commentText }];
+})()
+`}]});

package/clis/instagram/detail.js

@@ -0,0 +1,2 @@
+import{cli as p,Strategy as g}from"@jackwener/opencli/registry";import{CommandExecutionError as s}from"@jackwener/opencli/errors";import{buildInstagramFetchScript as f,ensurePage as w,handleFetchFailure as h,normalizeFetchResult as y,parseInstagramMediaTarget as v}from"./download.js";function l(t){return String(t||"").replace(/\s+/g," ").trim()}function u(t){const e=Number(t||0);return Number.isFinite(e)&&e>0?new Date(e*1000).toISOString():""}function b(t){if(!t||typeof t!=="object")return null;const e=t.is_video===!0,r=String(e?t.video_url||"":t.display_url||"").trim();if(!r)return null;return{kind:e?"video":"image",url:r}}function d(t){const e=Array.isArray(t?.edge_sidecar_to_children?.edges)?t.edge_sidecar_to_children.edges.map((n)=>n?.node).filter(Boolean):[];return(e.length>0?e:[t]).map(b).filter(Boolean)}function N(t,e){const r=String(e?.product_type||"").toLowerCase();if(r==="clips"||r==="reel"||t==="reel")return"reel";return t||"p"}function S(t){if(t.length>1)return"carousel";return t[0]?.kind||""}function c(t){const e=Number(t?.count??0);return Number.isFinite(e)?e:0}function k(t){const e=t?.edge_media_to_caption?.edges?.[0]?.node?.text||"";return l(e)}function m(t,e){if(!e||typeof e!=="object")throw new s("Instagram returned malformed media detail payload");const r=String(e.shortcode||t.shortcode||"").trim(),n=String(e.id||"").trim(),o=String(e?.owner?.username||"").trim();if(!r||!n||!o)throw new s("Instagram returned malformed media detail payload");const i=d(e);if(i.length===0)throw new s("Instagram detail payload did not contain any media URLs");const _=N(t.kind,e);return{shortcode:r,media_id:n,kind:_,type:S(i),posted_at:u(e.taken_at_timestamp),owner:o,owner_name:String(e?.owner?.full_name||"").trim(),owner_verified:e?.owner?.is_verified?"Yes":"No",caption:k(e),likes:c(e?.edge_media_preview_like),comments:c(e?.edge_media_to_comment)||c(e?.edge_media_to_parent_comment),views:Number.isFinite(Number(e?.video_view_count))?Number(e.video_view_count):Number.isFinite(Number(e?.video_play_count))?Number(e.video_play_count):"",media_count:i.length,media_types:i.map((a)=>a.kind).join(", "),media_urls:i.map((a)=>a.url).join(`
+`),thumbnail_url:String(e.display_url||"").trim(),url:t.canonicalUrl}}p({site:"instagram",name:"detail",access:"read",description:"Get single-post Instagram details, including direct media URLs",domain:"www.instagram.com",strategy:g.COOKIE,navigateBefore:!1,args:[{name:"url",positional:!0,required:!0,help:"Instagram post / reel / tv URL"}],columns:["shortcode","media_id","kind","type","posted_at","owner","owner_name","owner_verified","likes","comments","views","media_count","media_types","media_urls","thumbnail_url","url","caption"],func:async(t,e)=>{const r=w(t),n=v(String(e.url??""));await r.goto(n.canonicalUrl);const o=y(await r.evaluate(f(n.shortcode)));if(!o.ok)h(o);return[m(n,o.media)]},__test__:{normalizeCaptionText:l,formatPostedAt:u,normalizeMediaNodes:d,normalizeDetailRow:m}});

package/clis/instagram/download.js

@@ -0,0 +1,83 @@
+import*as w from"node:fs";import*as u from"node:os";import*as l from"node:path";import{cli as p,Strategy as f}from"@jackwener/opencli/registry";import{ArgumentError as c,AuthRequiredError as I,CliError as _,CommandExecutionError as d,EXIT_CODES as E}from"@jackwener/opencli/errors";import{httpDownload as A}from"@jackwener/opencli/download";const R="8845758582119845",T="936619743392459",g="instagram.com",h=new Set(["p","reel","tv"]);function y(e){const r=u.homedir();return e.startsWith(r)?`~${e.slice(r.length)}`:e}export function parseInstagramMediaTarget(e){const r=String(e||"").trim();if(!r)throw new c("Instagram URL is required","Expected https://www.instagram.com/p/... or https://www.instagram.com/reel/...");let t;try{t=new URL(r)}catch{throw new c(`Invalid Instagram URL: ${r}`,"Expected https://www.instagram.com/p/<shortcode>/ or /reel/<shortcode>/")}if(!["http:","https:"].includes(t.protocol))throw new c(`Unsupported URL protocol: ${t.protocol}`);const s=t.hostname.toLowerCase();if(s!==g&&!s.endsWith(`.${g}`))throw new c(`Unsupported host: ${s}`,"Only instagram.com URLs are supported");const o=t.pathname.split("/").filter(Boolean);let a,n;if(o.length>=2&&h.has(o[0])){a=o[0];n=o[1]}else if(o.length>=3&&h.has(o[1])){a=o[1];n=o[2]}if(!a||!n)throw new c(`Unsupported Instagram media URL: ${r}`,"Only /p/<shortcode>/, /reel/<shortcode>/, and /tv/<shortcode>/ links are supported");return{kind:a,shortcode:n,canonicalUrl:`https://www.instagram.com/${a}/${n}/`}}export function buildInstagramDownloadItems(e,r){return r.filter((t)=>t?.url).map((t,s)=>{const o=t.type==="video"?".mp4":".jpg";let a=o;try{const n=new URL(t.url).pathname,i=l.extname(n).toLowerCase();if(i&&i.length<=8)a=i}catch{a=o}return{type:t.type,url:t.url,filename:`${e}_${String(s+1).padStart(2,"0")}${a}`}})}export function buildInstagramFetchScript(e){return`
+    (async () => {
+      const shortcode = ${JSON.stringify(e)};
+      const docId = ${JSON.stringify(R)};
+      const variables = {
+        shortcode,
+        fetch_tagged_user_count: null,
+        hoisted_comment_id: null,
+        hoisted_reply_id: null,
+      };
+      const url = 'https://www.instagram.com/graphql/query/?doc_id=' + docId + '&variables=' + encodeURIComponent(JSON.stringify(variables));
+      const res = await fetch(url, {
+        credentials: 'include',
+        headers: {
+          'Accept': 'application/json,text/plain,*/*',
+          'X-IG-App-ID': ${JSON.stringify(T)},
+        },
+      });
+      const rawText = await res.text();
+
+      let data = null;
+      try {
+        data = rawText ? JSON.parse(rawText) : null;
+      } catch {
+        return {
+          ok: false,
+          errorCode: 'COMMAND_EXEC',
+          error: 'Instagram returned non-JSON content while fetching media metadata',
+        };
+      }
+
+      const message = typeof data?.message === 'string' ? data.message : '';
+      const lowered = (message || '').toLowerCase();
+
+      if (!res.ok) {
+        if (res.status === 401 || res.status === 403 || data?.require_login) {
+          return { ok: false, errorCode: 'AUTH_REQUIRED', error: message || ('HTTP ' + res.status) };
+        }
+        if (res.status === 429) {
+          return { ok: false, errorCode: 'RATE_LIMITED', error: message || 'HTTP 429' };
+        }
+        if (res.status === 404 || res.status === 410) {
+          return { ok: false, errorCode: 'PRIVATE_OR_UNAVAILABLE', error: message || ('HTTP ' + res.status) };
+        }
+        return { ok: false, errorCode: 'COMMAND_EXEC', error: message || ('HTTP ' + res.status) };
+      }
+
+      if (data?.require_login) {
+        return { ok: false, errorCode: 'AUTH_REQUIRED', error: message || 'Instagram login required' };
+      }
+      if (lowered.includes('wait a few minutes') || lowered.includes('rate')) {
+        return { ok: false, errorCode: 'RATE_LIMITED', error: message || 'Instagram rate limit triggered' };
+      }
+
+      const media = data?.data?.xdt_shortcode_media;
+      if (!media) {
+        return {
+          ok: false,
+          errorCode: 'PRIVATE_OR_UNAVAILABLE',
+          error: message || 'Post may be private, unavailable, or inaccessible to the current browser session',
+        };
+      }
+
+      const nodes = Array.isArray(media?.edge_sidecar_to_children?.edges) && media.edge_sidecar_to_children.edges.length > 0
+        ? media.edge_sidecar_to_children.edges.map((edge) => edge?.node).filter(Boolean)
+        : [media];
+
+      const items = nodes
+        .map((node) => ({
+          type: node?.is_video ? 'video' : 'image',
+          url: String(node?.is_video ? (node?.video_url || '') : (node?.display_url || '')),
+        }))
+        .filter((item) => item.url);
+
+      return {
+        ok: true,
+        shortcode: media.shortcode || shortcode,
+        owner: media?.owner?.username || '',
+        media,
+        items,
+      };
+    })()
+  `}export function ensurePage(e){if(!e)throw new d("Browser session required");return e}export function normalizeFetchResult(e){if(!e||typeof e!=="object")throw new d("Failed to fetch Instagram media metadata");return e}export function handleFetchFailure(e){const r=e.error||"Instagram media fetch failed";if(e.errorCode==="AUTH_REQUIRED")throw new I("instagram.com",r);if(e.errorCode==="RATE_LIMITED")throw new _("RATE_LIMITED",r,"Wait a few minutes and retry, or switch to a browser session with a warmer Instagram login state.",E.TEMPFAIL);if(e.errorCode==="PRIVATE_OR_UNAVAILABLE")throw new d(r,"Open the post in a logged-in browser session and retry");throw new d(r)}async function U(e,r){w.mkdirSync(r,{recursive:!0});for(const t of e){const s=l.join(r,t.filename),o=await A(t.url,s,{timeout:t.type==="video"?120000:60000});if(!o.success)throw new d(`Failed to download ${t.filename}: ${o.error||"unknown error"}`)}}p({site:"instagram",name:"download",access:"read",description:"Download images and videos from Instagram posts and reels",domain:"www.instagram.com",strategy:f.COOKIE,navigateBefore:!1,args:[{name:"url",positional:!0,required:!0,help:"Instagram post / reel / tv URL"},{name:"path",default:"~/Downloads/Instagram",help:"Download directory"}],func:async(e,r)=>{const t=ensurePage(e),s=parseInstagramMediaTarget(String(r.url??"")),o=String(r.path??l.join(u.homedir(),"Downloads","Instagram"));await t.goto(s.canonicalUrl);const a=normalizeFetchResult(await t.evaluate(buildInstagramFetchScript(s.shortcode)));if(!a.ok)handleFetchFailure(a);const n=a.shortcode||s.shortcode,i=buildInstagramDownloadItems(n,a.items||[]);if(i.length===0)throw new d("No downloadable media found");const m=l.join(o,n);await U(i,m);console.log(`\uD83D\uDCC1 saved: ${y(m)}`);return null}});

package/clis/instagram/explore.js

@@ -0,0 +1,27 @@
+import{cli as e}from"@jackwener/opencli/registry";e({site:"instagram",name:"explore",access:"read",description:"Instagram explore/discover trending posts",domain:"www.instagram.com",args:[{name:"limit",type:"int",default:20,help:"Number of posts"}],columns:["rank","user","caption","likes","comments","type"],pipeline:[{navigate:"https://www.instagram.com"},{evaluate:`(async () => {
+  const limit = \${{ args.limit }};
+  const res = await fetch(
+    'https://www.instagram.com/api/v1/discover/web/explore_grid/',
+    {
+      credentials: 'include',
+      headers: { 'X-IG-App-ID': '936619743392459' }
+    }
+  );
+  if (!res.ok) throw new Error('HTTP ' + res.status + ' - make sure you are logged in to Instagram');
+  const data = await res.json();
+  const posts = [];
+  for (const sec of (data?.sectional_items || [])) {
+    for (const m of (sec?.layout_content?.medias || [])) {
+      const media = m?.media;
+      if (media) posts.push({
+        user: media.user?.username || '',
+        caption: (media.caption?.text || '').replace(/\\n/g, ' ').substring(0, 100),
+        likes: media.like_count ?? 0,
+        comments: media.comment_count ?? 0,
+        type: media.media_type === 1 ? 'photo' : media.media_type === 2 ? 'video' : 'carousel',
+      });
+    }
+  }
+  return posts.slice(0, limit).map((p, i) => ({ rank: i + 1, ...p }));
+})()
+`}]});

package/clis/instagram/follow.js

@@ -0,0 +1,24 @@
+import{cli as e}from"@jackwener/opencli/registry";e({site:"instagram",name:"follow",access:"write",description:"Follow an Instagram user",domain:"www.instagram.com",args:[{name:"username",required:!0,positional:!0,help:"Instagram username to follow"}],columns:["status","username"],pipeline:[{navigate:"https://www.instagram.com"},{evaluate:`(async () => {
+  const username = \${{ args.username | json }};
+  const headers = { 'X-IG-App-ID': '936619743392459' };
+  const opts = { credentials: 'include', headers };
+
+  // Get user ID
+  const r1 = await fetch('https://www.instagram.com/api/v1/users/web_profile_info/?username=' + encodeURIComponent(username), opts);
+  if (!r1.ok) throw new Error('User not found: ' + username);
+  const d1 = await r1.json();
+  const userId = d1?.data?.user?.id;
+  if (!userId) throw new Error('User not found: ' + username);
+
+  const csrf = document.cookie.match(/csrftoken=([^;]+)/)?.[1] || '';
+  const r2 = await fetch('https://www.instagram.com/api/v1/friendships/create/' + userId + '/', {
+    method: 'POST',
+    credentials: 'include',
+    headers: { ...headers, 'X-CSRFToken': csrf, 'Content-Type': 'application/x-www-form-urlencoded' },
+  });
+  if (!r2.ok) throw new Error('Failed to follow: HTTP ' + r2.status);
+  const d2 = await r2.json();
+  const status = d2?.friendship_status?.following ? 'Following' : d2?.friendship_status?.outgoing_request ? 'Request sent' : 'Followed';
+  return [{ status, username }];
+})()
+`}]});

package/clis/instagram/followers.js

@@ -0,0 +1,30 @@
+import{cli as e}from"@jackwener/opencli/registry";e({site:"instagram",name:"followers",access:"read",description:"List followers of an Instagram user",domain:"www.instagram.com",args:[{name:"username",required:!0,positional:!0,help:"Instagram username"},{name:"limit",type:"int",default:20,help:"Number of followers"}],columns:["rank","username","name","verified","private"],pipeline:[{navigate:"https://www.instagram.com"},{evaluate:`(async () => {
+  const username = \${{ args.username | json }};
+  const limit = \${{ args.limit }};
+  const headers = { 'X-IG-App-ID': '936619743392459' };
+  const opts = { credentials: 'include', headers };
+
+  const r1 = await fetch(
+    'https://www.instagram.com/api/v1/users/web_profile_info/?username=' + encodeURIComponent(username),
+    opts
+  );
+  if (!r1.ok) throw new Error('HTTP ' + r1.status + ' - make sure you are logged in to Instagram');
+  const d1 = await r1.json();
+  const userId = d1?.data?.user?.id;
+  if (!userId) throw new Error('User not found: ' + username);
+
+  const r2 = await fetch(
+    'https://www.instagram.com/api/v1/friendships/' + userId + '/followers/?count=' + limit,
+    opts
+  );
+  if (!r2.ok) throw new Error('Failed to fetch followers: HTTP ' + r2.status);
+  const d2 = await r2.json();
+  return (d2?.users || []).slice(0, limit).map((u, i) => ({
+    rank: i + 1,
+    username: u.username || '',
+    name: u.full_name || '',
+    verified: u.is_verified ? 'Yes' : 'No',
+    private: u.is_private ? 'Yes' : 'No',
+  }));
+})()
+`}]});

package/clis/instagram/following.js

@@ -0,0 +1,74 @@
+import{cli as e}from"@jackwener/opencli/registry";e({site:"instagram",name:"following",access:"read",description:"List accounts an Instagram user is following",domain:"www.instagram.com",args:[{name:"username",required:!0,positional:!0,help:"Instagram username"},{name:"limit",type:"int",default:20,help:"Number of accounts"}],columns:["rank","username","name","verified","private"],pipeline:[{navigate:"https://www.instagram.com"},{evaluate:`(async () => {
+  const username = \${{ args.username | json }};
+  const limit = \${{ args.limit }};
+  if (!Number.isInteger(limit) || limit < 1) throw new Error('limit must be a positive integer');
+  const headers = { 'X-IG-App-ID': '936619743392459' };
+  const opts = { credentials: 'include', headers };
+
+  const r1 = await fetch(
+    'https://www.instagram.com/api/v1/users/web_profile_info/?username=' + encodeURIComponent(username),
+    opts
+  );
+  if (!r1.ok) throw new Error('HTTP ' + r1.status + ' - make sure you are logged in to Instagram');
+  const d1 = await r1.json();
+  const userId = d1?.data?.user?.id;
+  if (!userId) throw new Error('User not found: ' + username);
+
+  const PAGE_SIZE = 50;
+  const results = [];
+  const seen = new Set();
+  const seenCursors = new Set();
+  let maxId = undefined;
+  const baseUrl = 'https://www.instagram.com/api/v1/friendships/' + userId + '/following/';
+
+  while (results.length < limit) {
+    const params = new URLSearchParams({ count: String(PAGE_SIZE) });
+    if (maxId) params.set('max_id', maxId);
+    const r2 = await fetch(baseUrl + '?' + params.toString(), opts);
+    if (!r2.ok) throw new Error('Failed to fetch following: HTTP ' + r2.status);
+    const d2 = await r2.json();
+    if (!d2 || typeof d2 !== 'object' || !Array.isArray(d2.users)) {
+      throw new Error('Instagram following returned malformed users payload');
+    }
+    const users = d2.users;
+    const sizeBefore = results.length;
+    for (const u of users) {
+      if (!u || typeof u !== 'object') {
+        throw new Error('Instagram following returned malformed user row');
+      }
+      const pk = String(u.pk ?? u.pk_id ?? u.id ?? '');
+      const usernameValue = typeof u.username === 'string' ? u.username.trim() : '';
+      if (!pk || !usernameValue) {
+        throw new Error('Instagram following returned malformed user row');
+      }
+      if (!pk || seen.has(pk)) continue;
+      seen.add(pk);
+      results.push({
+        rank: results.length + 1,
+        username: usernameValue,
+        name: typeof u.full_name === 'string' ? u.full_name : '',
+        verified: u.is_verified ? 'Yes' : 'No',
+        private: u.is_private ? 'Yes' : 'No',
+      });
+      if (results.length >= limit) break;
+    }
+    if (results.length >= limit) break;
+    if (results.length === sizeBefore) break;  // no new unique users this page
+    if (d2.next_max_id != null && typeof d2.next_max_id !== 'string' && typeof d2.next_max_id !== 'number') {
+      throw new Error('Instagram following returned malformed pagination cursor');
+    }
+    if (d2.has_more != null && typeof d2.has_more !== 'boolean') {
+      throw new Error('Instagram following returned malformed has_more flag');
+    }
+    const nextCursor = d2.next_max_id == null ? '' : String(d2.next_max_id);
+    const hasMore = typeof d2.has_more === 'boolean' ? d2.has_more : !!nextCursor;
+    if (!hasMore || users.length === 0) break;
+    if (!nextCursor) throw new Error('Instagram following returned has_more without pagination cursor');
+    if (seenCursors.has(nextCursor)) break;  // cursor loop guard
+    seenCursors.add(nextCursor);
+    maxId = nextCursor;
+    await new Promise(r => setTimeout(r, 400));
+  }
+  return results.slice(0, limit);
+})()
+`}]});