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
GETorPOSTand 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
/configendpoint. - 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, andsafesearch - Sending
GETandPOSTrequests, 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
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.mdfallback 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
Where to start
| If you want to… | Read |
|---|---|
| Call the search API from a script or application | API Guide |
| Understand the fields in a JSON response, including empty results and engines that did not respond | API Guide |
| Find out which categories and search engines the instance provides | API Guide, Retrieving Service Configuration |
| Let an AI agent search the web with Ubient Go Search | AI Agent Skill Installation Guide |
| Update or remove an installed skill | AI Agent Skill Installation Guide, 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 GuideAPI
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 GuideSkill
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.