# better-search

A [TollBit](https://tollbit.com) agent function that gives agents web search,
backed by the [Brave Search API](https://brave.com/search/api/).

## 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._

## 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); the optional `x-tollbit-property` header attributes the call to a property
and scopes `search` to that site.