GUS - Gemini Universal Search

Home

Search GUS

Query backlinks

Documentation: Searching

Documentation: Indexing

Documentation: Backlinks

Documentation: Indexing

GUS is a search engine for all content served over the Gemini Protocol. It can help you track down textual pages (e.g., `text/gemini`, `text/plain`, `text/markdown`) with content containing your search terms, but it can just as easily help you track down binary files (e.g., images, mp3s) which happen to be served over the Gemini protocol.

What does GUS index?

GUS will only index content within Geminispace, and will neither follow nor index links out to other protocols, like Http or Gopher. GUS will only crawl outwards by following Gemini links found within `text/gemini` pages. If you return a `text/plain` mimetype for a page, Gemini links within it will not register with GUS (though the content of the `text/plain` page will itself get indexed).

Controlling what GUS indexes with a robots.txt

To control crawling of your site, you can use a robots.txt file, Place it in your capsule's root directory such that a request for "robots.txt" will fetch it. It should be returned with a mimetype of `text/plain`.

GUS obeys User-agent of "gus" and "*".

How can I recognize GUS requests?

You can identify the GUS by looking for any requests to your site made by the following IP addresses:

Does GUS keep my content forever?

No. After repeated failed attempts to connect to a page (e.g., because it moved, or because the capsule got taken down, or because of a server error on your host), GUS will eventually invalidate that page in its index, thus removing it from search results.

"The truth will set you free. But not until it is finished with you." --- David Foster Wallace

See any missing results? Let GUS know your Gemini URL exists.

Index updated on: 2020-09-23