mobbin 0.1.0

package/mobbin-sdk.js

@@ -0,0 +1,203 @@
+const DEFAULT_BASE_URL = 'https://mobbin.com';
+const DEFAULT_USER_AGENT =
+  'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120 Safari/537.36';
+
+export class MobbinClient {
+  constructor({
+    baseUrl = DEFAULT_BASE_URL,
+    cookie,
+    headers = {},
+    userAgent = DEFAULT_USER_AGENT,
+    timeoutMs = 20000,
+  } = {}) {
+    this.baseUrl = baseUrl.replace(/\/$/, '');
+    this.cookie = cookie;
+    this.headers = headers;
+    this.userAgent = userAgent;
+    this.timeoutMs = timeoutMs;
+  }
+
+  setCookie(cookie) {
+    this.cookie = cookie;
+  }
+
+  async request(path, { method = 'GET', json, headers } = {}) {
+    const url = path.startsWith('http') ? path : `${this.baseUrl}${path}`;
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), this.timeoutMs);
+
+    const finalHeaders = {
+      Accept: 'application/json, text/plain, */*',
+      'User-Agent': this.userAgent,
+      ...this.headers,
+      ...headers,
+    };
+
+    if (this.cookie) {
+      finalHeaders.Cookie = this.cookie;
+    }
+
+    let body;
+    if (json !== undefined) {
+      finalHeaders['Content-Type'] = 'application/json';
+      body = JSON.stringify(json);
+    }
+
+    const res = await fetch(url, {
+      method,
+      headers: finalHeaders,
+      body,
+      signal: controller.signal,
+    });
+
+    clearTimeout(timeout);
+
+    const text = await res.text();
+    let data = null;
+    if (text) {
+      try {
+        data = JSON.parse(text);
+      } catch {
+        data = text;
+      }
+    }
+
+    if (!res.ok) {
+      const error = new Error(`HTTP ${res.status} ${res.statusText}`);
+      error.status = res.status;
+      error.data = data;
+      throw error;
+    }
+
+    return data;
+  }
+
+  fetchTrendingApps({ platform = 'ios' } = {}) {
+    return this.request('/api/search-bar/fetch-trending-apps', {
+      method: 'POST',
+      json: { platform },
+    });
+  }
+
+  fetchTrendingFilterTags({ platform = 'ios', experience = 'apps' } = {}) {
+    return this.request('/api/search-bar/fetch-trending-filter-tags', {
+      method: 'POST',
+      json: { platform, experience },
+    });
+  }
+
+  fetchTrendingKeywords({ platform = 'ios' } = {}) {
+    return this.request('/api/search-bar/fetch-trending-text-in-screenshot-keywords', {
+      method: 'POST',
+      json: { platform },
+    });
+  }
+
+  fetchTrendingSites() {
+    return this.request('/api/search-bar/fetch-trending-sites', {
+      method: 'POST',
+      json: {},
+    });
+  }
+
+  fetchSearchableSites() {
+    return this.request('/api/search-bar/fetch-searchable-sites', {
+      method: 'POST',
+      json: {},
+    });
+  }
+
+  fetchSearchableApps({ platform = 'ios' } = {}) {
+    return this.request(`/api/searchable-apps/${platform}`);
+  }
+
+  fetchDictionaryDefinitions() {
+    return this.request('/api/filter-tags/fetch-dictionary-definitions', {
+      method: 'POST',
+      json: {},
+    });
+  }
+
+  search({ query, experience = 'apps', platform = 'ios' } = {}) {
+    return this.request('/api/search-bar/search', {
+      method: 'POST',
+      json: { query, experience, platform },
+    });
+  }
+
+  fetchPopularApps({ platform = 'ios', limitPerCategory = 10 } = {}) {
+    return this.request('/api/popular-apps/fetch-popular-apps-with-preview-screens', {
+      method: 'POST',
+      json: { platform, limitPerCategory },
+    });
+  }
+
+  fetchAppVersionsScreens({ appId } = {}) {
+    return this.request('/api/app/fetch-app-versions-screens', {
+      method: 'POST',
+      json: { appId },
+    });
+  }
+
+  fetchScreenInfo({ screenId } = {}) {
+    return this.request('/api/screen/fetch-screen-info', {
+      method: 'POST',
+      json: { screenId },
+    });
+  }
+
+  fetchRecentSearches() {
+    return this.request('/api/recent-searches');
+  }
+
+  fetchContentApps({ searchRequestId = null, filterOptions, paginationOptions } = {}) {
+    return this.request('/api/content/fetch-apps', {
+      method: 'POST',
+      json: { searchRequestId, filterOptions, paginationOptions },
+    });
+  }
+
+  createVisualSearchImage(payload) {
+    return this.request('/api/visual-search-image/create', {
+      method: 'POST',
+      json: payload,
+    });
+  }
+}
+
+export function buildContentAppsPayload({
+  platform = 'ios',
+  tab = 'latest',
+  pageSize = 24,
+} = {}) {
+  const filterOptions = {
+    filterOperator: 'or',
+    platform,
+    appCategories: null,
+  };
+
+  if (tab === 'latest') {
+    filterOptions.shouldHideNonIdealApps = true;
+  }
+
+  let sortBy = 'publishedAt';
+  if (tab === 'popular') {
+    sortBy = 'popularity';
+  } else if (tab === 'top') {
+    sortBy = 'rating';
+  }
+
+  return {
+    searchRequestId: null,
+    filterOptions,
+    paginationOptions: {
+      pageSize,
+      sortBy,
+    },
+  };
+}
+
+export const DEFAULTS = {
+  baseUrl: DEFAULT_BASE_URL,
+  userAgent: DEFAULT_USER_AGENT,
+};

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "mobbin",
+  "version": "0.1.0",
+  "description": "CLI + lightweight SDK for Mobbin's (mostly undocumented) web JSON endpoints and asset downloads.",
+  "author": "Tomas Roda <dev@tomasroda.com>",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "mobbin": "mobbin-cli.js"
+  },
+  "files": [
+    "mobbin-cli.js",
+    "mobbin-sdk.js",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/thehumanworks/mobbin-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/thehumanworks/mobbin-cli/issues"
+  },
+  "homepage": "https://github.com/thehumanworks/mobbin-cli#readme",
+  "engines": {
+    "node": ">=18",
+    "bun": ">=1.0.0"
+  }
+}