GiveReady

GiveReady

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

Проблема

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

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

Что делает GiveReady

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

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

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

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

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

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

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

Архитектура

giveready/
├── src/
│   ├── index.js              # Cloudflare Worker: API, pages, x402, admin, cron
│   ├── payable.js            # Payability report for agents (/payable)
│   ├── wallet-proof.js       # Ed25519 proof that a charity controls its wallet
│   └── wallet-proof-page.js  # Signing page for the wallet proof
├── mcp-server/               # MCP server for AI agents (published as giveready-mcp)
├── public/                   # Static assets served by the Worker
│   ├── widget/               # Embeddable donate button (zero dependencies)
│   ├── guides/  learn/       # Long-form guides, rendered from markdown
│   └── openapi.json          # OpenAPI spec
├── migrations/               # Numbered D1 migrations, idempotent, run on deploy
├── tests/                    # Node test runner suite (npm test, runs offline)
├── scripts/                  # Data import, smoke tests and monitoring jobs
├── docs/                     # Deploy notes, incident write-ups, design specs
├── test-client/              # x402 payment protocol test client
├── schema.sql                # D1 database schema
├── seed.sql                  # Nonprofit seed data
├── deploy.sh                 # Test, tag, migrate, deploy (./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, submit_enrichment

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

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

<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 минут:

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

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

Консорциум

Грант-лидер: TestVentures.net. Оператор платформы: Clean Tactile Ventures UK Ltd. Пилотные некоммерческие организации для заявки Gates 2026:

City Kids Surfing — британская молодёжная благотворительная организация по сёрфингу. Названный партнёр по дизайну. Получает пожизненный бесплатный доступ к донационной платформе GiveReady (фиат через Stripe Connect и USDC через x402). Живой пилот для реального потока пожертвований.

Finn Wardman World Explorer Fund — гранты на молодёжные приключения. Эндаумент на Бермудах. Внутренний пилот (едим собственную стряпню). finnwardman.com

О проекте

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

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

Лицензия

MIT. См. LICENSE.