GiveReady

GiveReady

Cơ sở hạ tầng mã nguồn mở cho các tác tử 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, và khấu trừ phí. Đối với các tổ chức từ thiện thanh thiếu niên nhỏ ở Cape Town, Bermuda hay Nairobi, lớp trung gian này thêm sự phức tạp, phí tổn và chậm trễ làm hao mòn ngân sách vốn đã mỏng manh.

Trong vòng 12 tháng, các nhà tài trợ sẽ không truy cập website để quyên góp. Họ sẽ nói với 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 tử cần dữ liệu có cấu trúc để tìm tổ chức phù hợp và một kênh thanh toán để gửi tiền. Không nền tảng hiện có 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 tử 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 tử 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 tử AI gửi USDC trực tiếp đến ví riêng của tổ chức phi lợi nhuận. Không trung gian giữ tiền. Tổ chức phi lợi nhuận kiểm soát tiền ngay từ khi nó đến. Thanh toán trong chưa đầy một giây trên Solana.

Nút quyên góp nhúng được. Mỗi tổ chức phi lợi nhuận được gia nhập sẽ nhận được một tiện ích JavaScript không phụ thuộc cho website của họ. Một thẻ script. Tạo mã QR Solana Pay hoặc liên kết chuyển tiề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 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à ví. Nút quyên góp không ai tìm thấy chỉ là tiện ích. GiveReady kết hợp cả ba.

Tại Sao Nó Quan Trọng 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 giao dịch ngân hàng ở Bermuda, hầu hết châu Phi, Caribe hay Đô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 ở bất cứ đâu. Một tổ chức phi lợi nhuận chỉ cần điện thoại thông minh và ứng dụng ví. Không cần KYC để nhận tiền. Có thể rút tiền 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, 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

Ngăn xếp: Cloudflare Workers + D1 (SQLite) + Solana USDC + giao thức x402 + Giao thức Ngữ cảnh Mô hình (MCP)

Chi phí vận hành: ~5 đô la/tháng trên Cloudflare. Gói miễn phí của Coinbase facilitator bao gồm 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ê 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 tử

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ỳ website 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 đủ.

Gia Nhập Tổ Chức Phi Lợi Nhuận

Được niêm yết mất chưa đầy 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: rút tiền fiat (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 website của bạn.

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

Liên Minh

Đơn vị dẫn dắt tài trợ: 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 xin Gates 2026:

City Kids Surfing — Tổ chức từ thiện lướt sóng thanh thiếu niên tại 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 (fiat 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 thanh thiếu niên. Quỹ tài trợ có trụ sở tại Bermuda. Thí điểm nội bộ (tự ăn món mình nấu). finnwardman.com

Giới Thiệu

GiveReady được xây dựng bởi TestVentures.net — dịch vụ vận hành AI theo 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. Anh ấy 20 tuổi. Anh ấy là 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 những cuộc phiêu lưu mà anh ấy đã sống hết mình. 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 cứ đâu trên thế giới mà không có trung gian khấu trừ phí.

Giấy Phép

MIT. Xem LICENSE.