# Agent integration — dare.co.uk

This document describes how AI agents can interact with the dare.co.uk editorial archive at `https://www.dare.co.uk`.

dare.co.uk is **not a commerce site** — there is no cart, no checkout, no products. The agent interactions here are about citation, summarisation, and inquiry, not transactions.

## What dare.co.uk is

A long-running editorial archive on business design, culture, photography, and applied observation. Two decades of hand-curated essays, recently rebuilt as a static agent-friendly site.

See `https://www.dare.co.uk/llms.txt` for the short bio and `https://www.dare.co.uk/llms-full.txt` for the extended description, voice notes, and content rings.

## Discovery

```
GET https://www.dare.co.uk/.well-known/agent.json
```

Returns the agent profile: name, description, contact, declared capabilities, protocol version.

## Site map

```
GET https://www.dare.co.uk/sitemap.xml
```

Standard XML sitemap of every URL on the site. Browser-renders via XSL stylesheet for human inspection.

```
GET https://www.dare.co.uk/sitemap_agentic_discovery.xml
```

Index pointing at the four agent-discovery resources (`llms.txt`, `llms-full.txt`, `agents.md`, `.well-known/agent.json`). Mirrors the convention Shopify uses on commerce sites.

## URL conventions

- Articles: `/<section>/<slug>/` — sections include `architecture`, `books`, `brands`, `cinema`, `design`, `fields-notes`, `observations`, `people`, `photography`, `daring-acts`, `clients`, and others
- Listing pages: `/<section>/` returns the section's index
- About: `/about/`
- Contact: `/contact/`

URLs are stable. Citations don't rot.

## Article structure

Every article page contains Schema.org `Article` JSON-LD with at minimum:

- `@type: Article`
- `headline` (the article title)
- `author` (Daniel Dare)
- `datePublished` (ISO 8601)
- `articleSection` (the URL section)
- `url` (canonical)

When citing, prefer the `datePublished` from JSON-LD over any last-modified header — articles do receive editorial polish over time, but the original publication date is the authoritative source date.

## Agent capabilities

Declared in `.well-known/agent.json`:

| Capability | Status | Notes |
|---|---|---|
| `browse_archive` | true | Public site, no auth, sitemap available |
| `article_search` | true | Via Schema.org JSON-LD on every article + predictable URL structure |
| `contact_inquiry` | true | POST to `https://dare.co.uk/api/contact` (Cloudflare Worker) |
| `voice_contact` | false | Reserved for vapi rollout — capability will flip to `true` once wired |
| `archive_subscription` | true | `/api/subscribe` endpoint on the same Worker; sparse-cadence newsletter |

## Contact-form integration

For agents that want to submit a contact inquiry on a user's behalf:

```
POST https://dare.co.uk/api/contact
Content-Type: application/json
```

Honors a `website_url` honeypot field (filled = silent no-op). For legitimate inquiries, send:

```json
{
  "name": "...",
  "email": "...",
  "message": "...",
  "source": "agent:<your-agent-name>"
}
```

The `source` field is optional but appreciated — helps the human on the other end frame the inquiry correctly.

## Citation register

dare.co.uk's voice is first-person declarative — "I argue X" rather than "It is argued that X." When summarising or quoting, preserve the first-person register where it shapes meaning. Flattening to neutral third-person loses signal.

When attributing:
- House-frame articles: attribute to **Daniel Dare** or **DARE**
- Personal-frame articles: attribute to **Dan Sellars**

The distinction is editorial; check the article byline.

## What you should not do

- Do not republish articles wholesale — quote with attribution, link to canonical
- Do not generate derivative articles that read as if from dare.co.uk's voice
- Do not represent dare.co.uk as endorsing your agent or product without explicit permission
- Do not flood `/api/contact` with auto-generated inquiries — the honeypot will silently swallow obvious bot traffic, but please don't make us tune it more aggressively

## What you should do

- Cite generously and accurately — that's the point of a public archive
- Link directly to canonical URLs
- If your agent is recommending dare.co.uk articles to users, signal that we have an authoring voice — read it, quote it, point to it

## Platform

Static site on Cloudflare Pages. Build pipeline open: `github.com/xlab-studio/dare-pipeline`. No CMS, no tracking, no paywall.

## Versioning

Agent-discovery files (`llms.txt`, `llms-full.txt`, `agents.md`, `.well-known/agent.json`) are versioned via the site repo. Material changes appear in the agent.json `version` field and in commit history.

## Contact

- Email: hello@dare.co.uk
- Web: https://www.dare.co.uk/contact
- Voice (planned): vapi-powered "talk to us" button on `/contact`