# better-search

A [TollBit](https://tollbit.com) agent function that gives agents
high-quality web search.

## Capabilities

- **search** — web search scoped to the staked property's site. _$0.001/call._
- **contextualize** — from an article/post title, find similar coverage elsewhere
  on the web (excluding the property's own domain). _$0.005/call._
- **random-search** — return one random page from the staked property. _free._

## For agents

- **OpenAPI spec:** [`/openapi.yaml`](/openapi.yaml) — the machine-readable contract.
- **Usage guide (SKILL.md):** [`/skill`](/skill) — workflows and how to chain the commands.
- **Health:** [`/health`](/health)

Calls are routed through TollBit:

```
tollbit connect <property> better-search search --query="..."
tollbit connect <property> better-search contextualize --title="..."
```

Capability calls require an `x-tollbit-agent-payment-token` header (TollBit mints
it) and an `x-tollbit-property` header, which attributes the call to a property
and scopes `search` to that site.