website-api 1.0.1

package/README.md

@@ -0,0 +1,241 @@
+# website-api
+
+A TypeScript CLI and library published as `website-api` that uses [chrome-tools](https://github.com/user/chrome-tools) to extract decrypted Chrome cookies on macOS, then queries private/internal website APIs — no manual cookie copy-pasting needed.
+
+---
+
+## Features
+
+- 🔑 **Keychain Decryption** — Leverages `chrome-tools` to decrypt Chrome cookies via the macOS Keychain.
+- 📂 **Auto-Loading Adapters** — Drop a folder into `src/website/`, and the adapter is auto-discovered at runtime.
+- 🧩 **Zero-Boilerplate Adapters** — The `defineAdapter()` factory handles cookies, user-agent, fetch, and error handling. Simple adapters are ~10 lines.
+- 👥 **Multi-Profile Support** — Target specific Chrome profiles (e.g., `Default`, `Profile 1`) or custom user data paths.
+- 🚀 **Dual Interface** — Works as both an importable ES module library and a terminal CLI.
+
+---
+
+## Supported Website APIs
+
+| ID | Name | Domain | Description |
+|----|------|--------|-------------|
+| `codex-usage` | ChatGPT / Codex Usage | chatgpt.com | Fetches ChatGPT rate limit usage and quota details from the private wham/usage API. |
+| `cursor-usage` | Cursor Usage | cursor.com | Fetches the active Cursor usage summary from the private usage-summary API. |
+| `ollama-usage` | Ollama Usage | ollama.com | Fetches Ollama plan and usage details from the authenticated settings page. |
+
+Each adapter has a `request.md` file documenting the exact HTTP requests and expected responses.
+
+---
+
+## Installation & Setup
+
+### Prerequisites
+
+- macOS with Google Chrome installed
+- Node.js ≥ 18
+- [pnpm](https://pnpm.io/) package manager
+
+### Install
+
+```bash
+pnpm install
+pnpm run build
+```
+
+### Link CLI globally (optional)
+
+```bash
+pnpm link --global
+website-api --help
+```
+
+---
+
+## CLI Usage
+
+```bash
+# Show help
+node dist/bin/cli.js --help
+
+# List all supported adapters
+node dist/bin/cli.js list
+
+# Query a website API
+node dist/bin/cli.js codex-usage
+node dist/bin/cli.js cursor-usage
+node dist/bin/cli.js ollama-usage
+
+# Domain aliases still work too
+node dist/bin/cli.js chatgpt.com
+node dist/bin/cli.js cursor.com
+node dist/bin/cli.js ollama.com
+```
+
+### Options
+
+| Option | Description |
+|--------|-------------|
+| `--profile <name>` | Target a specific Chrome profile (e.g., `Default`, `Profile 1`) |
+| `--current-profile` | Show the currently resolved Chrome profile directory and name |
+| `-u, --user-agent <string>` | Custom User-Agent header for HTTP requests |
+
+### Universal Fallback
+
+Any URL or domain not matching a registered adapter will be fetched directly with Chrome cookies:
+
+```bash
+node dist/bin/cli.js https://example.com/api/data
+```
+
+---
+
+## Library Usage (Programmatic API)
+
+```typescript
+import { queryWebsite } from "website-api";
+
+const data = await queryWebsite("chatgpt.com", {
+  profile: "Default",
+});
+
+// Command IDs also work:
+// await queryWebsite("codex-usage", { profile: "Default" });
+
+console.log(JSON.stringify(data, null, 2));
+```
+
+---
+
+## How to Add a New Website Adapter
+
+### Step 1: Create the adapter folder
+
+```
+src/website/github.com/
+├── github-adapter.ts   ← adapter code
+└── request.md          ← document the endpoint (required)
+```
+
+### Step 2: Write the adapter
+
+For **simple single-endpoint** APIs — just declare the endpoint:
+
+```typescript
+// src/website/github.com/github-adapter.ts
+import { defineAdapter } from "../../base-adapter.js";
+
+export default defineAdapter({
+  id: "github.com",
+  name: "GitHub Notifications",
+  domain: "github.com",
+  description: "Fetches unread notifications from the GitHub API.",
+  endpoints: [{ url: "https://api.github.com/notifications" }],
+});
+```
+
+For **multi-step flows** (e.g., session token → API call) — override `fetchData`:
+
+```typescript
+// src/website/example.com/example-adapter.ts
+import { defineAdapter } from "../../base-adapter.js";
+
+export default defineAdapter({
+  id: "example.com",
+  name: "Example Service",
+  domain: "example.com",
+  description: "Fetches data with a two-step auth flow.",
+
+  async fetchData(cookies, options) {
+    const cookieStr = this.buildCookieString(cookies);  // shared helper
+    const ua = this.resolveUserAgent(options);           // shared helper
+
+    // Step 1: get token
+    const session = await this.fetchJson("https://example.com/auth", {
+      headers: { Cookie: cookieStr, "User-Agent": ua },
+    });
+
+    // Step 2: use token
+    return this.fetchJson("https://example.com/api/data", {
+      headers: { Authorization: `Bearer ${session.token}` },
+    });
+  },
+});
+```
+
+### Step 3: Document the endpoint
+
+Create `request.md` in the adapter folder documenting the HTTP requests, headers, and example responses. See [chatgpt.com/request.md](src/website/chatgpt.com/request.md) for reference.
+
+### Step 4: Build and test
+
+```bash
+pnpm run build
+node dist/bin/cli.js list          # verify it appears
+node dist/bin/cli.js github.com    # test it
+```
+
+That's it — **no registration needed**. The adapter is auto-discovered from the `website/` directory at runtime.
+
+---
+
+## Shared Adapter Helpers
+
+Every adapter created with `defineAdapter()` automatically gets these methods via `this`:
+
+| Method | Description |
+|--------|-------------|
+| `this.buildCookieString(cookies)` | Converts cookies array to `"name=value; ..."` header string |
+| `this.resolveUserAgent(options)` | Resolves User-Agent from options → `.env` → default |
+| `this.fetchJson(url, init?)` | Fetch with error handling + automatic JSON parsing |
+
+---
+
+## Configuration
+
+Create a `.env` file in the project root:
+
+```env
+# Custom User-Agent (defaults to Chrome 148 on macOS)
+userAgent="Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/148.0.0.0 Safari/537.36"
+
+# Custom Chrome profile path (defaults to standard macOS location)
+PROFILE_PATH="/Users/yourname/chrome_profile/chrome"
+PROFILE_NAME="Default"
+```
+
+---
+
+## Project Structure
+
+```
+├── src/
+│   ├── website-api.ts          # Main entry — auto-loads adapters, queryWebsite()
+│   ├── base-adapter.ts         # defineAdapter() factory + shared helpers
+│   ├── types.ts                # TypeScript interfaces
+│   ├── env.ts                  # .env file loader
+│   ├── universal-adapter.ts    # Fallback for unregistered domains
+│   └── website/
+│       ├── chatgpt.com/
+│       │   ├── chatgpt-adapter.ts
+│       │   └── request.md
+│       ├── cursor.com/
+│           ├── cursor-adapter.ts
+│           └── request.md
+│       └── ollama.com/
+│           ├── ollama-adapter.ts
+│           └── request.md
+├── bin/
+│   └── cli.ts                  # CLI entry point
+├── tsconfig.json
+├── package.json
+└── .env                        # Local config (gitignored)
+```
+
+---
+
+## Security Warning
+
+This utility is designed strictly for local development and authorized administrative use. macOS will request explicit Keychain authorization before allowing `chrome-tools` to access the Chrome Safe Storage Password. Only run this tool in trusted environments.
+
+## License
+
+MIT License

package/dist/bin/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/bin/cli.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import{readFileSync as o}from"node:fs";import{dirname as e,join as r}from"node:path";import{fileURLToPath as n}from"node:url";import{program as t}from"commander";import s from"chalk";import i from"cli-table3";import{getDefaultChromeDir as l}from"chrome-tools";import{queryWebsite as c,websites as a,loadAdapters as p}from"../src/website-api.js";const d=r(e(n(import.meta.url)),"..","..","package.json"),{version:m}=JSON.parse(o(d,"utf8"));process.on("unhandledRejection",()=>{console.error("No login found in browser"),process.exit(1)}),t.name("website-api").description("CLI to query website APIs using decrypted Chrome cookies on macOS").version(m),t.option("--profile <name>","specific Chrome profile directory (e.g., 'Default', 'Profile 1')").option("--current-profile","Show the currently resolved/selected Chrome profile directory and name").option("-u, --user-agent <string>","custom User-Agent header for HTTP requests"),t.command("list").description("List all supported website API adapters").action(async()=>{await p(),console.log(s.bold.green("\n🌐 Supported Website APIs:\n"));const o=new i({head:[s.bold.cyan("ID"),s.bold.cyan("Name"),s.bold.cyan("Domain"),s.bold.cyan("Description")],colWidths:[18,25,20,50],wordWrap:!0,style:{head:[],border:[]}});for(const e of a)o.push([s.yellow(e.id),e.name,s.underline(e.domain),e.description]);console.log(o.toString()),console.log(`\nTo run an API query, execute: ${s.bold.cyan("npx website-api <id>")}\n`)}),t.argument("[website]","website ID or domain to query (e.g. 'chatgpt.com')").action(async o=>{const e=t.opts();if(e.currentProfile){const o=process.env.PROFILE_PATH||process.env.CHROME_PROFILE_PATH||l(),r=e.profile||process.env.PROFILE_NAME||"Default";return console.log(s.bold.green("\n👤 Currently Resolved Profile:\n")),console.log(`  ${s.bold("Path:")}  ${o}`),void console.log(`  ${s.bold("Name:")}  ${r}\n`)}if(o)try{const r=await c(o,{profile:e.profile,userAgent:e.userAgent});console.log(JSON.stringify(r,null,2))}catch(o){console.error("No login found in browser"),process.exit(1)}else t.outputHelp()}),t.parse(process.argv);

package/dist/src/base-adapter.d.ts

@@ -0,0 +1,19 @@
+import type { AdapterConfig, WebsiteAdapter } from "./types.js";
+/**
+ * Factory function to create a fully-equipped WebsiteAdapter from a minimal config.
+ *
+ * Simple adapters only need `id`, `name`, `domain`, `description`, and `endpoints`.
+ * Complex adapters can provide a custom `fetchData` that uses `this.buildCookieString()`,
+ * `this.resolveUserAgent()`, and `this.fetchJson()`.
+ *
+ * @example
+ * // Simple adapter (~5 lines of config):
+ * export default defineAdapter({
+ *   id: "cursor.com",
+ *   name: "Cursor Usage",
+ *   domain: "cursor.com",
+ *   description: "Fetches Cursor usage summary.",
+ *   endpoints: [{ url: "https://cursor.com/api/usage-summary" }],
+ * });
+ */
+export declare function defineAdapter(config: AdapterConfig): WebsiteAdapter;

package/dist/src/base-adapter.js

@@ -0,0 +1 @@
+const e={buildCookieString:e=>e.map(e=>`${e.name}=${e.value}`).join("; "),resolveUserAgent:e=>e.userAgent||process.env.userAgent||process.env.USER_AGENT||"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/148.0.0.0 Safari/537.36",async fetchJson(e,t){const n=await fetch(e,t);if(!n.ok)throw new Error(`HTTP ${n.status}: ${n.statusText}`);const s=await n.text();try{return JSON.parse(s)}catch{return{response:s}}}};async function t(e,t){if(!this.endpoints||0===this.endpoints.length)throw new Error(`Adapter "${this.id}" has no endpoints defined and no fetchData override`);const n=this.endpoints[0],s=this.buildCookieString(e),o=this.resolveUserAgent(t);return this.fetchJson(n.url,{method:n.method||"GET",headers:{Cookie:s,"User-Agent":o,Accept:"application/json, text/plain, */*",...n.headers}})}export function defineAdapter(n){const s={...n,...e,fetchData:n.fetchData??t};return s.fetchData=s.fetchData.bind(s),s}

package/dist/src/env.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Loads environment variables from the project root .env file.
+ * Silently skips if the file doesn't exist.
+ */
+export declare function loadEnv(): void;

package/dist/src/env.js

@@ -0,0 +1 @@
+import{readFileSync as t,existsSync as n}from"node:fs";import{dirname as o,resolve as r}from"node:path";import{fileURLToPath as s}from"node:url";const i=o(s(import.meta.url));export function loadEnv(){try{const o=r(i,"../../.env");if(!n(o))return;const s=t(o,"utf8");for(const t of s.split(/\r?\n/)){const n=t.trim();if(!n||n.startsWith("#"))continue;const o=n.indexOf("=");if(o<=0)continue;const r=n.substring(0,o).trim();let s=n.substring(o+1).trim();(s.startsWith('"')&&s.endsWith('"')||s.startsWith("'")&&s.endsWith("'"))&&(s=s.substring(1,s.length-1)),process.env[r]=s}}catch{}}

package/dist/src/types.d.ts

@@ -0,0 +1,51 @@
+import type { CookieEntry } from "chrome-tools";
+/**
+ * Defines an API endpoint to be fetched by an adapter.
+ */
+export interface Endpoint {
+    /** Full URL of the API endpoint. */
+    url: string;
+    /** HTTP method. Defaults to "GET". */
+    method?: string;
+    /** Additional headers to include in the request. */
+    headers?: Record<string, string>;
+}
+/**
+ * Configuration for defining a website adapter.
+ * Simple adapters declare `endpoints` and get automatic fetch handling.
+ * Complex adapters override `fetchData` for custom multi-step flows.
+ */
+export interface AdapterConfig {
+    /** Unique identifier, typically the domain (e.g. "chatgpt.com"). */
+    id: string;
+    /** Human-readable name (e.g. "ChatGPT / Codex Usage"). */
+    name: string;
+    /** Cookie domain to filter Chrome cookies for this site. */
+    domain: string;
+    /** Short description of what data this adapter fetches. */
+    description: string;
+    /** Endpoints for simple single-fetch adapters. First endpoint is used by default fetchData. */
+    endpoints?: Endpoint[];
+    /** Override for complex multi-step flows (e.g. session token → API call). */
+    fetchData?: (this: WebsiteAdapter, cookies: CookieEntry[], options: QueryOptions) => Promise<unknown>;
+}
+/**
+ * A fully-instantiated website adapter with shared helper methods.
+ */
+export interface WebsiteAdapter extends AdapterConfig {
+    /** Converts a cookie array into a "name=value; ..." header string. */
+    buildCookieString(cookies: CookieEntry[]): string;
+    /** Resolves the User-Agent from options → env → default. */
+    resolveUserAgent(options: QueryOptions): string;
+    /** Fetches a URL and returns parsed JSON, with error handling. */
+    fetchJson(url: string, init?: RequestInit): Promise<any>;
+}
+/**
+ * Options passed when querying a website API.
+ */
+export interface QueryOptions {
+    /** Chrome profile directory name (e.g. "Default", "Profile 1"). */
+    profile?: string;
+    /** Custom User-Agent header for HTTP requests. */
+    userAgent?: string;
+}

package/dist/src/types.js

@@ -0,0 +1 @@
+export{};

package/dist/src/universal-adapter.d.ts

@@ -0,0 +1,10 @@
+import type { WebsiteAdapter } from "./types.js";
+/**
+ * Creates a universal fallback adapter for any domain that doesn't have
+ * a dedicated adapter. Parses the websiteId as a URL and uses the default
+ * single-endpoint fetch flow.
+ *
+ * @param websiteId - A URL or domain string (e.g. "example.com/api/data")
+ * @returns A WebsiteAdapter if the URL is valid, or null otherwise.
+ */
+export declare function createUniversalAdapter(websiteId: string): WebsiteAdapter | null;

package/dist/src/universal-adapter.js

@@ -0,0 +1 @@
+import{defineAdapter as t}from"./base-adapter.js";export function createUniversalAdapter(r){let e=r;e.startsWith("http://")||e.startsWith("https://")||(e="https://"+e);try{const a=new URL(e);return t({id:r,name:r,domain:a.hostname,description:`Universal adapter for ${a.hostname}`,endpoints:[{url:a.href}]})}catch{return null}}

package/dist/src/website/chatgpt.com/chatgpt-adapter.d.ts

@@ -0,0 +1,11 @@
+/**
+ * ChatGPT adapter — fetches rate limit usage from the wham/usage API.
+ *
+ * This is a multi-step flow:
+ *   1. Exchange Chrome cookies for a Bearer JWT via the Next-Auth session endpoint
+ *   2. Use the JWT to query the private wham/usage endpoint
+ *
+ * See request.md in this directory for full endpoint documentation.
+ */
+declare const _default: import("../../types.js").WebsiteAdapter;
+export default _default;

package/dist/src/website/chatgpt.com/chatgpt-adapter.js

@@ -0,0 +1 @@
+import{defineAdapter as e}from"../../base-adapter.js";export default e({id:"codex-usage",name:"ChatGPT / Codex Usage",domain:"chatgpt.com",description:"Fetches ChatGPT rate limit usage and quota details from the private wham/usage API.",async fetchData(e,t){const a=this.buildCookieString(e),s=this.resolveUserAgent(t),o=await this.fetchJson("https://chatgpt.com/api/auth/session",{headers:{Cookie:a,"User-Agent":s,Accept:"application/json"}});if(!o?.accessToken)throw new Error("No login found in browser");return this.fetchJson("https://chatgpt.com/backend-api/wham/usage",{headers:{authorization:`Bearer ${o.accessToken}`}})}});

package/dist/src/website/cursor.com/cursor-adapter.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Cursor.com adapter — fetches the active usage summary.
+ * Simple single-endpoint adapter: just declare the endpoint, BaseAdapter handles the rest.
+ */
+declare const _default: import("../../types.js").WebsiteAdapter;
+export default _default;

package/dist/src/website/cursor.com/cursor-adapter.js

@@ -0,0 +1 @@
+import{defineAdapter as r}from"../../base-adapter.js";export default r({id:"cursor-usage",name:"Cursor Usage",domain:"cursor.com",description:"Fetches the active Cursor usage summary from the private usage-summary API.",endpoints:[{url:"https://cursor.com/api/usage-summary"}]});

package/dist/src/website/ollama.com/ollama-adapter.d.ts

@@ -0,0 +1,2 @@
+declare const _default: import("../../types.js").WebsiteAdapter;
+export default _default;

package/dist/src/website/ollama.com/ollama-adapter.js

@@ -0,0 +1 @@
+import{defineAdapter as e}from"../../base-adapter.js";export default e({id:"ollama-usage",name:"Ollama Usage",domain:"ollama.com",description:"Fetches Ollama plan and usage details from the authenticated settings page.",async fetchData(e,a){const n=this.buildCookieString(e),i=this.resolveUserAgent(a),o=await fetch("https://ollama.com/settings",{method:"GET",headers:{Cookie:n,"User-Agent":i,Accept:"text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8"}});if(!o.ok)throw new Error(`HTTP ${o.status}: ${o.statusText}`);const r=await o.text(),l=s(r,"Session usage"),m=s(r,"Weekly usage");return{time:(new Date).toISOString(),Plan:t(r),"Session Usage":l.usage,"Session Reset":l.reset,"Weekly Usage":m.usage,"Weekly Reset":m.reset}}});function t(e){const t=e.match(/Cloud Usage[\s\S]*?<\/span>[\s\S]*?<span[^>]*>([\s\S]*?)<\/span/i);return t?.[1]?.trim()??"unknown"}function s(e,t){const s=t.replace(/[.*+?^${}()|[\]\\]/g,"\\$&");const a=new RegExp(`<div[\\s\\S]*?<span[^>]*>\\s*${s}\\s*<\\/span>[\\s\\S]*?aria-label="${s}\\s+([^"]+)"[\\s\\S]*?data-time="([^"]+)"`,"i"),n=e.match(a);return{usage:n?.[1]?.replace(/\s+used$/i,"").trim()??"unknown",reset:n?.[2]?.trim()??"unknown"}}

package/dist/src/website-api.d.ts

@@ -0,0 +1,34 @@
+import type { QueryOptions, WebsiteAdapter } from "./types.js";
+/**
+ * All loaded website adapters, populated by `loadAdapters()`.
+ */
+export declare let websites: WebsiteAdapter[];
+/**
+ * Auto-discovers and loads all website adapters from the `website/` directory.
+ *
+ * Scans each subdirectory for a file matching `*-adapter.js` and dynamically
+ * imports it. Each adapter module must have a default export that is a
+ * WebsiteAdapter (created via `defineAdapter()`).
+ *
+ * This is called once on first use — no manual imports needed when adding
+ * new adapters.
+ */
+export declare function loadAdapters(): Promise<void>;
+/**
+ * Finds an adapter by ID or partial domain match.
+ *
+ * @param id - Website identifier (e.g. "chatgpt.com", "chatgpt", "cursor")
+ * @returns The matching adapter or null
+ */
+export declare function getWebsite(id: string): WebsiteAdapter | null;
+/**
+ * Queries a registered website API using decrypted Google Chrome cookies on macOS.
+ *
+ * Cookie retrieval is simplified to a single `getCookies({ domain })` call —
+ * no manual extraction or domain matching needed.
+ *
+ * @param websiteId - The domain or identifier of the website (e.g. "chatgpt.com")
+ * @param options - Retrieval options (profile, userAgent)
+ * @returns The structured website API response
+ */
+export declare function queryWebsite(websiteId: string, options?: QueryOptions): Promise<unknown>;

package/dist/src/website-api.js

@@ -0,0 +1 @@
+import{readdirSync as o}from"node:fs";import{dirname as e,join as r}from"node:path";import{fileURLToPath as t,pathToFileURL as i}from"node:url";import{getCookies as n}from"chrome-tools";import{loadEnv as s}from"./env.js";import{createUniversalAdapter as a}from"./universal-adapter.js";s();const c=e(t(import.meta.url)),f=r(c,"website");export let websites=[];export async function loadAdapters(){if(!(websites.length>0))try{const e=o(f,{withFileTypes:!0});for(const t of e){if(!t.isDirectory())continue;const e=r(f,t.name),n=o(e).find(o=>o.endsWith("-adapter.js"));if(!n)continue;const s=i(r(e,n)).href,a=(await import(s)).default;a?.id&&websites.push(a)}}catch(o){}}export function getWebsite(o){if(!o)return null;const e=o.toLowerCase().trim();return websites.find(o=>o.id.toLowerCase()===e||o.id.toLowerCase().replace(".com","")===e)??null}export async function queryWebsite(o,e={}){await loadAdapters();const r=process.env.PROFILE_PATH||process.env.CHROME_PROFILE_PATH||void 0,t=e.profile||process.env.PROFILE_NAME||void 0;let i,s=getWebsite(o);if(!s&&(s=a(o),!s))throw new Error("No login found in browser");try{i=n({chromeDir:r,profile:t,domain:s.domain,decrypt:!0})}catch{throw new Error("No login found in browser")}if(!i||0===i.length)throw new Error("No login found in browser");return s.fetchData(i,e)}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "website-api",
+  "version": "1.0.1",
+  "description": "CLI and library to fetch website API data using chrome-tools decrypted cookies on macOS",
+  "main": "./dist/src/website-api.js",
+  "type": "module",
+  "bin": {
+    "website-api": "./dist/bin/cli.js",
+    "chrome-website-api": "./dist/bin/cli.js"
+  },
+  "keywords": [
+    "chrome",
+    "cookies",
+    "api",
+    "chatgpt",
+    "codex",
+    "macos",
+    "cli"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "chrome-tools": "^1.0.6",
+    "cli-table3": "^0.6.5",
+    "commander": "^14.0.3"
+  },
+  "devDependencies": {
+    "@types/node": "^25.9.1",
+    "terser": "^5.43.1",
+    "typescript": "^6.0.3"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "node scripts/build.mjs",
+    "check:secrets": "node scripts/check-secrets.mjs",
+    "release": "pnpm version patch && pnpm publish --access public",
+    "start": "node dist/bin/cli.js"
+  }
+}