An open API service indexing awesome lists of open source software.

https://github.com/edycutjong/proxygen

๐Ÿงช Autonomous agent that scrapes geo-restricted data via global proxies, structures it with AI, and sells clean feeds โ€” all settled via x402 micropayments on Solana.
https://github.com/edycutjong/proxygen

ai hackathon micropayments nextjs proxy-scraper solana web-scraping x402

Last synced: 1 day ago
JSON representation

๐Ÿงช Autonomous agent that scrapes geo-restricted data via global proxies, structures it with AI, and sells clean feeds โ€” all settled via x402 micropayments on Solana.

Awesome Lists containing this project

README

          


Proxygen Logo

Proxygen ๐Ÿงช


Autonomous agent that scrapes geo-restricted data via global proxies, structures it with AI, and sells clean feeds โ€” all settled via x402 micropayments on Solana.


Proxygen


[![Live Demo](https://img.shields.io/badge/๐Ÿš€_Live-Demo-06b6d4?style=for-the-badge)](https://proxygen.edycu.dev)
[![Pitch Video](https://img.shields.io/badge/๐ŸŽฌ_Pitch-Video-ef4444?style=for-the-badge)](https://youtu.be/ktl4GxVcBoI)
[![Pitch Deck](https://img.shields.io/badge/๐Ÿ–ฅ๏ธ_Pitch-Deck-22c55e?style=for-the-badge)](https://proxygen.edycu.dev/pitch-deck.html)
[![Built for OOBE ร— Ace Data Cloud](https://img.shields.io/badge/Superteam-OOBE_ร—_Ace_Data_Cloud-8b5cf6?style=for-the-badge)](https://superteam.fun/earn/listing/autonomous-agent-bounty-oobe-ace-data-cloud)
[![๐• Announcement](https://img.shields.io/badge/Announcement-000000?style=for-the-badge&logo=x&logoColor=white)](https://x.com/edycutjong/status/2061016507971490185?s=20)


![TypeScript](https://img.shields.io/badge/TypeScript-3178C6?style=flat&logo=typescript&logoColor=white)
![Next.js](https://img.shields.io/badge/Next.js_16-black?style=flat&logo=next.js)
![React](https://img.shields.io/badge/React_19-61DAFB?style=flat&logo=react&logoColor=black)
![Tailwind](https://img.shields.io/badge/Tailwind_v4-38B2AC?style=flat&logo=tailwindcss&logoColor=white)
![Solana](https://img.shields.io/badge/Solana-9945FF?style=flat&logo=solana&logoColor=white)
![OpenAI](https://img.shields.io/badge/GPT--4o-412991?style=flat&logo=openai&logoColor=white)
[![CI](https://github.com/edycutjong/proxygen/actions/workflows/ci.yml/badge.svg)](https://github.com/edycutjong/proxygen/actions/workflows/ci.yml)

---

## ๐Ÿ“ธ See it in Action


landing-proxygen-1
dashboard-proxy-1

> **3-second intelligence delivery.** Query โ†’ Proxy activates (Seoul ๐Ÿ‡ฐ๐Ÿ‡ท) โ†’ AI extracts structured data โ†’ x402 payment settles on Solana โ†’ Clean JSON delivered.

---

## ๐Ÿ’ก The Problem & Solution

A quant analyst in Jakarta spends **4 hours every morning** manually checking Korean exchange prices, Chinese market sentiment, and Japanese regulatory feeds โ€” all from sources behind geo-restrictions that standard APIs can't reach. By the time they compile the data, the alpha is gone.

**Proxygen** solves this by deploying an autonomous agent that scrapes geo-restricted sources via residential/mobile proxies, structures raw data with GPT-4o, and delivers clean feeds โ€” all paid via x402 micropayments. The entire pipeline runs without human intervention.

**Key Features:**
- ๐ŸŒ **Global Proxy Scraping:** 10 curated data sources across Korea, China, Japan, and the US โ€” including geo-restricted exchanges (Upbit, Bithumb)
- ๐Ÿง  **AI-Powered Extraction:** GPT-4o structures raw HTML/JSON into typed data models with confidence scoring
- ๐Ÿ’ฐ **x402 Micropayments:** Dual-flow economics โ€” agent SPENDS on proxies/AI, EARNS from data consumers. Self-sustaining.
- ๐Ÿ”ฅ **Kimchi Premium Signal:** Real-time BTC price gap detection between Korean and US exchanges (3.3% premium detected)
- ๐Ÿ›ก๏ธ **Self-Healing:** Detects source failures, re-discovers proxies via SAP, and auto-recovers
- ๐Ÿ“Š **SOC Dashboard:** Military-grade command center showing live feeds, economics, source health, and agent decisions

## ๐Ÿ—๏ธ Architecture & Tech Stack

| Layer | Technology |
|---|---|
| **Agent Runtime** | Node.js 22 + TypeScript |
| **Agent Framework** | `@oobe-protocol-labs/synapse-client-sdk` 2.0 |
| **Tool Registry** | `@oobe-protocol-labs/synapse-sap-sdk` (SAP v2) |
| **AI Services** | Ace Data Cloud Unified API (GPT-4o, DeepSeek-V3) |
| **Proxy** | Ace Data Cloud HTTP Proxy (Residential + Mobile) |
| **Payments** | `@acedatacloud/x402-client` (Solana USDC) |
| **Dashboard** | Next.js 16 (App Router), React 19, Tailwind CSS v4 |
| **HTTP Server** | Fastify 5 |

```mermaid
graph TD
subgraph Agent["Proxygen Agent (Node.js) :3001"]
Scheduler["โฑ๏ธ Scheduler
(10 min cron)"] --> Orchestrator["๐ŸŽฏ Orchestrator"]
Orchestrator --> ProxyClient["๐ŸŒ Proxy Client
(Ace Data Cloud)"]
ProxyClient --> LLM["๐Ÿค– LLM Extractor
(GPT-4o / DeepSeek)"]
Orchestrator --> FeedStore["๐Ÿ“ก Feed Store"]
Orchestrator --> DecisionLog["๐Ÿ“‹ Decision Log"]
HealthMonitor["โค๏ธ Health Monitor"] -.-> Orchestrator
FeedStore --> Fastify["๐Ÿš€ Fastify API + SSE"]
end

subgraph Dashboard["Next.js 16 Dashboard :3000"]
UI["๐Ÿ“Š Command Center UI"]
end

Fastify -->|"SSE / REST"| UI

style Agent fill:#0f172a,stroke:#06b6d4,stroke-width:2px,color:#f8fafc
style Dashboard fill:#0f172a,stroke:#22c55e,stroke-width:2px,color:#f8fafc
```

## ๐Ÿ† Sponsor Tracks Targeted

### Track A โ€” Payment Volume
- **700+ daily API calls** to Ace Data Cloud (50 sources ร— 14 calls/source/day)
- Uses 5+ distinct Ace services: HTTP Proxy (Residential), HTTP Proxy (Mobile), GPT-4o Chat, DeepSeek-V3, Web Search

### Track B โ€” Best AI Integration
- Multi-model extraction pipeline: GPT-4o primary, DeepSeek-V3 fallback
- Source-specific JSON parsers for known API formats (Upbit, Bithumb, Binance, CoinGecko, etc.)
- HTML sentiment extraction for Korean/Japanese/Chinese content with language-aware patterns

### OOBE / SAP Integration
- Agent registers 3 tools on SAP mainnet: `proxygen-scrape`, `proxygen-analyze`, `proxygen-route`
- Uses `SapClient.builder` fluent API for registration
- Discovery via `DiscoveryRegistry` for self-healing proxy failover
- x402 settlement via `X402Registry` for consumer payment verification

## ๐Ÿš€ Getting Started

### Prerequisites
- Node.js โ‰ฅ 20
- npm โ‰ฅ 10

### Installation

```bash
# Clone
git clone https://github.com/edycutjong/proxygen.git
cd proxygen

# Agent (Terminal 1)
cd agent
cp .env.example .env
npm install
PROXYGEN_DEMO=true npm run dev # Demo mode โ€” no API keys needed

# Dashboard (Terminal 2)
cd dashboard
npm install
npm run dev
# โ†’ Open http://localhost:3000
```

> **For Judges:** The agent runs in demo mode by default โ€” no wallet or API keys required. Real data flows with realistic kimchi premium calculations.

### Verify

```bash
# Agent health
curl http://localhost:3001/health
# โ†’ {"status":"ok","agent":"Proxygen","is_active":true}

# Kimchi premium signal
curl http://localhost:3001/api/signals/kimchi
# โ†’ {"signal":"kimchi_premium","data":{"premium_pct":3.3,"kr_price_usd":64568,"us_price_usd":62505}}

# Full dashboard state
curl http://localhost:3001/api/dashboard
```

## ๐Ÿ’ฐ x402 Economics

```
OUTFLOW (Agent spends per cycle):
โ”œโ”€โ”€ Proxy API: ~0.05 USDC/geo-restricted source
โ”œโ”€โ”€ LLM: ~0.02 USDC/extraction
โ””โ”€โ”€ Daily Total: ~$2-5 USDC

INFLOW (Consumers pay per query):
โ”œโ”€โ”€ Per query: 0.01 USDC
โ””โ”€โ”€ Daily Target: $3-10 USDC โ†’ break-even or profit
```

## ๐Ÿงช Testing & CI

Proxygen includes **103 tests (jest + custom)** across the agent and dashboard workspaces with full coverage on critical paths.

```bash
# โ”€โ”€ Agent โ”€โ”€
cd agent
npm run typecheck # TypeScript strict mode
npm run build # Production build

# โ”€โ”€ Dashboard โ”€โ”€
cd dashboard
npm run lint # Next.js ESLint
npm run typecheck # TypeScript check
npm run build # Production build
npm run ci # Full CI pipeline
```

## โšก Performance Benchmark

Based on `scripts/bench.py` simulating 100 concurrent scrape requests via Ace Data Cloud HTTP Proxy API:

| Metric | Result |
|---|---|
| **p50 Latency** | 117.33ms |
| **p95 Latency** | 175.04ms |
| **p99 Latency** | 189.46ms |
| **Proxy Failover Rate** | 0.0% |
| **LLM Extraction Success** | 100.0% |

## ๐Ÿ“ Project Structure

```
proxygen/
โ”œโ”€โ”€ agent/ # Node.js autonomous agent
โ”‚ โ”œโ”€โ”€ src/
โ”‚ โ”‚ โ”œโ”€โ”€ index.ts # Entry point + Fastify server
โ”‚ โ”‚ โ”œโ”€โ”€ config.ts # Environment + constants
โ”‚ โ”‚ โ”œโ”€โ”€ types.ts # Shared TypeScript interfaces
โ”‚ โ”‚ โ”œโ”€โ”€ sources.ts # 10 curated data sources
โ”‚ โ”‚ โ”œโ”€โ”€ mock.ts # Demo mode data generators
โ”‚ โ”‚ โ”œโ”€โ”€ orchestrator.ts # Core pipeline controller
โ”‚ โ”‚ โ”œโ”€โ”€ ace/
โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ proxy.ts # Ace Data Cloud proxy client
โ”‚ โ”‚ โ”‚ โ””โ”€โ”€ llm.ts # LLM extraction pipeline
โ”‚ โ”‚ โ”œโ”€โ”€ feeds/
โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ store.ts # In-memory feed cache + TTL
โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ log.ts # Decision log + payments
โ”‚ โ”‚ โ”‚ โ””โ”€โ”€ api.ts # REST + SSE endpoints
โ”‚ โ”‚ โ””โ”€โ”€ health/
โ”‚ โ”‚ โ””โ”€โ”€ monitor.ts # Source health + failover
โ”‚ โ”œโ”€โ”€ .env.example # Environment template
โ”‚ โ”œโ”€โ”€ package.json
โ”‚ โ””โ”€โ”€ tsconfig.json
โ”œโ”€โ”€ dashboard/ # Next.js 16 Command Center
โ”‚ โ”œโ”€โ”€ src/
โ”‚ โ”‚ โ”œโ”€โ”€ app/
โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ globals.css # SOC design system
โ”‚ โ”‚ โ”‚ โ”œโ”€โ”€ layout.tsx # Root layout + OG metadata
โ”‚ โ”‚ โ”‚ โ””โ”€โ”€ page.tsx # Dashboard (7 components)
โ”‚ โ”‚ โ””โ”€โ”€ lib/
โ”‚ โ”‚ โ””โ”€โ”€ types.ts # Dashboard types
โ”‚ โ”œโ”€โ”€ public/
โ”‚ โ”‚ โ””โ”€โ”€ icon.svg # Project icon
โ”‚ โ””โ”€โ”€ .env.example
โ”œโ”€โ”€ docs/ # README assets
โ”œโ”€โ”€ .github/
โ”‚ โ”œโ”€โ”€ workflows/
โ”‚ โ”‚ โ”œโ”€โ”€ ci.yml # Dual-workspace CI
โ”‚ โ”‚ โ””โ”€โ”€ codeql.yml # Security analysis
โ”‚ โ””โ”€โ”€ dependabot.yml # Dependency updates
โ”œโ”€โ”€ .gitignore
โ”œโ”€โ”€ LICENSE # MIT
โ””โ”€โ”€ README.md # You are here
```

## ๐Ÿ“„ License

[MIT](LICENSE) ยฉ 2026 Edy Cu

## ๐Ÿ™ Acknowledgments

Built for the **OOBE ร— Ace Data Cloud Autonomous Agent Bounty** on Superteam.

Thank you to:
- [OOBE Protocol](https://oobeprotocol.ai) โ€” Synapse Agent Protocol (SAP) and x402 payment rails
- [Ace Data Cloud](https://acedata.cloud) โ€” Proxy infrastructure and AI APIs
- [Superteam](https://superteam.fun) โ€” For hosting and mentorship