## SearchMD - Web Search for LLM Agents

**Endpoint:** `GET https://searchmd.rafaismy.name/search`

**Parameters:**

| Param | Required | Default | Description |
|-------|----------|---------|-------------|
| `query` | yes | — | Search query |
| `limit` | no | `15` | Total number of results |
| `topic` | no | `general` | `general` or `news` |
| `freshness` | no | — | `day`, `week`, or `month` |
| `depth` | no | `full` | `basic` (snippets) or `full` (raw extracted content) |
| `domains` | no | — | Comma-separated domain filter (e.g. `github.com,react.dev`) |
| `excludeDomains` | no | junk sites | Domains to exclude (`none` to disable default filtering) |
| `instructions` | no | auto | Set `false` to hide this block |
| `cache` | no | `true` | Set `false` to bypass cache and get fresh results |

**Example:**
`/search?query=next.js+app+router&limit=5&freshness=week`

**Tips:**
- Use `freshness=day` for fast-moving topics like releases or breaking changes
- Use `topic=news` for current events