openai-web-search

Retrieve real-time web information via the OpenAI Responses API.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/SHAY5555-gif/airduct-site --skill openai-web-search
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openai-web-search
Source: https://github.com/SHAY5555-gif/airduct-site/tree/main/.claude/skills/openai-web-search
Command: npx skills add https://github.com/SHAY5555-gif/airduct-site --skill openai-web-search

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill enables real-time web information retrieval directly from the terminal by using OpenAI's GPT-5.2 web_search tool. It lets you fetch fresh data without leaving your CLI, reducing wait times and context-switching.

Core Features & Use Cases

  • Real-time web search: Query current information using the web_search tool via the OpenAI API.
  • Domain filtering & sources: Optionally constrain results to trusted domains and retrieve source lists.
  • Streaming/results parsing: Receive results as they arrive and extract the relevant data for immediate use.

Quick Start

bash ~/.claude/skills/openai-web-search/gpt-search.sh "YOUR_QUERY_HERE"

Frequently Asked Questions about openai-web-search

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search the web from the command line in real time?

Real-time web search from your terminal uses OpenAI's GPT-5.2 web_search tool via the OpenAI Responses API. Run bash ~/.claude/skills/openai-web-search/gpt-search.sh "YOUR_QUERY_HERE" with a configured OPENAI_API_KEY to fetch current information without leaving the CLI.

Can I filter web search results to specific domains?

Domain filtering is supported within the gpt-search.sh script, allowing you to constrain results to trusted domains. The Skill retrieves source URLs alongside results, enabling verification and domain-based refinement of your queries.

What do I need to use OpenAI web search from bash?

You need a configured OPENAI_API_KEY environment variable, curl access to the OpenAI Responses API, and the gpt-search.sh script. The Skill produces structured outputs including sources and works directly in terminal workflows.

How does streaming delivery work with CLI web search?

Streaming delivery returns results as they arrive from the OpenAI Responses API, letting you process and extract relevant data immediately. The script parses streamed output into structured format for terminal use.

What's the difference between CLI web search and standard API queries?

CLI web search via this Skill retrieves current web information on demand without context-switching, whereas standard API queries return only indexed data. This approach reduces latency and provides fresh, domain-filtered results with source extraction built in.