GiveReady

AI 에이전트가 청소년 비영리 단체를 찾고 직접 자금을 보낼 수 있도록 하는 오픈 소스 인프라입니다. 중개자가 없으며 플랫폼 수수료도 없습니다. 비영리 단체가 100%를 유지합니다.

문제점

Every.org, The Giving Block, Endaoment와 같은 모든 기부 플랫폼은 중개자입니다. 돈은 먼저 그들에게 전달됩니다. 그들은 돈을 환전하고, 경로를 지정하고, 수수료를 뗍니다. 케이프타운, 버뮤다, 나이로비에 있는 소규모 청소년 자선 단체에게 이러한 단계는 이미 부족한 예산을 갉아먹는 마찰, 수수료, 지연을 추가합니다.

12개월 이내에 기부자들은 기부를 위해 웹사이트에 접속하지 않을 것입니다. 그들은 AI 비서에게 "케이프타운에 있는 청소년 자선 단체를 찾아서 20달러를 보내줘"라고 말할 것입니다. 에이전트는 올바른 단체를 찾기 위한 구조화된 데이터와 돈을 보낼 결제 레일이 필요합니다. 기존 플랫폼 중 어느 것도 이 두 가지를 모두 제공하지 않습니다.

GiveReady의 역할

검색. MCP 서버와 REST API는 AI 에이전트에게 162개 이상의 청소년 비영리 단체에 대한 구조화된 액세스(프로그램, 영향력 지표, 수혜자 인구 통계, 지갑 주소)를 제공합니다. AI 에이전트가 자선 단체를 찾아야 할 때 GiveReady를 쿼리합니다.

직접 결제. x402 프로토콜을 통해 AI 에이전트는 비영리 단체의 지갑으로 USDC를 직접 보낼 수 있습니다. 중개자가 자금을 보유하지 않습니다. 비영리 단체는 자금이 도착하는 순간부터 돈을 통제합니다. Solana에서 1초 이내에 결제가 완료됩니다.

임베드 가능한 기부 버튼. 온보딩된 모든 비영리 단체는 웹사이트용 무종속성 JavaScript 위젯을 받습니다. 스크립트 태그 하나면 충분합니다. Solana Pay QR 코드 또는 직접 이체 링크를 생성합니다. 기부자는 Phantom 또는 Coinbase Wallet으로 스캔합니다. 백엔드가 필요 없으며 플랫폼 수수료도 없습니다.

결제 없는 검색은 검색 엔진일 뿐입니다. 검색 없는 결제는 지갑일 뿐입니다. 아무도 찾을 수 없는 기부 버튼은 위젯일 뿐입니다. GiveReady는 이 세 가지를 모두 결합합니다.

미국/영국/EU 외 지역에서 중요한 이유

전통적인 기부 플랫폼은 미국 결제 인프라를 거칩니다. 버뮤다, 아프리카 대부분 지역, 카리브해 또는 동남아시아에서 은행 업무를 보는 경우, 소액 기부를 무의미하게 만드는 환전 수수료를 지불하거나 아예 배제됩니다.

Solana의 USDC는 어디서나 작동합니다. 비영리 단체는 스마트폰과 지갑 앱만 있으면 됩니다. 자금을 받는 데 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)

운영 비용: Cloudflare에서 월 약 5달러. Coinbase 페실리테이터 무료 티어는 월 1,000건의 거래를 지원합니다. 거래 수수료는 기부자가 부담합니다.

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`	AI 플러그인 검색
`GET /llms.txt`	LLM 크롤러 메타데이터
`GET /agents.md`	에이전트 검색 가이드

MCP 서버

모든 AI 비서에게 GiveReady에 대한 기본 액세스 권한을 부여하려면 MCP 서버를 설치하세요:

{
  "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분) — 웹사이트에 스크립트 태그 하나를 추가합니다.

이제 비영리 단체는 인터넷상의 모든 AI 에이전트가 검색할 수 있게 되며, x402를 통해 결제가 가능하고, 사이트에 수수료 없는 기부 버튼이 생깁니다.

컨소시엄

세 개의 파일럿 비영리 단체와 함께 구축되었습니다:

Bridges for Music — 영국/미국/남아공. 케이프타운 랑가 타운십에서 연간 250명 이상의 학생 교육. 음악, 기업가 정신, 마음챙김.

The Wave Project — 영국 서핑 테라피. 32개 지역, 5,000명 이상의 청소년 지원. 처방전으로 서핑을 제공하는 최초의 자선 단체.

Finn Wardman World Explorer Fund — 청소년 모험 보조금. 버뮤다 기반 기금. finnwardman.com

소개

GiveReady는 청소년 비영리 단체를 위한 부분적 AI 운영을 담당하는 TestVentures.net에서 구축했습니다. GiveReady의 라이브 디렉토리에서 발생하는 수익은 Finn Wardman World Explorer Fund를 지원합니다.

Finn Wardman은 2023년 4월 8일에 세상을 떠났습니다. 그는 20세였습니다. 그는 프리라이드 스키어이자 서퍼였으며, 어디서나 가장 재미있는 사람 중 한 명이었습니다. World Explorer Fund는 다른 젊은이들이 그가 살았던 것과 같은 모험을 경험할 수 있도록 존재합니다. GiveReady는 그 기금과 그와 같은 수백 개의 작은 비영리 단체들이 중개자에게 수수료를 떼이지 않고 전 세계 어디서나 기부를 받을 수 있도록 하기 위해 존재합니다.

라이선스

MIT. LICENSE를 참조하세요.

giveready-mcp