gws-search

Perform Google Programmable Search Engine web searches with structured JSON output.

7|2|Updated Jan 22, 2026
One-click install
npx skills add https://github.com/omriariav/workspace-cli --skill gws-search
Or copy as Structured Prompt for Agentโ–ผ
Please help me install this Agent Skill.
Skill: gws-search
Source: https://github.com/omriariav/workspace-cli/tree/main/skills/search
Command: npx skills add https://github.com/omriariav/workspace-cli --skill gws-search

SYSTEM DOCUMENTATION & REQUIREMENTS

๐Ÿ’ก This Skill includes references (resource) components.

What problem does it solve?

This Skill allows users to perform web searches using Google Programmable Search Engine directly from their terminal, providing structured results for automation and scripting.

Core Features & Use Cases

  • Web Search: Execute general web searches with custom queries.
  • Site-Specific Search: Limit search results to a particular website.
  • Image Search: Find images based on search terms.
  • Pagination: Retrieve results beyond the default limit.
  • Use Case: An AI agent needs to find the latest documentation for a specific library on its official website. It can use gws search with the --site flag to get precise results.

Quick Start

Search the web for "latest advancements in AI".

Frequently Asked Questions about gws-search

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

FAQPage Schema
How do I perform a web search using Google Programmable Search Engine from the command line?โ–ผ

You can perform a web search from the command line by executing queries through the Google Programmable Search Engine, which returns structured JSON output suitable for automation and scripting.

Do I need an API key to use Google Programmable Search for automation?โ–ผ

Yes, you need a separate API key and a search engine ID configured to use Google Programmable Search capabilities for your custom search automation tasks.

Can I limit Google web search results to a specific website in my terminal?โ–ผ

Yes, you can limit web search results to a specific website by using the site filtering flag, allowing you to target precise domains like official documentation sites.

How do I get structured JSON output for Google search queries in a script?โ–ผ

Executing Google search queries through this command line interface directly yields structured JSON output, making the results immediately parsable for downstream automation scripts.

Does Google Programmable Search support image search and result pagination?โ–ผ

Yes, Google Programmable Search supports finding images based on search terms and retrieving results beyond the default limit through pagination capabilities.