SurgeScout

AI Deal Flow Agent for Internet Capital Markets

SurgeScout is an autonomous AI agent built on OpenClaw that discovers promising projects on Moltbook, analyzes their tokenization potential, and helps launch tokens on the SURGE launchpad.

Think of it as an AI-powered venture scout that operates 24/7 on the agent internet.

How It Works

SurgeScout runs a continuous pipeline:

Scout → Analyze → Advise → Launch → Report
  │         │         │        │        │
  │         │         │        │        └─ Post findings to Moltbook
  │         │         │        └─ Deploy token via SURGE launchpad
  │         │         └─ Generate tokenomics recommendations
  │         └─ LLM-powered scoring (5 dimensions, 0-100)
  └─ Monitor Moltbook submolts for project signals

Scoring Model

Each project is evaluated on 5 dimensions:

Dimension	Weight	What It Measures
Market Fit	25%	Real demand, clear users, market size
Team Signal	20%	Reputation, GitHub activity, past wins
Technical Quality	25%	Working code, deployed contracts, clean architecture
Tokenomics Feasibility	20%	Token utility, revenue model, sustainability
Traction	10%	Moltbook engagement, social proof

Verdicts:

• STRONG_LAUNCH (75+) — Ready for token deployment
• PROMISING (50-74) — Worth watching
• NEEDS_WORK (25-49) — Not ready yet
• SKIP (<25) — No tokenization potential

Features

• Autonomous Scouting — Monitors 5+ Moltbook submolts for project signals
• LLM Analysis — Deep project evaluation via Claude or GPT
• Tokenomics Engine — Generates ticker, supply, bonding curve recommendations
• SURGE Integration — Prepares and deploys tokens on Base/Solana via SURGE
• Moltbook Reporting — Posts analysis reports to m/lablab submolt
• Web Dashboard — Real-time visualization of agent activity
• OpenClaw Skill — Drop-in skill for any OpenClaw agent
• Full Pipeline API — One endpoint runs the complete cycle

Quick Start

# Clone
git clone https://github.com/mthdroid/SurgeScout.git
cd SurgeScout

# Install
pip install -r requirements.txt

# Configure
cp .env.example .env
# Edit .env — add your ANTHROPIC_API_KEY or OPENAI_API_KEY

# Run
python app.py
# Open http://localhost:8899

Install as OpenClaw Skill

# Copy skill to OpenClaw workspace
cp -r skill/ ~/.openclaw/workspace/skills/surgescout/

# Or tell your OpenClaw agent:
# "Install the SurgeScout skill from /path/to/SurgeScout/skill"

API Endpoints

Endpoint	Method	Description
/	GET	Web dashboard
/api/health	GET	Health check
/api/state	GET	Full agent state
/api/scout	POST	Scout Moltbook for projects
/api/analyze	POST	Analyze project(s)
/api/analyses	GET	List all analyses
/api/report/{idx}	GET	View analysis report
/api/launch	POST	Launch token
/api/launches	GET	List all launches
/api/moltbook/post	POST	Post to Moltbook
/api/moltbook/report	POST	Post report to Moltbook
/api/pipeline	POST	Run full pipeline

Architecture

SurgeScout/
├── app.py                      # Entry point (uvicorn server)
├── src/
│   ├── config.py               # Configuration from .env
│   ├── server.py               # FastAPI server + all routes
│   ├── moltbook.py             # Moltbook API client + project extraction
│   ├── analyzer.py             # LLM-powered analysis engine
│   └── launcher.py             # SURGE launchpad + on-chain deployment
├── skill/
│   ├── SKILL.md                # OpenClaw skill definition
│   └── references/
│       ├── surge-integration.md
│       └── scoring-model.md
├── web/
│   └── index.html              # Dashboard UI (Tailwind + Chart.js)
├── data/                       # Persisted agent state
├── requirements.txt
├── .env.example
├── LICENSE
└── README.md

Tech Stack

• Runtime: OpenClaw — self-hosted AI agent
• Backend: Python + FastAPI
• AI: Anthropic Claude / OpenAI GPT (configurable)
• On-chain: SURGE launchpad + Web3.py (Base/Solana)
• Social: Moltbook API (agent posting)
• Frontend: Tailwind CSS, Chart.js, marked.js

Configuration

Variable	Default	Description
AI_PROVIDER	anthropic	LLM provider
ANTHROPIC_API_KEY	-	Claude API key
OPENAI_API_KEY	-	OpenAI API key
MOLTBOOK_API_URL	https://www.moltbook.com	Moltbook API
MOLTBOOK_SUBMOLT	lablab	Default submolt
SURGE_API_URL	https://api.surge.xyz	SURGE API
BASE_RPC_URL	https://sepolia.base.org	Base RPC
WALLET_PRIVATE_KEY	-	Wallet for deployments

SURGE x OpenClaw Hackathon

This project was built for the SURGE x OpenClaw Hackathon on lablab.ai.

• Track: Internet Capital Markets for Creators/Products
• Prize Pool: $50,000 in $SURGE tokens
• Technologies: OpenClaw, SURGE, Moltbook

License

MIT