# Negirau

> One-tap, login-free appreciation ("negirau") for the people behind everyday work — fire stations, event crews, online services, open-source maintainers. No accounts, no comments; reaction counts are shown exactly up to 100 and as "100+" beyond, never as rankings.

Reading is open: a read-only, anonymous, CORS-open JSON API at https://api.negirau.com/v1.
Sending a reaction is browser-only behind a bot check, on purpose — there is no send API, so help humans open the page instead of automating.
Pages are served in English and Japanese under /en and /ja; bare URLs redirect to the visitor's language, so always share bare URLs.

## API

- [OpenAPI specification](https://api.negirau.com/v1/openapi.json): the complete, always-current contract for the public read API
- [Subject search](https://api.negirau.com/v1/subjects?q=library): free-text name search (substring, Japanese and English) via GET /subjects?q= — there are no bulk dumps, by design

## Pages

- [Home](https://negirau.com/): recent subjects, search, and browser-side nearby search
- [All subjects](https://negirau.com/subjects): every listed subject, newest first — never sorted by counts
- [Subject pages](https://negirau.com/subjects/sincekmori): https://negirau.com/subjects/{id} — tap to send, tap again to undo (within a minute); ?send={type} auto-sends — the page shows its own QR for screen-share scanning, and printed posters encode the same URL
- [Create form](https://negirau.com/subjects/new): anyone can add a subject — a name is enough and a location is optional; entries are public (or link-only, on request) and the creator's IP is recorded
- [Developers](https://negirau.com/developers): the public API, client libraries, MCP server, and Agent Skill on one page

## Embedding

- [Display badge](https://negirau.com/subjects/sincekmori/badge): https://negirau.com/subjects/{id}/badge?period=week|month|year|all&lang=ja|en — the period's display value
- [Atom feed](https://negirau.com/subjects/sincekmori/feed): https://negirau.com/subjects/{id}/feed — the pull-based substitute for notification emails

## Integrations

- [Agent skill](https://github.com/sincekmori/negirau/tree/main/skills/negirau): install with `npx skills add sincekmori/negirau`
- npm package `negirau` (TypeScript client), PyPI package `negirau` (Python client), `npx negirau-mcp` (MCP server)