GiveReady

GiveReady

Yapay zeka ajanlarının gençlik kâr amacı gütmeyen kuruluşlarını keşfetmesi ve onlara doğrudan para göndermesi için açık kaynaklı altyapı. Aracı yok. Platform ücreti yok. Kâr amacı gütmeyen kuruluşlar %100'ünü elinde tutar.

Sorun

Her bağış platformu — Every.org, The Giving Block, Endaoment — bir aracıdır. Para önce onlara gider. Onlar dönüştürür, yönlendirir, pay alır. Cape Town, Bermuda veya Nairobi'deki küçük gençlik yardım kuruluşları için bu katman, zaten ince olan bütçeleri yiyen sürtünme, ücretler ve gecikmeler ekler.

12 ay içinde bağışçılar bağış yapmak için bir web sitesine gitmeyecek. Bir yapay zeka asistanına "bana Cape Town'da bir gençlik yardım kuruluşu bul ve onlara 20 dolar gönder" diyecekler. Ajanın doğru kuruluşu bulmak için yapılandırılmış verilere ve parayı göndermek için bir ödeme kanalına ihtiyacı var. Mevcut hiçbir platform her ikisini de sağlamıyor.

GiveReady Ne Yapar

Keşif. Bir MCP sunucusu ve REST API, yapay zeka ajanlarına 29 neden alanında 41.000+ doğrulanmış kâr amacı gütmeyen kuruluşa yapılandırılmış erişim sağlar — programlar, etki metrikleri, yararlanıcı demografileri, bağış bağlantıları ve mevcut olduğunda cüzdan adresleri. Bir yapay zeka ajanının bir yardım kuruluşu bulması gerektiğinde, GiveReady'yi sorgular.

Doğrudan ödeme. x402 protokolü, yapay zeka ajanlarının USDC'yi doğrudan kâr amacı gütmeyen kuruluşun kendi cüzdanına göndermesini sağlar. Hiçbir aracı fonları elinde tutmaz. Kâr amacı gütmeyen kuruluş, para geldiği andan itibaren kontrolü elinde tutar. Solana'da bir saniyeden kısa sürede mutabakat.

Gömülebilir bağış düğmesi. Kayıtlı her kâr amacı gütmeyen kuruluş, web siteleri için sıfır bağımlılıklı bir JavaScript widget'ı alır. Tek script etiketi. Bir Solana Pay QR kodu veya doğrudan transfer bağlantısı oluşturur. Bağışçılar Phantom veya Coinbase Wallet ile tarar. Arka uç gerekmez. Platform ücreti yok.

Ödemesiz keşif bir arama motorudur. Keşifsiz ödeme bir cüzdandır. Kimsenin bulamadığı bir bağış düğmesi bir widget'tır. GiveReady üçünü de birleştirir.

ABD/Birleşik Krallık/AB Dışında Neden Önemli

Geleneksel bağış platformları ABD ödeme altyapısı üzerinden yönlendirilir. Bermuda'da, Afrika'nın çoğunda, Karayipler'de veya Güneydoğu Asya'da bankacılık yapıyorsanız, ya hariç tutulursunuz ya da küçük bağışları anlamsız kılan dönüşüm ücretleri ödersiniz.

Solana'daki USDC her yerde çalışır. Bir kâr amacı gütmeyen kuruluşun bir akıllı telefona ve bir cüzdan uygulamasına ihtiyacı vardır. Fon almak için sıfır KYC. Gerekirse yerel bir borsa aracılığıyla yerel para birimine çıkış. Bu yalnızca Batı yardım kuruluşları için altyapı değil — her ülkedeki her kâr amacı gütmeyen kuruluş için altyapıdır.

Mimari

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

Yığın: Cloudflare Workers + D1 (SQLite) + Solana USDC + x402 protokolü + Model Context Protocol (MCP)

Çalıştırma maliyeti: Cloudflare'da ayda ~5 dolar. Coinbase kolaylaştırıcı ücretsiz katmanı ayda 1.000 işlemi kapsar. İşlem ücretleri bağışçı tarafından ödenir.

API Uç Noktaları

Uç Nokta	Açıklama
GET /api/search?q=&cause=&country=	Kâr amacı gütmeyen kuruluşları ara
GET /api/nonprofits	Tüm doğrulanmış kâr amacı gütmeyen kuruluşları listele
GET /api/nonprofits/:slug	Kâr amacı gütmeyen kuruluş ayrıntısını al
GET /api/causes	Neden alanlarını listele
GET /api/stats	Dizin istatistikleri
GET /api/donate/:slug?amount=	x402 bağışı (ödeme gereksinimleriyle 402 döndürür)
POST /api/donate/:slug	İmzalı ödemeyi gönder
GET /api/donations/:slug	Bağış geçmişi
GET /mcp	MCP sunucu manifesti
GET /.well-known/ai-plugin.json	Yapay zeka eklentisi keşfi
GET /llms.txt	LLM tarayıcı meta verileri
GET /agents.md	Ajan keşif kılavuzu

MCP Sunucusu

Herhangi bir yapay zeka asistanına GiveReady'ye yerel erişim sağlamak için MCP sunucusunu kurun:

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

Araçlar: search_nonprofits, get_nonprofit, list_causes, submit_enrichment

Bağış Widget'ı

Herhangi bir kâr amacı gütmeyen kuruluş web sitesine tek satırla bir bağış düğmesi ekleyin:

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

Tam dokümantasyon için public/widget/README.md bölümüne bakın.

Kendi Örneğinizi Çalıştırı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

Tam üretim dağıtım talimatları için DEPLOY.md bölümüne bakın.

Kâr Amacı Gütmeyen Kuruluş Kaydı

Listelenmek 45 dakikadan az sürer:

1. Bir cüzdan kurun (3 dk) — Phantom (Solana) veya Coinbase Wallet'ı indirin. USDC adresini kopyalayın.
2. GiveReady'ye kaydolun (10 dk) — Kuruluş adı, misyon, programlar, etki verileri, cüzdan adresi.
3. İsteğe bağlı: itibari para çıkışı (30 dk) — Yerel para birimine otomatik dönüştürme istiyorsanız yerel bir borsaya (Coinbase, Luno vb.) bağlanın.
4. Bağış düğmesini gömün (2 dk) — Web sitenize tek script etiketi.

Kâr amacı gütmeyen kuruluş artık internetteki her yapay zeka ajanı tarafından keşfedilebilir, x402 aracılığıyla ödenebilir ve sitelerinde ücretsiz bir bağış düğmesine sahiptir.

Konsorsiyum

Hibe lideri: TestVentures.net. Platform operatörü: Clean Tactile Ventures UK Ltd. 2026 Gates başvurusu için pilot kâr amacı gütmeyen kuruluşlar:

City Kids Surfing — Birleşik Krallık gençlik sörf yardım kuruluşu. Adlandırılmış tasarım ortağı. GiveReady bağış platformuna ömür boyu ücretsiz erişim alır (Stripe Connect aracılığıyla itibari para ve x402 aracılığıyla USDC). Gerçek bağış akışı için canlı pilot.

Finn Wardman World Explorer Fund — Gençlik macera hibeleri. Bermuda merkezli vakıf. Dahili pilot (kendi yemeğini pişirmek). finnwardman.com

Hakkında

GiveReady, TestVentures.net tarafından oluşturulmuştur — gençlik kâr amacı gütmeyen kuruluşları için kesirli yapay zeka operasyonları. GiveReady'nin canlı dizininden elde edilen gelir, Finn Wardman World Explorer Fund destekler.

Finn Wardman 8 Nisan 2023'te öldü. 20 yaşındaydı. Serbest kayakçıydı, sörfçüydü ve her odadaki en komik insanlardan biriydi. World Explorer Fund, diğer gençlerin onun yaşadığı türden maceraları yaşayabilmesi için var. GiveReady, o fonun — ve onun gibi yüzlerce küçük kâr amacı gütmeyen kuruluşun — bir aracının pay almadan dünyanın her yerinden bağış alabilmesi için var.

Lisans

MIT. LICENSE bölümüne bakın.