GiveReady

GiveReady

Cơ sở hạ tầng mã nguồn mở cho các tác nhân AI khám phá các tổ chức phi lợi nhuận dành cho thanh thiếu niên và gửi tiền trực tiếp cho họ. Không qua trung gian. Không phí nền tảng. Các tổ chức phi lợi nhuận giữ 100%.

Vấn đề

Mọi nền tảng quyên góp — Every.org, The Giving Block, Endaoment — đều là trung gian. Tiền đến tay họ trước. Họ chuyển đổi, định tuyến, lấy một phần. Đối với các tổ chức từ thiện nhỏ dành cho thanh thiếu niên ở Cape Town, Bermuda hay Nairobi, lớp trung gian đó tạo thêm rào cản, phí tổn và chậm trễ, làm hao mòn ngân sách vốn đã eo hẹp.

Trong vòng 12 tháng tới, các nhà tài trợ sẽ không truy cập trang web để quyên góp nữa. Họ sẽ bảo trợ lý AI "tìm cho tôi một tổ chức từ thiện thanh thiếu niên ở Cape Town và gửi cho họ 20 đô la." Tác nhân cần dữ liệu có cấu trúc để tìm đúng tổ chức và một kênh thanh toán để gửi tiền. Không có nền tảng hiện tại nào cung cấp cả hai.

GiveReady làm gì

Khám phá. Một máy chủ MCP và API REST cung cấp cho các tác nhân AI quyền truy cập có cấu trúc vào hơn 41.000 tổ chức phi lợi nhuận đã được xác minh trên 29 lĩnh vực hoạt động — chương trình, chỉ số tác động, nhân khẩu học người thụ hưởng, liên kết quyên góp và địa chỉ ví nếu có. Khi một tác nhân AI cần tìm tổ chức từ thiện, nó truy vấn GiveReady.

Thanh toán trực tiếp. Giao thức x402 cho phép các tác nhân AI gửi USDC thẳng đến ví riêng của tổ chức phi lợi nhuận. Không có trung gian nào giữ tiền. Tổ chức phi lợi nhuận kiểm soát tiền ngay từ khi nhận được. Thời gian thanh toán dưới một giây trên Solana.

Nút quyên góp có thể nhúng. Mỗi tổ chức phi lợi nhuận đã đăng ký đều nhận được một tiện ích JavaScript không phụ thuộc cho trang web của họ. Một thẻ script. Tạo mã QR Solana Pay hoặc liên kết chuyển khoản trực tiếp. Nhà tài trợ quét bằng Phantom hoặc Coinbase Wallet. Không cần backend. Không có phí nền tảng.

Khám phá mà không có thanh toán chỉ là công cụ tìm kiếm. Thanh toán mà không có khám phá chỉ là một chiếc ví. Một nút quyên góp không ai tìm thấy chỉ là một tiện ích. GiveReady kết hợp cả ba.

Tại sao nó quan trọng bên ngoài Mỹ/Anh/EU

Các nền tảng quyên góp truyền thống định tuyến qua cơ sở hạ tầng thanh toán của Mỹ. Nếu bạn có tài khoản ngân hàng ở Bermuda, phần lớn châu Phi, Caribe hoặc Đông Nam Á, bạn hoặc bị loại trừ hoặc phải trả phí chuyển đổi khiến các khoản quyên góp nhỏ trở nên vô nghĩa.

USDC trên Solana hoạt động ở mọi nơi. Một tổ chức phi lợi nhuận chỉ cần một điện thoại thông minh và một ứng dụng ví. Không cần KYC để nhận tiền. Có thể chuyển đổi sang tiền tệ địa phương qua sàn giao dịch địa phương nếu cần. Đây không chỉ là cơ sở hạ tầng cho các tổ chức từ thiện phương Tây — mà là cơ sở hạ tầng cho bất kỳ tổ chức phi lợi nhuận nào ở bất kỳ quốc gia nào.

Kiến trúc

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

Công nghệ: Cloudflare Workers + D1 (SQLite) + Solana USDC + giao thức x402 + Model Context Protocol (MCP)

Chi phí vận hành: ~5 đô la/tháng trên Cloudflare. Bậc miễn phí của Coinbase facilitator hỗ trợ 1.000 giao dịch/tháng. Phí giao dịch do nhà tài trợ trả.

Điểm cuối API

Điểm cuối	Mô tả
GET /api/search?q=&cause=&country=	Tìm kiếm tổ chức phi lợi nhuận
GET /api/nonprofits	Liệt kê tất cả tổ chức phi lợi nhuận đã xác minh
GET /api/nonprofits/:slug	Xem chi tiết tổ chức phi lợi nhuận
GET /api/causes	Liệt kê các lĩnh vực hoạt động
GET /api/stats	Thống kê thư mục
GET /api/donate/:slug?amount=	Quyên góp x402 (trả về 402 với yêu cầu thanh toán)
POST /api/donate/:slug	Gửi thanh toán đã ký
GET /api/donations/:slug	Lịch sử quyên góp
GET /mcp	Tệp kê khai máy chủ MCP
GET /.well-known/ai-plugin.json	Khám phá plugin AI
GET /llms.txt	Siêu dữ liệu trình thu thập LLM
GET /agents.md	Hướng dẫn khám phá tác nhân

Máy chủ MCP

Cài đặt máy chủ MCP để cấp cho bất kỳ trợ lý AI nào quyền truy cập gốc vào GiveReady:

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

Công cụ: search_nonprofits, get_nonprofit, list_causes, submit_enrichment

Tiện ích quyên góp

Thêm nút quyên góp vào bất kỳ trang web tổ chức phi lợi nhuận nào chỉ với một dòng:

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

Xem public/widget/README.md để có tài liệu đầy đủ.

Chạy phiên bản của riêng bạn

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

Xem DEPLOY.md để có hướng dẫn triển khai sản xuất đầy đủ.

Đăng ký tổ chức phi lợi nhuận

Việc được liệt kê mất dưới 45 phút:

1. Thiết lập ví (3 phút) — Tải Phantom (Solana) hoặc Coinbase Wallet. Sao chép địa chỉ USDC.
2. Đăng ký trên GiveReady (10 phút) — Tên tổ chức, sứ mệnh, chương trình, dữ liệu tác động, địa chỉ ví.
3. Tùy chọn: chuyển đổi sang tiền pháp định (30 phút) — Kết nối với sàn giao dịch địa phương (Coinbase, Luno, v.v.) nếu bạn muốn tự động chuyển đổi sang tiền tệ địa phương.
4. Nhúng nút quyên góp (2 phút) — Một thẻ script trên trang web của bạn.

Tổ chức phi lợi nhuận giờ đây có thể được khám phá bởi mọi tác nhân AI trên internet, có thể thanh toán qua x402 và có nút quyên góp miễn phí trên trang web của họ.

Tập đoàn

Đơn vị tài trợ chính: TestVentures.net. Đơn vị vận hành nền tảng: Clean Tactile Ventures UK Ltd. Các tổ chức phi lợi nhuận thí điểm cho đơn đăng ký Gates 2026:

City Kids Surfing — Tổ chức từ thiện lướt sóng cho thanh thiếu niên Vương quốc Anh. Đối tác thiết kế được chỉ định. Nhận quyền truy cập miễn phí trọn đời vào nền tảng quyên góp GiveReady (tiền pháp định qua Stripe Connect và USDC qua x402). Thí điểm trực tiếp cho luồng quyên góp thực tế.

Finn Wardman World Explorer Fund — Tài trợ phiêu lưu cho thanh thiếu niên. Quỹ tài trợ có trụ sở tại Bermuda. Thí điểm nội bộ (tự mình trải nghiệm). finnwardman.com

Giới thiệu

GiveReady được xây dựng bởi TestVentures.net — vận hành AI phân đoạn cho các tổ chức phi lợi nhuận thanh thiếu niên. Doanh thu từ thư mục trực tiếp của GiveReady hỗ trợ Finn Wardman World Explorer Fund.

Finn Wardman qua đời vào ngày 8 tháng 4 năm 2023. Cậu ấy 20 tuổi. Cậu là một vận động viên trượt tuyết tự do, một người lướt sóng, và là một trong những người hài hước nhất trong bất kỳ căn phòng nào. World Explorer Fund tồn tại để những người trẻ khác có cơ hội trải nghiệm những cuộc phiêu lưu mà cậu ấy đã sống vì chúng. GiveReady tồn tại để quỹ đó — và hàng trăm tổ chức phi lợi nhuận nhỏ tương tự — có thể nhận quyên góp từ bất kỳ đâu trên thế giới mà không bị trung gian lấy mất một phần.

Giấy phép

MIT. Xem LICENSE.