# vutuv

vutuv is a free social/business network. Every public page is also
available in agent-friendly formats under the same URL plus an extension:

- `<page>.md`   — Markdown with YAML frontmatter (or `Accept: text/markdown`)
- `<page>.txt`  — plain text, 80 columns (or `Accept: text/plain`)
- `<page>.json` — flat JSON document (or `Accept: application/json`)
- `<page>.xml`  — flat XML document (or `Accept: application/xml`)

Labels default to English; add `?lang=de` for a German rendering. The
member-written content keeps its original language either way.

Documents carry `schema_version` (currently 2;
additions are non-breaking) and `generated_at`. Responses carry a
`Content-Signal` header; respect it — members can opt out of search/AI use.

## Pages

- `/<username>` — member profile (also `/<username>.vcf` as vCard 3.0)
- `/<username>/posts` — post archive, also `/<username>/posts/<year>[/<month>[/<day>]]`
- `/<username>/posts/<id>` — a single post with replies
- `/<username>/followers`, `/<username>/following`, `/<username>/connections` — people lists
- `/<username>/<section>` — the profile sections in full: `work_experiences`,
  `links`, `social_media_accounts`, `addresses`, `phone_numbers`, `emails`
  (public addresses only), `tags`; a single entry lives at
  `/<username>/<section>/<id-or-slug>`
- `/tags/<tag>` — a tag and its most endorsed members
- `/listings/most_followed_users` — the most followed members
- `/ads` — the daily text ad: price, conditions, next available day
  (booking happens online and requires a login)

List pages paginate with `?page=N`.

## Discovery

- `/sitemap.xml` — sitemap index (members, posts, tags, static pages)
- `/<username>/posts/feed.xml` — a member's posts as RSS 2.0, full content
- `/posts/feed.xml` — the latest public posts site-wide (RSS 2.0)
- `/.well-known/agent-skills/index.json` — agent-skills discovery
  (Cloudflare draft); the skill teaches this whole surface
- `/.well-known/security.txt` — vulnerability-report contact (RFC 9116)

Responses carry `Link` headers (`describedby` -> this file, `sitemap`,
per-page `alternate` siblings, `canonical` on the agent documents) and
Accept-negotiated documents name their extension URL in
`Content-Location`. Profiles embed schema.org JSON-LD (Person), post
permalinks a BlogPosting.

## API

An authenticated REST/JSON API for third-party apps and scripts lives at
`/api/2.0` (Bearer tokens or OAuth 2, scoped permissions, 5,000
requests/hour, signed webhooks). Documentation: `/developers` — also as
raw Markdown at `/developers.md`, `/developers/authentication.md`,
`/developers/cookbook.md` (task recipes: posting, direct messages, ...),
`/developers/data-model.md` (entities and visibility rules),
`/developers/reference.md` and `/developers/webhooks.md`.

vutuv is open source: https://github.com/wintermeyer/vutuv — bug reports
and feature requests via GitHub issues.