---
title: Agent Seek docs
description: Agent Seek docs — API, OpenAPI, and search UI for humans and agents.
canonical: /docs.md
last-updated: 2026-09-20
---

# Agent Seek docs

Agent Seek is agent search: cheap You.com recall + TypeSafe Jev taste → ranked web results. Google-simple for people. Judgment-native for agents.

## Install the skill

Efficient path: **skill → [llms.txt](/llms.txt) → [auth.md](/auth.md) → MCP or REST**.

Stable skill URLs (same file):

- [/.well-known/agent-skills/agent-seek/SKILL.md](/.well-known/agent-skills/agent-seek/SKILL.md)
- [/skills/agent-seek/SKILL.md](/skills/agent-seek/SKILL.md)
- Index: [/.well-known/agent-skills/index.json](/.well-known/agent-skills/index.json)

**Cursor:** save `SKILL.md` as `.cursor/skills/agent-seek/SKILL.md` (project) or `~/.cursor/skills/agent-seek/SKILL.md` (user).

**Other coding agents:** download `SKILL.md` from the well-known URL, or link it from the index.

Then read [llms.txt](/llms.txt), authenticate via [auth.md](/auth.md), and call `POST /v1/search` or MCP ([/mcp](/mcp), [server card](/.well-known/mcp/server-card.json)).

## Humans

- Open the [search UI](/) — type a query and press **Enter**.
- Each result shows a **relevance meter**; hover for a signal breakdown (UI label for `prompt_injection` is **Injection risk**).
- UI and API both default to deep mode (k=10). No Mode/Order controls. Pass mode=snip on the API for the cheaper path.

## Agent Seek API

Crawlable developer page: [Agent Seek API](/developers). Contract: `POST /v1/search`. Schema: [/openapi.json](/openapi.json). Swagger: [/api/docs](/api/docs). Auth: [Agent Seek authentication](/auth.md).

## Agents (primary)

Live prototype base URL: `https://agentseek.dev` (alternate: `https://gitmaxd-agent-seek.exe.xyz`)

Auth header:

```
Authorization: Bearer $AGENT_SEEK_API_KEY
```

Contract: `POST /v1/search`

```json
{
  "q": "your query",
  "k": 10,
  "max_candidates": 50,
  "mode": "deep",
  "nocache": false
}
```

- `mode`: `deep` (default — Stage A survivor fetch, cap 12; not a full-web crawl) or `snip` (title/URL/snippet, cheaper).
- `k` 1–25 (default 10) · `max_candidates` 1–100 (default 50).
- Results include `score`, `flags`, and optional `signals`: answerability, authority, on_topic, states_sought_fact, subject_match, spam, prompt_injection.
- Hard gates (order, fail-open if a parse is missing): `subject_match` < 0.55, then `is_republisher` ≥ 0.55, then `prompt_injection` ≥ 0.55 exclude from `results` (still in `raw_results`). UI label: **Injection risk**.

**When to use:** need a small set of high-relevance URLs/snippets for research or RAG.

**When not:** generative answers, unbounded crawl, or more than 100 candidates.

```bash
curl -sS -X POST "https://agentseek.dev/v1/search" \
  -H "Authorization: Bearer $AGENT_SEEK_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"Introducing System One Models Jev","k":10,"mode":"deep"}'
```

See [Agent Seek API](/developers), [auth.md](/auth.md), [agents.md](/agents.md), [About Agent Seek](/about), and the [Agent Seek skill](/skills/agent-seek/SKILL.md).

## Also

- `GET /health` — liveness + version
- [Agent Seek sandbox](/v1/sandbox) — zero-auth canned SearchResponse
- [Agent Seek OpenAPI](/openapi.json) · [Swagger](/api/docs) · [ReDoc](/api/redoc) · [OpenAPI markdown](/api/docs.md)
- [llms.txt](/llms.txt) · [docs/llms.txt](/docs/llms.txt) · [api/llms.txt](/api/llms.txt)
- [pricing](/pricing) · [Agent Seek authentication](/auth.md) · [versioning](/docs/versioning.md)
- [Agent Seek MCP](/mcp) · [OAuth AS](/.well-known/oauth-authorization-server)