# Ubient Go™ Search

> Ubient Go Search is a free HTTP-based search service that delivers JSON results for applications, scripts, and AI agents without requiring an API key. It features customizable search parameters, instance configuration details, and an easy AI skill installation guide. Discover how to programmatically search the web, handle responses, and empower your AI agents effortlessly.

## What is Ubient Go Search?

Ubient Go Search accepts a search query over HTTP and returns the results as JSON. Applications, scripts, and AI agents can send a request, read the response, and process the results programmatically, without an API key.

Ubient Go Search is available at `https://go.ubient.dscloud.biz`.

### At a glance

| Property | Description |
| --- | --- |
| Service name | Ubient Go Search |
| Base URL | `https://go.ubient.dscloud.biz` |
| Search endpoint | `/search` |
| Configuration endpoint | `/config` |
| HTTP methods | `GET`, `POST` |
| Response format | JSON (`format=json`) |
| Request encoding | UTF-8 search terms and URL encoding |
| Authentication | None. No API key is required. |

### What you can do with Ubient Go Search

- Search over HTTP with `GET` or `POST` and receive the results as JSON.
- Refine a search with categories, language, page number, time range, and SafeSearch level.
- Retrieve the instance’s current categories and search engine information from the `/config` endpoint.
- Give an AI agent web search by installing the Ubient Go search skill.

## Documentation

Ubient Go Search has two guides.

### API Guide

**For:** scripts, applications, and AI agents that call the Ubient Go Search API, and the people who build them.

The API Guide explains how to send search requests and how to handle the responses. It covers:

- Request parameters: `q`, `format`, `categories`, `language`, `pageno`, `time_range`, and `safesearch`
- Sending `GET` and `POST` requests, including searches with Korean terms
- The JSON response structure: search results, infoboxes, suggestions, and engines that did not respond
- A Python example that uses only the standard library
- Retrieving the service configuration from `/config`
- HTTP status codes and a recommended error-handling sequence
- Usage considerations such as encoding, differences between search engines, and optional response fields

[Read the API Guide](https://ubient.dscloud.biz/docs/service/go-search/go-search-api/)

### AI Agent Skill Installation Guide

**For:** AI agents. If you are a person, give your agent the URL of this guide and ask it to install the Ubient Go search skill.

This guide is written for AI agents. It explains how an agent installs one file, `SKILL.md`, so that it can search the web through Ubient Go Search. It covers:

- What to confirm before installing: user consent, installation scope, inspection of the downloaded file, and privacy
- A step-by-step installation procedure with commands for Linux, macOS, and Windows PowerShell
- The skills directory for each supported agent: Claude Code, OpenAI Codex, Gemini CLI, Google Antigravity, Cursor, GitHub Copilot, Windsurf, and Cline
- An `AGENTS.md` fallback for agents that do not support skills
- How to update and uninstall the skill
- How to verify the skill with a real search
- Troubleshooting and frequently asked questions

[Read the AI Agent Skill Installation Guide](https://ubient.dscloud.biz/docs/service/go-search/go-search-skill/)

## Where to start

| If you want to… | Read |
| --- | --- |
| Call the search API from a script or application | [API Guide](https://ubient.dscloud.biz/docs/service/go-search/go-search-api/) |
| Understand the fields in a JSON response, including empty results and engines that did not respond | [API Guide](https://ubient.dscloud.biz/docs/service/go-search/go-search-api/) |
| Find out which categories and search engines the instance provides | [API Guide](https://ubient.dscloud.biz/docs/service/go-search/go-search-api/), Retrieving Service Configuration |
| Let an AI agent search the web with Ubient Go Search | [AI Agent Skill Installation Guide](https://ubient.dscloud.biz/docs/service/go-search/go-search-skill/) |
| Update or remove an installed skill | [AI Agent Skill Installation Guide](https://ubient.dscloud.biz/docs/service/go-search/go-search-skill/), Update and uninstall |

## Quick example

The following request searches for a Korean term and asks for a JSON response.

```
curl -sS -G "https://go.ubient.dscloud.biz/search" \
  --data-urlencode "q=대한민국" \
  --data-urlencode "format=json"
```

On Windows PowerShell, use `curl.exe` instead of `curl`.

- ### [API Guide](https://ubient.dscloud.biz/docs/service/go-search/go-search-api/)API

  The Ubient Go Search API provides a private, privacy-focused search interface for applications and AI agents. This comprehensive guide covers making HTTP GET and POST requests, using key parameters, parsing JSON response structures, inspecting instance settings via the /config endpoint, handling HTTP errors, and integrating search functionality programmatically with Python code examples.
- ### [AI Agent Skill Installation Guide](https://ubient.dscloud.biz/docs/service/go-search/go-search-skill/)Skill

  This guide explains how to install and configure the Ubient Go Search skill for AI agents. It provides step-by-step instructions for installing \`SKILL.md\` in agent directories, validating downloads, managing project scope, and enabling web search capabilities across supported platforms such as Claude Code, Cursor, and Codex, without requiring API keys or additional dependencies.
  - [SKILL.mdMarkdown](https://ubient.dscloud.biz/docs/service/go-search/go-search-skill/skill/)
  - [AGENTS.mdMarkdown](https://ubient.dscloud.biz/docs/service/go-search/go-search-skill/agents/)