# Levirge Search

Levirge Search helps AI agents find and read public sources. It returns
structured search results, clean page content and explicit retrieval errors.

## Use Search

1. Call `search` when you need to find candidate sources.
2. Call `fetch` when you already have a URL.
3. For an unfamiliar source, use `schema: true` before requesting the payload:
   - JSON returns its inferred shape as `select`-ready paths.
   - Markdown and text return a heading outline.
4. Use `select` to retrieve only the required JSON fields or matching Markdown
   sections.
5. Use `max_bytes` when you need a hard response-size limit.
6. For several URLs, use `fetch_async`, then collect their status and content
   with `fetch_results`.

Search results contain titles, URLs and snippets. `fetch` returns clean Markdown
for pages and raw, parseable JSON for APIs. A route note identifies how Markdown
content was retrieved.

If direct retrieval fails, Search can retry the public page in a full browser.
The tool reports failures with their cause instead of returning blocked or
challenge content as a valid page.

## Boundaries and retention

Search reads public pages. It does not bypass logins or paywalls. Bulk
scraping is not supported or allowed — reads are paced per source at a
human rate, and workspaces detected scraping in bulk are suspended and
investigated.

Retrieved content is cached for 24 hours. Repeated reads may be served from that
cache. Your workspace records each search and retrieval; the retrieved content
remains available for 24 hours.

## Connect

- MCP endpoint: `https://search.levirge.com/mcp`
- Definition: [https://levirge.com/search/mcp.json](/search/mcp.json)
- Both products: [https://levirge.com/mcp.json](/mcp.json)
- Auth: OAuth, negotiated on connect — or `Authorization: Bearer <token>`
  as a fallback
- Verify: call `stealth_list` — read-only, returns the stealth-domain registry
- Product and examples: `https://levirge.com/search`
- Contact: `https://levirge.com/contact`

### Claude Code

`claude plugin marketplace add levirge/search`

`claude plugin install search@levirge-search`

### Codex

`codex plugin marketplace add https://github.com/levirge/search`