API ВЕГА
English

Posy — страница со ссылками в био, которая выглядит сделанной вручную

Выберите стиль, добавьте ссылки и опубликуйте страницу. Редактируйте её сами или поручите это своему AI.

Бесплатный проект с открытым исходным кодом. Пользуйтесь им на posy.page или установите на собственном сервере.

Сайт · Документация · Подключите свой AI · Установите на собственном сервере · Участие в разработке

Что такое Posy

Posy — страница со ссылками в био, которая выглядит сделанной вручную. Выберите стиль, добавьте ссылки и опубликуйте страницу.

Редактируйте её самостоятельно в спокойной студии или попросите об этом свой AI. Ваша страница — это небольшой JSON-файл, который можно взять с собой куда угодно.

Стили оформления

Одни и те же ссылки могут выглядеть как деревянный стол с полароидными снимками, японская гравюра, открытый рабочий стол, акварель, двухцветная печать или экран нетраннера.

Для каждого стиля доступны четыре палитры, которые можно менять в любое время.

На posy.page стили Painted, Desk и Lofi доступны бесплатно, остальные — в версии Pro. При самостоятельном размещении доступны все стили.

Посмотрите их в галерее стилей.

Посмотрите, как каждый стиль выглядит на компьютере

Плитки, палитры и макеты

ПлиткаСодержание
СсылкаFavicon, заголовок и необязательное изображение для предпросмотра
Соцсеть29 платформ (X, Instagram, GitHub, LinkedIn, YouTube, TikTok, Bluesky, Threads, Substack…) и электронная почта
ЗаметкаКороткий текст с полужирным и курсивным начертанием, а также ссылками
РазделЗаголовок, который начинает новую группу плиток
ИзображениеФотография или иллюстрация, к которой можно добавить подпись и ссылку
ВидеоYouTube; загружается только при воспроизведении
МузыкаВстроенный плеер Spotify
GitHubРепозиторий с актуальными данными о звёздах и языке программирования; обновляется ежедневно

Доступны три макета: bento (сетка), list (одна колонка) и canvas (плитки можно размещать свободно). Фотографии можно отображать в стилях natural, mono, dither или ascii.

Кроме палитр, предусмотренных для каждого стиля, доступны Cream, Lavender, Mint, Sky, Peach, Paper, Blush, Sage, Midnight, Mocha, Dusk и Ocean, любой акцентный цвет и сочетания шрифтов.

Создайте свою страницу

Займите своё имя на posy.page. Вставьте ссылку, чтобы добавить плитку, перетащите плитки для изменения порядка и нажмите Опубликовать. Страница будет готова через минуту.

Пока просто присматриваетесь? Откройте posy.page/new, вставьте несколько ссылок и посмотрите, как будет выглядеть страница, ещё до регистрации.

Бесплатная версия, Pro и самостоятельное размещение

Бесплатная версия posy.pageposy.page ProСамостоятельное размещение
Плитки, редактор, API, MCP, CLIВсё доступноВсё доступноВсё доступно
Стили оформленияPainted, Desk, LofiВсеВсе
Собственный доменНетДа, HTTPS настроен за васДа, укажите адрес своего сервера
АналитикаБазоваяЗа 12 месяцев + CSVЗа 12 месяцев + CSV
Подпись «Сделано с Posy»ОтображаетсяМожно скрытьМожно скрыть
Настройка и обслуживаниеНе требуютсяНе требуютсяНа вашей стороне

Pro стоит $5 в месяц или $48 в год. Страница работает одинаково везде: на одном сервисе выберите Settings → Download page.json, а на другом — Import page.json.

Подключите свой AI

У Posy есть размещённый MCP-сервер, с помощью которого ваш AI может создавать и редактировать страницу. Войдите в аккаунт Posy — копировать ключ не нужно.

Все изменения сохраняются в черновике. Страница не будет опубликована, пока вы или ваш AI не выполните публикацию.

https://posy.page/api/mcp

В один клик

За несколько шагов

claude mcp add --transport http posy https://posy.page/api/mcp   # Claude Code, затем /mcp → Authenticate
codex mcp add posy --url https://posy.page/api/mcp               # Codex

В ChatGPT откройте Plugins, нажмите +, выберите Add custom MCP server, вставьте URL и выберите OAuth.

На собственном сервере используйте https://YOUR-POSY/api/mcp. Posy включён в официальный реестр MCP как io.github.Himanshu-Sangshetti/posy.

Нет коннектора? Передайте AI файл страницы

Любой чат может создать страницу в виде небольшого JSON-файла. Вставьте его на posy.page/new, и он превратится в готовую страницу.

Можно обойтись и без файла: AI может передать вам ссылку, которая откроет рабочий предпросмотр без входа в аккаунт.

https://posy.page/new?name=Mira%20Sol&look=washi&links=https://github.com/mira,hi@mira.so

Файл страницы, инструменты MCP, REST, llms.txt и CLI

{
  "posy": 1,
  "name": "Mira Sol",
  "bio": "Writer and editor.",
  "location": "Lisbon",
  "look": "washi",
  "links": [
    "https://substack.com/@mira",
    "https://x.com/mira",
    "hi@mira.so",
    { "heading": "Writing" },
    "https://mira.so/letters"
  ]
}

Описание всех полей: файл страницы.

ИнструментНазначение
get_pageПоказывает черновик, публичный URL и дальнейшие действия
create_pageРегистрирует имя пользователя и создаёт страницу (один раз)
import_pageЗагружает страницу целиком из файла страницы
add_tileДобавляет одну или несколько ссылок. Posy автоматически выбирает подходящий тип плитки
update_tile, move_tile, remove_tileИзменяет, перемещает или удаляет плитку
set_theme, set_profileНастраивает стиль, цвета, шрифты, имя и описание
publishПубликует черновик
list_optionsПоказывает доступные стили, палитры, шрифты и размеры
ИнтерфейсРасположение
REST/api/v1/page с ключом Bearer со страницы Agents. Спецификация: /openapi.json, руководство: справочник API
Общедоступный JSON/api/v1/public/ для любой опубликованной страницы
llms.txtposy.page/llms.txt для приложения, //llms.txt для любой страницы
Схемыschema/page.schema.json и /schema/brief.schema.json
ПлагинНавыки Claude Code и Cursor в каталоге plugin/
export POSY_URL=https://posy.page POSY_API_KEY=posy_...
npm run posy -- add https://github.com/owner/repo --size w
npm run posy -- theme --preset moonlit --layout list
npm run posy -- publish

Полное руководство: docs/ai-agents.md. Работаете с этим репозиторием через coding agent? Прочитайте AGENTS.md.

Установите Posy на собственном сервере

Или запустите с помощью Docker:

git clone https://github.com/Himanshu-Sangshetti/posy.git && cd posy
docker build -t posy . && docker run -p 3000:3000 -v posy-data:/data \
  -e NEXT_PUBLIC_SITE_URL=http://localhost:3000 -e BETTER_AUTH_URL=http://localhost:3000 \
  -e BETTER_AUTH_SECRET=$(openssl rand -base64 32) posy

Откройте http://localhost:3000 и зарегистрируйтесь: первый аккаунт становится владельцем экземпляра, и все стили оформления будут доступны.

Настройка домена, резервное копирование и все параметры: руководство по самостоятельному размещению · .env.example

Технологии

Next.js 16 · React 19 · TypeScript · Tailwind CSS 4 · Motion · dnd-kit · shadcn/ui · Better Auth · Drizzle + libSQL · Zod · MCP

Схема src/lib/schema.ts описывает страницу. На её основе формируются JSON Schema, REST API, инструменты MCP и редактор, поэтому их описание всегда остаётся согласованным.

Как устроены компоненты

flowchart LR
  studio["Studio<br/>(browser)"] --> app
  agent["AI agents"] -- "MCP /api/mcp" --> app
  scripts["Scripts, CLI"] -- "REST /api/v1" --> app
  app["Next.js app<br/>page schema in Zod"] --> db[("SQLite or Turso<br/>(Drizzle + libSQL)")]
  app --> files[("Uploads<br/>data dir or Vercel Blob")]
  app --> page["/username<br/>+ llms.txt + public JSON"]
ПутьСодержимое
src/components/page/styles/Стили оформления: для каждого — отдельные файлы .tsx и .css
src/components/studio/Редактор
src/app/api/REST (v1), MCP (mcp), авторизация и загрузка файлов
src/lib/Схема, стили, палитры, шрифты и определение ссылок

Чтобы запустить из исходного кода: npm install && npm run dev (Node 22 или 24). Локальные данные хранятся в ~/.posy.

Участие в разработке

Будем рады вашим сообщениям об ошибках и pull request. Начните с CONTRIBUTING.md.

Сообщество, безопасность и лицензия

  • Вопросы и идеи: обсуждения. Пожалуйста, следуйте Кодексу поведения.

  • Обнаружили уязвимость? Ознакомьтесь с SECURITY.md и сообщите о ней конфиденциально.

  • Posy распространяется по лицензии MIT. Иллюстрации, входящие в состав образов, находятся в общественном достоянии, распространяются по лицензии CC0 или созданы для Posy. Список всех файлов и их источников приведён в public/looks/CREDITS.md.

Некоторые иллюстрации созданы с помощью Krea 2. Лицензия сообщества разрешает коммерческое использование, только если годовой доход вашей компании не превышает US$1M. Сначала прочитайте примечание в файле с указанием авторства.

  • Файлы фирменного стиля и цвета: BRAND.md.

Сделано вручную, пока на столе спал кот.