GiveReady

Инфраструктура с открытым исходным кодом для ИИ-агентов, позволяющая находить молодежные некоммерческие организации и отправлять им деньги напрямую. Никаких посредников. Никаких комиссий платформы. Некоммерческие организации получают 100% средств.

Проблема

Каждая платформа для пожертвований — Every.org, The Giving Block, Endaoment — является посредником. Деньги сначала поступают к ним. Они конвертируют их, перенаправляют и забирают свою долю. Для небольших молодежных благотворительных организаций в Кейптауне, на Бермудах или в Найроби этот слой добавляет трения, комиссии и задержки, которые съедают и без того скудные бюджеты.

В течение 12 месяцев доноры перестанут заходить на сайты, чтобы сделать пожертвование. Они скажут ИИ-ассистенту: «найди мне молодежную благотворительную организацию в Кейптауне и отправь им $20». Агенту нужны структурированные данные, чтобы найти нужную организацию, и платежный канал для отправки денег. Ни одна существующая платформа не предоставляет и то, и другое.

Что делает GiveReady

Поиск. MCP-сервер и REST API предоставляют ИИ-агентам структурированный доступ к более чем 162 молодежным некоммерческим организациям — программы, показатели влияния, демографические данные бенефициаров, адреса кошельков. Когда ИИ-агенту нужно найти благотворительную организацию, он делает запрос к GiveReady.

Прямые платежи. Протокол x402 позволяет ИИ-агентам отправлять USDC прямо на собственный кошелек некоммерческой организации. Никакой посредник не удерживает средства. Некоммерческая организация контролирует деньги с момента их поступления. Расчеты происходят менее чем за секунду в сети Solana.

Встраиваемая кнопка пожертвования. Каждая зарегистрированная некоммерческая организация получает JavaScript-виджет без зависимостей для своего сайта. Один тег скрипта. Генерирует QR-код Solana Pay или ссылку для прямого перевода. Доноры сканируют его с помощью Phantom или Coinbase Wallet. Бэкенд не требуется. Никаких комиссий платформы.

Поиск без возможности оплаты — это просто поисковая система. Оплата без поиска — это просто кошелек. Кнопка пожертвования, которую никто не может найти, — это просто виджет. GiveReady объединяет все три элемента.

Почему это важно за пределами США/Великобритании/ЕС

Традиционные платформы для пожертвований работают через платежную инфраструктуру США. Если вы ведете банковские операции на Бермудах, в большинстве стран Африки, Карибского бассейна или Юго-Восточной Азии, вы либо исключены из системы, либо платите комиссии за конвертацию, которые делают небольшие пожертвования бессмысленными.

USDC в сети Solana работает везде. Некоммерческой организации нужен только смартфон и приложение-кошелек. Нулевой KYC для получения средств. При необходимости возможен вывод в местную валюту через локальную биржу. Это инфраструктура не только для западных благотворительных организаций — это инфраструктура для любой некоммерческой организации в любой стране.

Архитектура

giveready/
├── src/index.js              # Cloudflare Worker — API + x402 endpoint
├── mcp-server/               # MCP server for AI agents (Claude, etc.)
├── public/
│   ├── index.html            # Landing page (static, served by Cloudflare)
│   ├── widget/               # Embeddable donate button (zero dependencies)
│   ├── llms.txt              # LLM crawler metadata
│   ├── AGENTS.md             # Agent discovery guide
│   └── openapi.json          # OpenAPI spec for ai-plugin.json
├── test-client/              # x402 payment protocol test client
├── scripts/                  # Data import utilities
├── schema.sql                # D1 database schema
├── seed.sql                  # Nonprofit seed data
├── deploy.sh                 # Deployment script (./deploy.sh)
└── wrangler.toml             # Cloudflare Workers config

Стек: Cloudflare Workers + D1 (SQLite) + Solana USDC + протокол x402 + Model Context Protocol (MCP)

Стоимость запуска: ~$5/месяц на Cloudflare. Бесплатный уровень Coinbase facilitator покрывает 1000 транзакций в месяц. Комиссии за транзакции оплачиваются донором.

API-эндпоинты

Эндпоинт	Описание
`GET /api/search?q=&cause=&country=`	Поиск некоммерческих организаций
`GET /api/nonprofits`	Список всех проверенных некоммерческих организаций
`GET /api/nonprofits/:slug`	Получить информацию о некоммерческой организации
`GET /api/causes`	Список направлений деятельности
`GET /api/stats`	Статистика каталога
`GET /api/donate/:slug?amount=`	Пожертвование через x402 (возвращает 402 с требованиями к оплате)
`POST /api/donate/:slug`	Отправить подписанный платеж
`GET /api/donations/:slug`	История пожертвований
`GET /mcp`	Манифест MCP-сервера
`GET /.well-known/ai-plugin.json`	Обнаружение ИИ-плагина
`GET /llms.txt`	Метаданные для LLM-краулера
`GET /agents.md`	Руководство по обнаружению агентов

MCP-сервер

Установите MCP-сервер, чтобы предоставить любому ИИ-ассистенту нативный доступ к GiveReady:

{
  "mcpServers": {
    "giveready": {
      "command": "npx",
      "args": ["giveready-mcp"]
    }
  }
}

Инструменты: search_nonprofits, get_nonprofit, list_causes, donate_to_nonprofit, get_donation_history

Виджет пожертвований

Добавьте кнопку пожертвования на любой сайт некоммерческой организации одной строкой:

<div id="giveready-donate" data-slug="your-nonprofit-slug"></div>
<script src="https://giveready.org/widget/donate.js"></script>

Полную документацию см. в public/widget/README.md.

Запуск собственного экземпляра

git clone https://github.com/gswardman/giveready.git
cd giveready
npm install
wrangler d1 create giveready-db
# Copy database_id into wrangler.toml
wrangler d1 execute giveready-db --local --file=./schema.sql
wrangler d1 execute giveready-db --local --file=./seed.sql
npm run dev

Инструкции по развертыванию в промышленную эксплуатацию см. в DEPLOY.md.

Регистрация некоммерческих организаций

Добавление в список занимает менее 45 минут:

Настройте кошелек (3 мин) — Скачайте Phantom (Solana) или Coinbase Wallet. Скопируйте адрес USDC.
Зарегистрируйтесь в GiveReady (10 мин) — Название организации, миссия, программы, данные о влиянии, адрес кошелька.
Опционально: вывод в фиат (30 мин) — Подключитесь к локальной бирже (Coinbase, Luno и т.д.), если хотите автоматическую конвертацию в местную валюту.
Встройте кнопку пожертвования (2 мин) — Один тег скрипта на вашем сайте.

Теперь некоммерческая организация доступна для поиска всеми ИИ-агентами в интернете, принимает платежи через x402 и имеет кнопку пожертвования без комиссии на своем сайте.

Консорциум

Создано с участием трех пилотных некоммерческих организаций:

Bridges for Music — Великобритания/США/ЮАР. Более 250 студентов в год в тауншипе Ланга, Кейптаун. Музыка, предпринимательство, осознанность.

The Wave Project — Терапия серфингом в Великобритании. 32 локации, более 5000 обслуженных молодых людей. Первая благотворительная организация, предлагающая серфинг по рецепту.

Finn Wardman World Explorer Fund — Гранты на молодежные приключения. Фонд, базирующийся на Бермудах. finnwardman.com

О проекте

GiveReady создан TestVentures.net — дробные ИИ-операции для молодежных некоммерческих организаций. Доход от каталога GiveReady поддерживает Finn Wardman World Explorer Fund.

Финн Уордман погиб 8 апреля 2023 года. Ему было 20 лет. Он был фрирайд-лыжником, серфером и одним из самых веселых людей в любой компании. Фонд World Explorer существует для того, чтобы другие молодые люди могли получить те приключения, ради которых жил он. GiveReady существует для того, чтобы этот фонд — и сотни подобных небольших некоммерческих организаций — могли получать пожертвования из любой точки мира без посредников, забирающих свою долю.

Лицензия

MIT. См. LICENSE.

giveready-mcp