{
  "mcpServers": {
    "openai_websearch": {
      "command": "node",
      "args": ["/path/to/openai_websearch/index.js"]
    }
  }
}

# Local install from repo
git clone https://github.com/hffmnnj/openai_websearch.git
cd openai_websearch && npm link

# Or add as a dependency in package.json
"dependencies": {
  "openai_websearch": "github:hffmnnj/openai_websearch"
}

import { search, imageSearch } from 'openai_websearch';

// Web search
const results = await search('smart ring market size 2026');
console.log(results.text);
console.log(results.searchQueries);  // queries OpenAI actually ran
console.log(results.usage);          // token counts

// Image search
const images = await imageSearch('oura ring product photos');
console.log(images.text);            // URLs and descriptions

import { createClient } from 'openai_websearch';

// Custom client with explicit options
const client = createClient({
  model: 'gpt-5.6-luna',           // default model
  authPath: '/custom/auth.json',   // custom codex auth path
});

// Use per-call options
const fast = await client.search('quick fact', { contextSize: 'low' });
const deep = await client.search('thorough research', { contextSize: 'high', model: 'gpt-5.6-luna' });
const imgs = await client.imageSearch('competitor screenshots');

const client = createClient({
  accessToken: 'eyJhbG...',     // raw JWT
  refreshToken: 'rt.1.AAB...',  // for auto-refresh
  accountId: 'uuid-here',
});

const result = await client.search('test query');

{
  text: string;              // The answer / search results
  searchQueries: string[];   // Queries OpenAI actually searched for
  usage: {
    input_tokens: number;
    output_tokens: number;
    total_tokens: number;
  } | null;
  model: string;             // Model used for this request
}